13846
Comment:
|
13377
|
Deletions are marked like this. | Additions are marked like this. |
Line 81: | Line 81: |
* '''Smooth''': Inflates the cortical surface to make all the parts of the cortex envelopes visible. | * '''Smooth''': Inflates the cortical surface to make all the parts of the cortex envelopes visible. <<BR>>This is just a display option, it does not actually modify the surface. |
Line 83: | Line 83: |
* '''Sulci''': Shows the bottom of the cortical folds with a darker color. We recommend to keep this option selected for the cortex, it helps for the interpretation of source locations on brains that are heavily smoothed. | * '''Sulci''': Shows the bottom of the cortical folds with a darker color. We recommend to keep this option selected for the cortex, it helps for the interpretation of source locations on smoothed brains. |
Line 86: | Line 86: |
* At the bottom of the Surface tab, you can read the number of vertices and faces in the tesselation.<<BR>><<BR>> {{attachment:surface_options.gif||height="211",width="321"}} {{attachment:surface_mesh.gif}} | * At the bottom of the Surface tab, you can read the number of vertices and faces in the tesselation.<<BR>><<BR>> {{attachment:surface_options.gif||height="210",width="320"}} {{attachment:surface_mesh.gif||height="210",width="286"}} |
Line 88: | Line 88: |
== Coordinates tab == | == Get coordinates == |
Line 90: | Line 90: |
* Right-click on the 3D figure, select "Get coordinates". A new window appears. * Click anywhere on the cortex surface: a big yellow cross appears, and the coordinates of the point are displayed in all the available coordinates systems (see page: CoordinateSystems) * MRI: MR volume, in millimeters (multiplied with the Voxsize field in the MRI file). * SCS: Subject Coordinates System, in millimeters * MNI: Montreal Neurological Institute standard coordinates * You can click on "View / MRI" to see where this point is located in the MRI, using the MRI Viewer. <<BR>><<BR>> {{attachment:panelCoord.gif}} {{attachment:panelCoordPt.gif}} |
* Right-click on the 3D figure, select "Get coordinates". * Click anywhere on the cortex surface: a yellow cross appears and the coordinates of the point are displayed in all the available coordinates systems. * You can click on [View/MRI] to see where this point is located in the MRI, using the MRI Viewer. <<BR>><<BR>> {{attachment:surface_coordinates.gif||height="152",width="365"}} |
Line 97: | Line 94: |
== 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 up 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. |
== Registration MRI/surfaces == The MRI and the surfaces are represented using the different coordinate systems and could be misregistered for various reasons. If you are using the automated segmentation pipeline from FreeSurfer or BrainSuite you should never have any problem, but if something goes wrong or in the case of more manual import procedures it is always good to check that the MRI and the surfaces are correctly aligned. |
Line 100: | Line 97: |
* Right-click on the ''Cortex ''surface ''> MRI Registration > Check MRI/surface registration''... . {{http://neuroimage.usc.edu/brainstorm/Tutorials/TutImportAnatomy?action=AttachFile&do=get&target=checkMriRegistration.gif|checkMriRegistration.gif|height="265px",width="332px",class="attachment"}} * The calculation of the interpolation MRI-surface takes a few seconds, but it is then saved in the database and will be reused later. * 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. |
* Right-click on the low-res cortex > MRI Registration > Check MRI/surface registration * The calculation of the interpolation between the MRI and the cortex surface takes a few seconds, but the result is then saved in the database and will be reused later. * The yellow lines represent the re-interpolation of the surface in the MRI volume. {{attachment:surface_register.gif}} |
Tutorial 3: Display the anatomy
Authors: Francois Tadel, Elizabeth Bock, Sylvain Baillet
Contents
Anatomy folder
The anatomy of the subject "Subject01" should now contain all the files that Brainstorm could import from the FreeSurfer segmentation results:
MRI: T1-weighted MRI, resampled and re-aligned by FreeSurfer.
Head mask: Head surface, generated by Brainstorm.
If this doesn't look good for your subject, you can recalculate another head surface using different parameters: right-click on the subject folder > Generate head surface.Cortex_330142V: High-resolution pial envelope generated by FreeSurfer.
Cortex_15002V: Low-resolution pial envelope, downsampled from the original one by Brainstorm.
White_*: White matter envelope, high and low resolution.
Mid_*: Surface that represents the mid-point between the white and cortex envelopes.
Aseg atlas: Surfaces representing various sub-cortical regions identified by FreeSurfer.
For more information about the files generated by FreeSurfer, read the FreeSurfer page.
Default surfaces
- There are four possible surface types: cortex, inner skull, outer skull, head.
- For each type of surface, one file is selected as the one to use by default for all the operations.
This selected surface is displayed in green.
- Here, there is only one "head" surface, which is selected.
All the mid, cortex and white surfaces can all be used as "cortex" surfaces, only one can be selected at a time. By default, the low-resolution cortex should be selected and displayed in green.
To select a different cortex surface, you can double-click on it or right-click > Set as default.
MRI Viewer
Right-click on the MRI to get the list of the available display menus:
Select the MRI Viewer. This interface was already introduced in the previous tutorial. It corresponds to the default display menu if you double-click on the MRI from the database explorer. Let's describe a few more options:
MIP Anatomy: Maximum Intensity Projection. When this option is selected, the MRI viewer shows the maximum intensity value across all the slices in each direction. This maximum does not depend on the selected slice, therefore if you move the cursor, the image stays the same.
Neurological/Radiological: Two standard ways displaying scans. In the neurological orientation, the left hemisphere is on the left of the image while in the radiological orientation the left hemisphere is on the right on the image.
Coordinates: Position of the cursor in different coordinate systems, as described on this page: CoordinateSystems. The MNI coordinates are only available for the MRI volumes that have been transformed to the MNI stereotaxic space (for example the Colin27 and ICBM152 templates).
Colormap: Click on the colorbar and move up/down (brightness) or left/right (contrast)
Popup menu: All the figures have additional options available in a popup menu, accessible with a right-click on the figure. The colormap options will be described later in the tutorials, you can test the other options by yourself.
MRI contact sheets
You can get collections of slices in any direction axial/coronal/sagittal with menus in the popup menu in the database explorer or from the popup menu in the MRI Viewer figure.
Zoom: mouse wheel (or two finger-move on a MacBook pad)
Move in zoomed image: click + move
Adjust contrast: right click + move up/down
MRI in 3D figures
Right-click on the MRI file in the database explorer > Display > 3D orthogonal slices.
Simple mouse operations:
Rotate: Click + move.
Zoom: Mouse wheel, or two finger-move on a MacBook pad.
Move: Left+right click + move (or middle-click + move).
Colormap: Click on the colorbar and move up/down (brightness) or left/right (contrast).
Reset view: Double click anywhere on the figure.
Reset colormap: Double-click on the colorbar.
Move slices: Right click + move along the MRI slice axis.
(or use the Resect panel in the Surface tab)
- Popup operations (right-click on the figure):
Colormap: Edit the colormap, detailed in another tutorial.
MRI Display: For now, contains only the MIP option (Maximum Intensity Projection).
Get coordinates: Pick a point in any 3D view and get its coordinates.
Snapshots: Save images or movies from this figure.
Figure: Change some of the figure options or edit it using the Matlab tools.
Views: Set one of the predefined orientation.
- Note the indications in the right part of the popup menu, they represent the keyboard shortcut for each menu.
Keyboard shortcuts:
Views shortcuts (0,1,2...9 and [=]): Remember them, they will be very useful when exploring the cortical sources. To switch from left to right, it is much faster to press a key than having to rotate the brain with the mouse.
Zoom: Keys [+] and [-] for zooming in and out.
- Surfaces tab:
- This panel is primarily dedicated to the display of the surfaces, but some controls can also be useful for the 3D MRI view.
Transparency: This slider lets you change the transparency of the slices.
Smooth: This slider changes the background threshold applied to the MRI slices. If you set it zero, you will see the full slices, as extracted from the volume.
Resect: You can change the position of the slices with the three sliders.
Surfaces
To display a surface you can either double-click on it or right-click > Display.
- The mouse and keyboard operations described for the 3D MRI view also apply here.
- The surface tab has more options available now. Open the cortex surface and try them all.
Smooth: Inflates the cortical surface to make all the parts of the cortex envelopes visible.
This is just a display option, it does not actually modify the surface.Color: Changes the color of the surface.
Sulci: Shows the bottom of the cortical folds with a darker color. We recommend to keep this option selected for the cortex, it helps for the interpretation of source locations on smoothed brains.
Edge: Display the faces of the surface tesselation.
Multiple surfaces: If you open two surfaces from the same subject, they will be displayed on the same figure. Then you need to select the surface you want to edit before changing its properties. The list of the available surfaces is displayed at the top of the Surface tab.
At the bottom of the Surface tab, you can read the number of vertices and faces in the tesselation.
Get coordinates
- Close all the figures. Open the cortex surface again.
- Right-click on the 3D figure, select "Get coordinates".
- Click anywhere on the cortex surface: a yellow cross appears and the coordinates of the point are displayed in all the available coordinates systems.
You can click on [View/MRI] to see where this point is located in the MRI, using the MRI Viewer.
Registration MRI/surfaces
The MRI and the surfaces are represented using the different coordinate systems and could be misregistered for various reasons. If you are using the automated segmentation pipeline from FreeSurfer or BrainSuite you should never have any problem, but if something goes wrong or in the case of more manual import procedures it is always good to check that the MRI and the surfaces are correctly aligned.
Right-click on the low-res cortex > MRI Registration > Check MRI/surface registration
- The calculation of the interpolation between the MRI and the cortex surface takes a few seconds, but the result is then saved in the database and will be reused later.
- The yellow lines represent the re-interpolation of the surface in the MRI volume.
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 file system, in the Brainstorm database directory. However, many things are not accessible from the Brainstorm interface, you may find sometimes 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 the hard drive.
Paths are relative to current protocol path (brainstorm_db/TutorialCTF). What is displayed in the Brainstorm window is a comment and may have nothing to do with the real file name. Eg. the Cortex surface's real file name is tess_cortex_pial.mat.
- Almost all the files in the 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.
Popup menu: File
Right-click on a surface file: many menus can lead you to the files and their contents:
View file contents: Display all the fields in the corresponding Matlab .mat file and the file path
View file history: Review the History field in the file, that records all the operations that were performed on the file since if was imported in Brainstorm
Export to file: Export in one of the supported mesh file format
Export to Matlab: Load the contents of the .mat file in the Matlab base workspace. It is then accessible from the Matlab command window.
Import from Matlab: Replace the selected file with the content of a variable from the Matlab base workspace. Useful to save back in the database some structures that where exported and modified manually with the Matlab command window.
Copy / Cut / Paste: Allow you to copy/move files in the database explorer. Keyboard shortcuts for those menus are the standard Windows shortcuts (Ctrl+C, Ctrl+X, Ctrl+V). The tree also support drag-and-drop operations for moving files between different folders.
Delete: Delete a file. Keyboard shortcuts: Delete key.
Rename: Change the Comment field in the file ("renames" the file in the database explorer, but does not rename the actual file on the hard drive). Keyboard shortcut: F2
Copy file path to clipboard: Copies the full file name into the system clipboard, so that you can paste it in any other window (Ctrl+V or Paste menu)
Go to this directory (Matlab): Change the current Matlab path, so that you can access the file from the Matlab Command window or the Matlab Current directory window
Show in file explorer: Open an explorer window in this directory (not working on all the systems...)
Open terminal in this folder: Start a system console in the file directory (Linux, Unix, MacOS only)
What are all those other files ?
If you look in your brainstorm_db/TutorialCTF directory with the file explorer of your operating system, you'll find many other directories and files that are not visible in Brainstorm database explorer.
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 file: brainstormstudy.mat
anat/@default_subject: contains the files of the default anatomy (Default anatomy)
data/@default_study: files shared between different subjects (Global common files)
data/@inter: results of inter-subject analysis
data/Subject01/@default_study: files shared between different conditions in Subject01
data/Subject01/@intra: results of intra-subject analysis (across different conditions)