saveFeaturesGui.m

function saveFeaturesGui(saveFile)
% estimate spectral features
%
% In previous versions, there was an additional input parameter called
% "options." In this version a GUI pops up and asks for these options from
% the user.
%
% INPUTS
% saveFile: name of '.mat' file containing the data and labels
%   variables. And to which the processed data will be saved
%
% LOADED VARIABLES
% labels: Structure containing labeling infomation for data
%   FIELDS USED
%   fsRaw: sampling frequency of unprocessed data (Hz)
%   area: cell array of labels for each area corresponding to
%       the second dimension of xFft
%   fs: sampling frequency of processed data (Hz)
%   windows: same as allWindows, but with unusable windows eliminated
%   X: Preprocessed (filtered, averaged, checked for saturation) data. NxAxW array. A is
%       the # of areas. N=number of frequency points per
%       window. W=number of time windows.
%   windowLength: length of windows (s)
% dataSegments (optional): output data from preprocessing through
%   dataSegments method.
%
% SAVED VARIABLES
% power: MxNxP matrix of power values where M is frequency, N is brain area,
%     and P is time window
% coherence: MxNxPxQ array to store coherence variables where M is frequency,
%     N is time window, and P and Q are the two brain areas where coherence is
%     calculated
% granger: PxFxW array to store granger causality values. P
%     iterates over directed pairs of regions, F iterates over
%     frequencies, W iterates over windows.
% instant: PxFxW array to store instantaneous causality values. P
%     iterates over undirected pairs of regions, F iterates over
%     frequencies, W iterates over windows.
% causality: PxFxW array to store linear directionality features.P
%     iterates over directed pairs of regions, F iterates over
%     frequencies, W iterates over windows.
% labels: See above, with
%   ADDED FIELDS
%   f: integer frequency of processed data
%   powerFeatures: MxN matrix of string labels describing the
%       features represented in labels.power. M is frequency, N is
%       brain area.
%   cohFeatures: MxPxQ array of string labels describing the
%       features represented in labels.coherence. M is frequency, P
%       and Q are the two brain areas where coherence is calculated.
%   gcFeatures: PxF array of string labels describing the
%       features represented in labels.granger. P iterates over
%       directed pairs of regions, F iterates over frequencies.
%   instFeatures: PxF array of string labels describing the
%       features represented in instArray. P iterates over
%       undirected pairs of regions, F iterates over frequencies.

%% Get options from GUI
fprintf('Make sure you are using matlab version R2019a or later')
myGui = gui();
while isvalid(myGui)
    options = myGui.getOptions();
    pause(0.001);
end 
if isvalid(myGui)
   % one last check on the off chance that someone clicked an option and closed the app 
   % in 1ms
   options = myGui.getOptions();
end

saveFeatures(saveFile, options)

end