= Tutorial 2: Importing individual anatomy = Objectives: Import anatomy for CTF MEG tutorial. <> == Create protocol == 1. Create a new protocol called ''TutorialCTF ''with the following options: * "No, use individual anatomy", because the individual subject anatomy is available * "No, use one channel file per condition (MEG)", because we are going to process regular MEG data in the next tutorial 1. Create a new subject (let's keep the default name: ''Subject01'') == Import MRI == 1. Go to the ''Anatomy ''view of the protocol files (very first button in Brainstorm window toolbar). 1. Right click on subject node, and select menu "''Import MRI...''"<
><
> {{attachment:menuImportMri.gif}} 1. Select file "''TutorialCtf/Anatomy/01.mri''".<
>If you didn't download the CTF tutorial data yet, go back to the [[Tutorials|Tutorials page]]. 1. If you didn't modified any Brainstorm option yet, you should get an error message, saying "Unrecognized format, try switching byte order". This is because not all the computers process the binary data the same way. To learn more about endianness, you can consult [[http://en.wikipedia.org/wiki/Endianness|this Wikipedia page]]. Depending on the type of computer which wrote the binary files, you may need to read them as ''little-endian'' or ''big-endian''.<
><
>To change this setting, go to the ''File > Set preferences...'' menu in main window, and check "Big endian". You may need to modify this setting again to import other files.<
><
> {{attachment:menuByteOrder.gif}} 1. Try to import the MRI again. It should be working now. The MRI viewer is displayed, together with a message box that tells you what to do. Follow the instructions. The MRI is already well oriented so you can directly process with the fiducials selection. You will see that three fiducials were already identified in the MRI file (NAS, LPA, RPA); you just need to add the three other ones (AC, PC, IH). <
>For instructions to find the fiducials, follow this link: CoordinateSystems. == Import surfaces == The MRI is available in the anatomy folder for ''Subject01''. Let's now proceed with the surfaces. The envelopes we are going to import in this tutorial were extracted using BrainVISA software, and their names and types may differ from other software solutions. To learn how to get those surfaces by yourself: read the tutorials for [[Tutorials/SegBrainVisa|BrainVISA]], [[Tutorials/SegBrainSuite|BrainSuite]], and [[Tutorials/SegFreeSurfer|FreeSurfer]]. 1. Right click on the subject node again, and click on "''Import surfaces...''". Select '''at the same time''' (holding ''Shift ''or ''Ctrl ''key) all the files in the directory "''TutorialCtf/Anatomy/BrainVISA''" (head, Lhemi, Rhemi). Click on "Open" and answer ''Yes ''to the question: "Align surfaces with MRI now?". * Note: The coordinate system used to localize in 3D the vertices of each surface depends on the software that created them. When importing the surfaces, Brainstorm registers them with the MRI using its fiducials points (NAS, LPA, RPA). This simple algorithm needs the head (ie. scalp) surface, so if you try to import only the cortical surface, it will not be well registered with the MRI, and all the following computations will fail. 1. You should see the three surfaces in the database tree. <
><
> {{attachment:treeSurfaces.gif}} * One has been identified automatically as a ''scalp'' (=''head'') surface, because its original filename contained the "''scalp''" keyword. Usually, Brainstorm identifies file types with this kind of tags in the file names. * The two other files were not identified automatically. They contain the envelopes of left and right hemispheres of the brain, but ''Lhemi ''and ''Rhemi ''are not keywords that are identified automatically by Brainstorm. * Try to display the surfaces by double-clicking on them, or with the popup menu ''Display''. == Downsample and merge surfaces == In the ''Surfaces ''tab, you can see the numbers of faces and vertices for each surface, and also display their faces (wireframe) with the ''Edges ''button. They look great, but their resolution is too high for the algorithms we will apply on them later, they need to be downsampled. 1. Downsample: * Right-click on the ''head ''surface > Less vertices...: enter 7000, and press ''Ok''. * Right-click on the ''Lhemi ''surface > Less vertices...: enter 7500, and press ''Ok''. * Right-click on the ''Rhemi ''surface > Less vertices...: enter 7500, and press ''Ok''. * Three new surfaces appeared in the list, with the number of vertices as a suffix. 1. Group left and right hemisphere to build a ''Cortex ''surface: * Select ''Lhemi_7500V ''and ''Rhem''i_7500V'' ''files at once (hold Ctrl key and left-click on both) * Right-click > Merge surfaces * A file called ''New surface'' appeared at the end of the list, rename it in ''Cortex ''(F2 key, or click twice on it but waiting between the two clicks, or ''right-click > Rename''). Its icon should change automatically: the surface has been classified automatically as a ''Cortex ''(keyword that was recognized). * If you prefer calling it in an other way, you would have to specify manually that is a cortex envelope: ''right-click > Set surface type > Cortex'' * Double-click on it to display it (or right-click > Display), and check in the ''Surfaces ''tab that the number of vertices is about 15000. 1. Multiple surfaces of the same type: * Here you are in configuration where you have two surfaces that are classified as ''head''. * The one which is displayed in green is considered as the default one. It would be used automatically by all the functions that would need the head surface for this subject. * Double-click on the other head surface to select it, it should turn green. * However, this is not the recommanded way to proceed, it might be confusing. To make things clear: always set as "''Other''" the surfaces you are not going to use in the source estimation process. 1. A bit of cleaning: * Rename the ''01_head_SCS_7000V'' in ''Head''. * Delete all the surfaces but the ''Head ''and ''Cortex ''(''Delete ''key, or right-click>Delete). * Before: {{attachment:treeBeforeCleaning.gif}} After: {{attachment:treeAfterCleaning.gif}} === Bug warning === __Description__: On some operating systems, it may happen that the tree is not refreshed well. Just after adding new files, the database tree can be displayed incompletely or can event appear completely empty. This bug occurs sometimes because the interactions between Matlab and Java are not always well synchronized. __Workaround__: If this happens, just refresh the tree display with by either pressing the F5 key, or by click on the menu ''File > Refresh tree display''. We'll try to fix this bug some day. == Check registration with MRI == Your Subject01 anatomy is ready for source estimation. But before going further, you should '''always '''check that surfaces and MRI are well registered. When performing those steps a bit too fast, it is really easy to end with a cortex envelope that is not aligned with the MRI. None of the following steps in source estimation will check that for you, and the sources estimated would be completely wrong. * Right-click on the ''Cortex ''surface ''> MRI Registration > Check MRI/surface registration''...<
><
> {{attachment:checkMriRegistration.gif}} * The yellow lines represent the re-interpolation of the surface in the MRI volume. The computation may take a while, but the result will be stored in the surface file, and will be useful for other operations anyway. == Fix registration with MRI == In some rare cases, the surfaces may not be registered correctly with the MRI. * If this happens, delete your MRI and surfaces and start again from scratch, it may be some manipulation process. * If the result is not better and you don't know what happens, it is likely that the coordinate system used in your surface file is not handled by Brainstorm. There are still two emergency options: pointing the fiducials on the head surface, and editing manually the surfaces. Both give really unprecise results, but might help if nothing else is possible... * You would not need to use this with this tutorial data, as the surfaces are already well registered with the MRI. But go through the following steps anyway, so that you know what to do in case this happens. === Defining the fiducials on head surface === * Of course it is possible only if you have the head surface. * Right-click on ''Cortex > MRI Registration > Advanced > Align all surfaces (with MRI fiducials)...'' * You will be asked to point on the scalp surface the same fiducials as in the MRI (NAS, LPA, RPA). Click on a button in the toolbar (NAS, LPA or LPA), and point it on the surface. Repeat this operation for each fiducial. <
><
> {{attachment:fixMriRegistrationHead.gif}} ''' ''' * Do not click on OK. Normally you would click on OK button in toolbar, and it would realign all the subject's surfaces. However, here we don't want to alter our perfect subject, so just close the "Align surfaces" window, and the modifications will be ignored.''' ''' === Manual alignment === * The goal is to realign graphically and interactively one surface on another. * Right-click on ''Cortex > MRI Registration > Advanced > Align manually on... > Head'' * The orange surface is the one you are modifying, the grey one is the target. Move your mouse over the buttons in the toolbar to see what they do, select one you like, and then right-click + move up/downBR>><
> {{attachment:fixMriRegistrationManual.gif}} * '''Do not click on OK'''. Close the window, and answer ''No'' to the question "Would you like to save the changed ?" * Check one last time that we didn't modify anything: Right-click on ''Cortex > Check alignment with MRI...'' == What happened on the hard drive == For most manipulations, it is not necessary to know exactly what is going on at the level of the real files, in Brainstorm database directory. But many things are not accessible from the Brainstorm interface, and you may find useful to manipulate some piece of data directly from the Matlab command window. The '''right-click > File menu''', accessible on all the nodes in Brainstorm database explorer, offers many tools to interact with the file system and the Matlab environment. === Where are the files ? === Several ways to reach a file: * Leave your mouse during a few seconds over any node in the database explorer, and a tooltip will appear, with the name and path of the corresponding file on hard drive. <
><
> {{attachment:treeToolTip.gif}} * Note: Paths are relative to current protocol path (''brainstorm_database/TutorialCTF''). What is displayed in Brainstorm window is a comment and may have nothing to do with the real file name. Eg. the ''Scalp ''surface's real file name is ''tess_cortex_concat.mat''. * Right-click > ''File'': many menus can lead you to the files:<
><
> {{attachment:treeFileMenu.gif}} * ''View .mat file'': display file contents, but also its location at the top * ''Go to this directory (Matlab)'': changes Matlab path, so that you can access the file from the Matlab ''Command window'' or the Matlab ''Current directory'' window * ''Localize on disk'': Open an explorer window in this directory (Micorsoft Windows only) * ''X-term in this directory'': Open a terminal window in this directory (Linux, Unix, MacOS only) === What is inside ? === Almost all the files in Brainstorm database (imported data or computation results) are in Matlab .mat format. As a consequence, you can load them really easily in the Matlab environment, where they appear as structures with several fields. * '''Right-click > File > View .mat file''' : Display all the fields available in the file<
><
> {{attachment:fileViewMat.gif}} * '''Right-click > File > Export to Matlab''': read the contents of the file, and export it to a variable in main Matlab workspace. Example with ''Cortex ''surface exported as "''surf''": output of Matlab command window.<
> {{{ Data exported as "surf" >> surf surf = Vertices: {[3x15010 double]} Faces: {[29944x3 double]} Comment: {'Cortex'} VertConn: {[15010x15010 logical]} Curvature: {[15010x1 single]} tess2mri_interp: [16777216x15010 double] >> }}} * '''Right-click > File > Import from Matlab''': You can modify any field in this variable and then import it back in Brainstorm with this menu === What are all those other files ? === * If you look in your ''brainstorm_database/TutorialCTF ''directory, you'll find many other directories and files that are apparently not displayed in Braistorm database explorer.<
><
><
> {{attachment:protocolFolders.gif}} * The protocol TutorialCTF is divided in ''Anatomy ''and ''Datasets ''directories: * Each subject in ''anat ''is described by an extra file: ''brainstormsubject.mat'' * Each condition in ''data ''is described by an extra a file: ''brainstormstudy.mat'' * anat/@default_subject contains the files that are displayed in the ''(Default anatomy)'' node in database explorer * data/@default_study: used when files are shared between different subjects, node ''(Global common files)'' * data/@inter : results of inter-subject analysis * data/Subject01/@default_study: used when files are shared between different conditions in Subject01; node ''(Common files)'' * data/Subject01/@intra: results of intra-subject analysis (across different conditions) == Next == The anatomy of our subject is ready for source estimation, the next tutorial will explain [[Tutorials/TutImportRecordings|how to import recordings]].