6228
Comment:
|
5740
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
'''[WARNING: This page is part of the old tutorials, use to the [[Tutorials|new documentation]] instead]'''<<BR>><<BR>> |
|
Line 2: | Line 4: |
You should read this page carefully, in order to understand how the program is organized. If you don't follow a few simple rules reminded at the bottom of the page, Brainstorm will not work properly. | ''Authors: Francois Tadel, Sylvain Baillet'' You should read this page carefully, in order to understand how the program is organized. If you don't follow a few simple rules reminded at the bottom of the page, Brainstorm may not work properly. |
Line 7: | Line 11: |
Brainstorm needs '''different directories''', please try not to put everything at the same place: | Brainstorm needs '''different directories''', please try not to put everything at the same place. |
Line 9: | Line 13: |
* '''Program directory: '''"brainstorm3" * Contains all the program files: Matlab scripts, Java archives, documentation... * No user data in this folder: you can delete it and replace it with a new version, your data will be safe * Recommended location: * '''Windows''': My documents\brainstorm3 * '''Linux''': /home/username/brainstorm3 * '''MacOS''': Documents/brainstorm3 * '''Database directory''': "brainstorm_db" * Created by user. * Contains all the Brainstorm database files. * Managed automatically by the application: do not move, delete or add files by yourself. * Recommended location: * '''Windows''': My documents\brainstorm_db * '''Linux''': /home/username/brainstorm_db * '''MacOS''': Documents/brainstorm_db * '''User directory: '''".brainstorm" * Created automatically at Brainstorm startup. * Contains the database structure and the temporary folders * Typical location: * '''Windows''': C:\Documents and Settings\username\.brainstorm * '''Linux''': /home/username/.brainstorm * Contains: * '''brainstorm.mat''': Matlab matrix where the Brainstorm options and database structure are stored. * '''tmp/''': temporary directory used by some of the Brainstorm functions. Cleaned each time Brainstorm is started<<BR>>You may have to change the location of the temporary folder if you have a limited amount of storage or a limited quota in your home folder. * '''process/''': this is where you should add your dustom processes files (will be reminded later) * '''reports/''': where the process reports are saved * '''openmeeg/''': OpenMEEG binaries will be downloaded automatically to this folder if you compute any BEM headmodel * '''mex/''': some mex files that have to be recompiled, in case you don't have the write access in the Brainstorm folder * '''Original data files''': * Recordings and anatomies you acquired and you want to process with Brainstorm. * Put them wherever you want''' __but not in any of the previous folders__'''. |
'''<<BR>>1. Program directory: '''"brainstorm3" |
Line 41: | Line 15: |
== Brainstorm database (concept) == Brainstorm allows you to classify your recordings and analysis with three different levels of definition: |
* Contains all the program files: Matlab scripts, compiled binaries, templates, etc. * There is no user data in this folder. * You can delete it and replace it with a newer version at anytime, your data will be safe. * Recommended location: * '''Windows''': My documents\brainstorm3 * '''Linux''': /home/username/brainstorm3 * '''MacOS''': Documents/brainstorm3 <<BR>>'''2. Database directory''': "brainstorm_db" * Created by user. * Contains all the Brainstorm database files. * Managed by the application: do not move, delete or add files by yourself. * Recommended location: * '''Windows''': My documents\brainstorm_db * '''Linux''': /home/username/brainstorm_db * '''MacOS''': Documents/brainstorm_db <<BR>>'''3. User directory: '''".brainstorm" * Created at Brainstorm startup. Typical location:<<BR>> * '''Windows''': C:\Documents and Settings\username\.brainstorm * '''Linux''': /home/username/.brainstorm * '''MacOS''': /Users/username/.brainstorm * Contains: * '''brainstorm.mat''': Brainstorm user preferences. * '''tmp/''': Temporary folder, cleaned every time Brainstorm is started.<<BR>>You may have to change the location of the temporary folder if you have a limited amount of storage or a limited quota in your home folder. * '''process/''': Personal plugins folder. * '''reports/''': Process reports. * '''openmeeg/''': OpenMEEG binaries (automatically downloaded when needed) * '''templates/''': Additional anatomy templates, saved as .zip files. * '''mex/''': Some mex files that have to be recompiled. <<BR>>'''4. Original data files''': * Recordings you acquired and you want to process with Brainstorm. * Put them wherever you want''' __but not in any of the previous folders__'''. == Database structure == Brainstorm allows you to organize your recordings and analysis with three levels of definition: |
Line 45: | Line 57: |
* Group of datasets that have to be processed or displayed together. * A protocol can include one or several subjects. |
|
Line 46: | Line 60: |
* It can designate all the data that were acquired on one or several subjects, with the same objectives (study of a specific cognitive task, epileptic spikes localization, functional differences between two populations). * Default data can be defined at the protocol level. If you cannot get the individual MR images of all or some of your subjects, you can use a default anatomy. * If you want to localize the sources for an EEG recording but do not know the location of each electrode in space, you can use standardized electrodes positions. |
* You can only open one protocol at a time. |
Line 51: | Line 63: |
* You need two categories of information to define a subject: * Files describing the subject's anatomy : MRI and surfaces * Functional data files, ie. files that have a temporal dimension or that are related to a precise recording session: EEG / MEG recordings, definition of the sensors, source estimations, statistical results... * '''Condition''' * For each subject, functional files can be classified in different ''experimental conditions''. * This level of definition is also used to separate different ''runs ''(ie. recording sessions) for the same subject. |
* A subject contains two categories of information: anatomy and functional data. * Anatomy: Includes at least an MRI volume and some surfaces extracted from the MRI. * Functional data: Everything that is related with the MEG/EEG acquisition. * For each subject, it is possible to use either the actual MRI of the person or one of the anatomy templates available in Brainstorm. * '''Sub-folders ''' * For each subject, the functional files can be organized in different sub-folders. * These folders can represent different recordings sessions (aka acquisition runs) or different experimental conditions. * The current structure of the database does not allow to have more that one level of sub-folders for each subject. It is not possible to organize the files by session AND by condition.<<BR>><<BR>> {{attachment:db.gif}} |
Line 58: | Line 72: |
== Brainstorm database (files) == * Brainstorm_db folder is created and managed completely from the Brainstorm graphic user interface (GUI) * All the files in the database have to be imported through the GUI: (right-click > Import...) * Imported files are stored in Matlab format (.mat files) at the appropriate place in the database folder. * Do not try to copy files by yourself in the brainstorm_db folder, it won't work * Based on the files/directories architecture: |
== Database files == * The database folder "brainstorm_db" is managed completely from the graphic user interface (GUI). * All the files in the database have to be imported through the GUI. Do not try to copy files by yourself in the brainstorm_db folder, it won't work. * Everything in this folder is stored in Matlab .mat format, with the following architecture: |
Line 65: | Line 77: |
* '''Functional data''': brainstorm_db/protocol_name/'''data'''/subject_name/condition_name/ * Each file you see in the Brainstorm window corresponds to a proper file on the hard drive * But the contrary is not necessarily true. * There are extra information stored in each directory, to save properties, comments, default data, links between different items, etc. * For this reason, you should not try to manipulate directly the files in the Brainstorm database directory. * Database structure in memory: * A copy of the database structure is saved by Brainstorm in your home directory in '''.brainstorm/brainstorm.mat ''' * So when you start the program or change protocol, there is no need to read again all the files on the hard drive (this may take some time). |
* '''Functional data''': brainstorm_db/protocol_name/'''data'''/subject_name/subfolder/ * Most of the files you see in the database explorer in Brainstorm correspond to files on the hard drive, but there is no one-to-one correspondence. There is extra information stored in each directory, to save properties, comments, default data, links between different items, etc. For this reason, you should not try to manipulate directly the files in the Brainstorm database directory. * The structure of the database is saved in the user preferences, so when you start the program or change protocol, there is no need to read again all the files on the hard drive (which may take some time). * If Brainstorm or Matlab crashes before the database structure is correctly saved, the files that are displayed in the Brainstorm database explorer may differ from what is actually on the disk. When this happens, you can force Brainstorm to rebuild the structure from the files on the hard drive: right-click on the folder to udpate > Reload. |
Line 74: | Line 82: |
* As a consequence, the files that are displayed in the Brainstorm window may differ from what is actually on the disk. * It may happen when some process crashes, or if you move or add some files by yourself in the database folder. |
== Summary == * Different folders for: * the '''program '''(brainstorm3), * the '''database '''(brainstorm_db), * your '''original recordings'''. * Never modify the contents of the database folder by yourself * Do not put the original recordings in any of the Brainstorm folders, import them with the interface |
Line 77: | Line 90: |
* If this happens, you will have to reload the current protocol (right-click popup menu > ''Reload'') or the whole database (menu ''File > Reload database'') | <<EmbedContent("http://neuroimage.usc.edu/bst/get_prevnext.php?prev=Tutorials&next=Tutorials/TutFirstSteps")>> |
Line 79: | Line 92: |
== To remember == * __Different folders__ for: * the '''program '''(brainstorm3), * the '''database '''(brainstorm_db), and * your '''original files'''. * Never modify the contents of the database folder by yourself * Do not put the original recordings in any of the Brainstorm folders, import them with the graphic interface<<BR>> == Feedback == <<EmbedContent(http://neuroimage.usc.edu/brainstorm3_register/get_feedback.php?Tutorials/BstFolders)>> == Next == It is finally time to start Brainstorm. [[Tutorials/TutFirstSteps|Next tutorial]]. |
<<EmbedContent(http://neuroimage.usc.edu/bst/get_feedback.php?Tutorials/BstFolders)>> |
[WARNING: This page is part of the old tutorials, use to the new documentation instead]
Tutorial 1: Brainstorm architecture
Authors: Francois Tadel, Sylvain Baillet
You should read this page carefully, in order to understand how the program is organized. If you don't follow a few simple rules reminded at the bottom of the page, Brainstorm may not work properly.
Brainstorm folders
Brainstorm needs different directories, please try not to put everything at the same place.
1. Program directory: "brainstorm3"
- Contains all the program files: Matlab scripts, compiled binaries, templates, etc.
- There is no user data in this folder.
- You can delete it and replace it with a newer version at anytime, your data will be safe.
- Recommended location:
Windows: My documents\brainstorm3
Linux: /home/username/brainstorm3
MacOS: Documents/brainstorm3
2. Database directory: "brainstorm_db"
- Created by user.
- Contains all the Brainstorm database files.
- Managed by the application: do not move, delete or add files by yourself.
- Recommended location:
Windows: My documents\brainstorm_db
Linux: /home/username/brainstorm_db
MacOS: Documents/brainstorm_db
3. User directory: ".brainstorm"
Created at Brainstorm startup. Typical location:
Windows: C:\Documents and Settings\username\.brainstorm
Linux: /home/username/.brainstorm
MacOS: /Users/username/.brainstorm
- Contains:
brainstorm.mat: Brainstorm user preferences.
tmp/: Temporary folder, cleaned every time Brainstorm is started.
You may have to change the location of the temporary folder if you have a limited amount of storage or a limited quota in your home folder.process/: Personal plugins folder.
reports/: Process reports.
openmeeg/: OpenMEEG binaries (automatically downloaded when needed)
templates/: Additional anatomy templates, saved as .zip files.
mex/: Some mex files that have to be recompiled.
4. Original data files:
- Recordings you acquired and you want to process with Brainstorm.
Put them wherever you want but not in any of the previous folders.
Database structure
Brainstorm allows you to organize your recordings and analysis with three levels of definition:
Protocol
- Group of datasets that have to be processed or displayed together.
- A protocol can include one or several subjects.
Some people would prefer to call this experiment or study.
- You can only open one protocol at a time.
Subject
- A person who participated in a given protocol.
- A subject contains two categories of information: anatomy and functional data.
- Anatomy: Includes at least an MRI volume and some surfaces extracted from the MRI.
- Functional data: Everything that is related with the MEG/EEG acquisition.
- For each subject, it is possible to use either the actual MRI of the person or one of the anatomy templates available in Brainstorm.
Sub-folders
- For each subject, the functional files can be organized in different sub-folders.
- These folders can represent different recordings sessions (aka acquisition runs) or different experimental conditions.
The current structure of the database does not allow to have more that one level of sub-folders for each subject. It is not possible to organize the files by session AND by condition.
Database files
- The database folder "brainstorm_db" is managed completely from the graphic user interface (GUI).
- All the files in the database have to be imported through the GUI. Do not try to copy files by yourself in the brainstorm_db folder, it won't work.
- Everything in this folder is stored in Matlab .mat format, with the following architecture:
Anatomy data: brainstorm_db/protocol_name/anat/subject_name
Functional data: brainstorm_db/protocol_name/data/subject_name/subfolder/
- Most of the files you see in the database explorer in Brainstorm correspond to files on the hard drive, but there is no one-to-one correspondence. There is extra information stored in each directory, to save properties, comments, default data, links between different items, etc. For this reason, you should not try to manipulate directly the files in the Brainstorm database directory.
- The structure of the database is saved in the user preferences, so when you start the program or change protocol, there is no need to read again all the files on the hard drive (which may take some time).
If Brainstorm or Matlab crashes before the database structure is correctly saved, the files that are displayed in the Brainstorm database explorer may differ from what is actually on the disk. When this happens, you can force Brainstorm to rebuild the structure from the files on the hard drive: right-click on the folder to udpate > Reload.
Summary
- Different folders for:
the program (brainstorm3),
the database (brainstorm_db),
your original recordings.
- Never modify the contents of the database folder by yourself
- Do not put the original recordings in any of the Brainstorm folders, import them with the interface