POP_STUDY Create a new STUDY set structure defining a group of related EEG datasets. The STUDY set also contains information about each of the datasets: the subject code, subject group, experimental condition, and session. This can be provided interactively in a pop-up window or be automatically filled in by the function. Defaults: Assume a different subject for each dataset and only one condition; leave subject group and session fields empty. Additional STUDY information about the STUDY name, task and miscellaneous notes can also be saved in the STUDY structure.

Usage: >> [ STUDY ALLEEG ] = pop_study([],[], 'gui', 'on'); % create new study interactively
>> [ STUDY ALLEEG ] = pop_study(STUDY, ALLEEG, 'gui', 'on'); % edit study interactively
>> [ STUDY ALLEEG ] = pop_study(STUDY, ALLEEG, 'key', 'val', ...); % edit study

Optional Inputs:
STUDY   
existing study structure.
ALLEEG   
vector of EEG dataset structures to be included in the STUDY.

Optional Inputs: All "'key', 'val'" inputs of std_editset() may be used.

Outputs:
STUDY   
new STUDY set comprising some or all of the datasets in ALLEEG, plus other information about the experiments.
ALLEEG   
an updated ALLEEG structure including the STUDY datasets.

Graphic interface buttons:
"STUDY set name"   
[edit box] name for the STUDY structure {default: ''}
"STUDY set task name"   
[edit box] name for the task performed by the subject {default: ''}
"STUDY set notes"   
[edit box] notes about the experiment, the datasets, the STUDY, or anything else to store with the rest of the STUDY information {default: ''}
"subject"   
[edit box] subject code associated with the dataset. If no subject code is provided, each dataset will assumed to be from a different subject {default: 'S1', 'S2', ..., 'Sn'}
"session"   
[edit box] dataset session. If no session information is provided, all datasets that belong to one subject are assumed to have been recorded within one session {default: []}
"condition"   
[edit box] dataset condition. If no condition code is provided, all datasets are assumed to be from the same condition {default:[]}
"group"   
[edit box] the subject group the dataset belongs to. If no group is provided, all subjects and datasets are assumed to belong to the same group. {default: []}
"Save this STUDY set to disk file"   
[check box] If checked, save the new STUDY set structure to disk. If no filename is provided, a window will pop up to ask for it. See also pop_loadstudy, pop_preclust, pop_clust

Authors: Arnaud Delorme, Hilit Serby, Scott Makeig, SCCN, INC, UCSD, July 22, 2005

See the matlab file pop_study.m (may require other functions)

Back to functions