= Coordinate systems = This page describes the various coordinate systems used in Brainstorm, and explains how to convert beetween referentials. <> == Subject Coordinate System (SCS / CTF) == Brainstorm uses the CTF head coordinate system. All the surfaces, sensors and additional points are converted into this system when they are imported in Brainstorm. It is defined in the following way: * '''Based on''': Nasion, left pre-auricular point (LPA), and right pre-auricular point (RPA). * '''Origin''': Midway on the line joining LPA and RPA. * '''Axis X''': From the origin towards the Nasion (exactly through). * '''Axis Y''': From the origin towards LPA in the plane defined by (NAS,LPA,RPA), and orthogonal. to X axis. * '''Axiz Z''': From the origin towards the top of the head. The affine transformation from MRI to SCS coordinates is saved in the [[https://neuroimage.usc.edu/brainstorm/Tutorials/ExploreAnatomy#On_the_hard_drive:_MRI|MRI SCS structure]]: * '''SCS.R''': [3x3] rotation matrix from MRI coordinates to SCS coordinates. * '''SCS.T''': [3x1] translation matrix from MRI coordinates to SCS coordinates. === Nasion (NAS) === The nasion is the intersection of the frontal and two nasal bones of the human skull. Its manifestation on the visible surface of the face is a distinctly depressed area directly between the eyes, just superior to the bridge of the nose (source: [[http://en.wikipedia.org/wiki/Nasion|Wikipedia]]). Use the coronal orientation to define it. {{attachment:NAS.gif||width="599",height="213"}} === Pre-auricular points (LPA, RPA) === <)>> {{attachment:preauricular.gif||width="148",height="235"}} <)>> The proper definition of the preauricular point is: "a point of the posterior root of the zygomatic arch lying immediately in front of the upper end of the tragus". This is illustrated with the green point below. The problem with this definition is that it can be really difficult to localize precisely on the MRI. It can lead to severe misregistration between MRI and MEG/EEG. More information on the anatomical location of this point on the [[http://fieldtrip.fcdonders.nl/faq/how_are_the_lpa_and_rpa_points_defined|FieldTrip website]]. Our proposition is to use instead the junction between the tragus and the helix, marked with a '''red dot''' in this figure. It can be located much more precisely both anatomically and on the MRI slices. You can choose to use this definition of the "preauricular point" or not. '''The most important is to use the same convention for all the steps: digitization of head points''' (eg. Polhemus) '''and analysis with Brainstorm'''. <)>> Use the sagittal orientation to define it. {{attachment:LPA.gif||width="599",height="213"}} === Notes for CTF users === Using a CTF system, you would probably prefer to use the head localization coils to indicate these NAS/LPA/RPA points, instead of these "anatomically correct" points. The coordinate system in the CTF files is based on the position of the three coils you stick on the head of the subject. Typically, the nose coil is slightly above the nasion, and the ear coils about one centimeter more frontal than the points that were previously described. A good practice is to take pictures of the subject with the coils on, right before bringing him/her in the MEG, and digitize the position of the center of the coils as the nasion/LPA/RPA. Then, when importing the MRI in Brainstorm, try marking as accurately as possible the position of the coils in the MRI. You cannot be very precise at this point, but the errors here are fixed later with the automatic registration. {{attachment:fiducials.jpg|LPA.gif}} __'''IMPORTANT'''__: These comments __do not apply__ if you use the [[Tutorials/TutDigitize|Brainstorm Digitize]] program to drive the Polhemus device. In this case, you are asked to digitize two sets of NAS/LPA/RPA points: the coils and the real anatomical points. Just make a copy of the [[http://neuroimage.usc.edu/brainstorm/CoordinateSystems#Brainstorm_.pos_files|.pos file]] saved by Digitize in the .ds folder, then set the real anatomical points in the MRI. Brainstorm is going to automatically handle the transformation between the CTF coils coordinate system and the real subject coordinate system. The result is usually much more accurate and does not require to take pictures of the subjects. === Using a default anatomy === The fiducial points (Nasion, LPA, RPA) used in your recordings might not be the same as the ones used in the anatomy templates in Brainstorm (ICBM152, Colin27, FSAverage). By default, the LPA/RPA points are defined at the junction between the tragus and the helix, as represented with the red dot. If you want to use an anatomy template but you are using a different convention when digitizing the position of these points, you have to modify the default positions of the template with the MRI Viewer. * Go to the anatomy view * In (default anatomy), right-click on the MRI > Edit MRI * Modify the position of the fiducial points to match your own convention * Click on [Save], it will update the surfaces to match the new coordinate system == MRI coordinates == Coordinates system used to index voxels in the space of the MRI volume, in millimeters: * __Axis X__: left>right * __Axis Y__: posterior>anterior * __Axis Z__: bottom>top * The first voxel at the bottom-left-posterior of the MRI volume is voxel (1,1,1). The coordinates of the center of this voxel in millimeters is (voxelsize_x, voxelsize_y, voxelsize_z). == World coordinates == Coordinates system used in the original MRI file, that was loaded as the reference MRI for a subject. It is defined by a 4x4 matrix saved directly in the MRI file. From NIfTI .nii files, it uses the matrix''' sform''' if available, or otherwise the matrix '''qform''' (see the [[https://nifti.nimh.nih.gov/nifti-1/documentation/nifti1fields/nifti1fields_pages/qsform.html|NIfTI documentation]]). From FreeSurfer .mgh/.mgz files, it uses the '''vox2ras''' matrix (see the [[https://surfer.nmr.mgh.harvard.edu/fswiki/CoordinateSystems|FreeSurfer documentation]]). In practical terms, it corresponds to the coordinates you see in the title bar when loading your volume in [[http://people.cas.sc.edu/rorden/mricron/index.html|MRIcron]], while the coordinates you see in the text boxes correspond in Brainstorm vocabulary to "voxel coordinates". For subject data, it corresponds most of the time to '''scanner coordinates'''. For atlases, it may correspond to normalized coordinates (e.g. MNI coordinates). If available, the transformation from voxels to world coordinates is saved in the field '''InitTransf{'vox2ras'}''' of the [[https://neuroimage.usc.edu/brainstorm/Tutorials/ExploreAnatomy#On_the_hard_drive:_MRI|MRI structure]]. == MNI coordinates == In order to compare the anatomy of multiple human brains or compute group statistics, it is necessary to define a common reference system. Two types of normalized systems have been widely used in the literature in the past: the atlas defined by [[http://en.wikipedia.org/wiki/Jean_Talairach|Jean Talairach]], and the [[http://www.bic.mni.mcgill.ca/~louis/stx_history.html|MNI stereotaxic coordinates]]. You can read about the differences between these two systems [[http://imaging.mrc-cbu.cam.ac.uk/imaging/MniTalairach|here]]. While the Talaraich system has been progressively abandonned, the "MNI space" has been increasingly used, thanks to the development of automatic normalization methods in open-source neuroimaging software. Successive updates to the reference brain and software versions led to the coexistence of multiple "MNI spaces". For an exhaustive list, refer to these two websites: [[https://bids-specification.readthedocs.io/en/latest/99-appendices/08-coordinate-systems.html#standard-template-identifiers|BIDS specification]], [[https://www.lead-dbs.org/about-the-mni-spaces/|Lead-DBS]]. In Brainstorm, '''MNI coordinates''' refer to the normalized space defined in '''SPM12''', also referred to as '''IXI549''' '''space'''. Computing this MNI normalization for a subject does not alter the input MRI or create a new normalized volume: it only stores a transformation that allows referencing the subject's MRI volume with standardized MNI coordinates. There are two options: a linear and a non-linear approach. {{attachment:mni_norm.gif}} === Linear normalization === * A [4x4] affine transformation is computed and saved in the [[https://neuroimage.usc.edu/brainstorm/Tutorials/ExploreAnatomy#On_the_hard_drive:_MRI|MRI NCS structure]]: * '''NCS.R''': [3x3] rotation matrix from MRI coordinates to MNI coordinates. * ''''''NCS.'''T''': [3x1] translation matrix from MRI coordinates to MNI coordinates. * The Brainstorm function [[https://github.com/brainstorm-tools/brainstorm3/blob/master/toolbox/anatomy/bst_normalize_mni.m|mri_normalize_maff.m]] is based on SPM12 function [[https://github.com/spm/spm12/blob/master/spm_maff8.m|spm_maff8.m]], described in [[http://www.ncbi.nlm.nih.gov/pubmed/15955494|(Ashburner 2005)]]. It is integrated in Brainstorm and does not require the installation of SPM12. * This transformation is fast to compute and to apply to 3D coordinates, and very light in terms of storage. It is appropriate for computing a deformation of the bounding box of the brain and adapted for quickly aligning brains in the same space, or for defining the seed of a [[https://neuroimage.usc.edu/brainstorm/Tutorials/TutVolSource#Volume_scouts|volume scout]]. However, it is not adapted to model the differences in the cortical folding of the individual brains or to the projection of a MNI parcellation to subject space. === Non-linear normalization === * Each voxel of the individual brain is projected to the MNI space independently from the others. In order to represent these non-linear deformation fields between volumes, we use the SPM12 representation: three volumes are saved per transformation, one for each dimension (X,Y,Z). One triplet of 3D matrices is necessary to convert from MNI to MRI coordinates (forward transformation), and one other to convert from MRI to MNI (inverse transformation). The following fields are stored in the [[https://neuroimage.usc.edu/brainstorm/Tutorials/ExploreAnatomy#On_the_hard_drive:_MRI|MRI NCS structure]]: * ''''''NCS.'''iy''': 4D floating point matrix [x,y,z,3]: Inverse MNI deformation field. Same size as the Cube matrix, it gives for each voxel its coordinates in the MNI space, and is therefore used to convert from MRI coordinates to MNI coordinates. * ''''''NCS.'''y''': 4D floating point matrix [x,y,z,3]: Forward MNI deformation field. For some MNI coordinates, it gives their coorrespondance in the original subject space. To be interpreted, it has to be used with the matrix y_vox2ras. * ''''''NCS.'''y_vox2ras''': [4x4 double], transformation matrix that converts from voxel coordinates of the y volume to MNI coordinates. * ''''''NCS.'''y_method''': Algorithm used for the normalization (e.g. 'segment'=SPM12 Segment) * Example: The coordinates of the MRI voxel (i,j,k) correspond in MNI space to:<
><
> {{{ mni_x = NCS.iy(i,j,k,1); mni_y = NCS.iy(i,j,k,2); mni_z = NCS.iy(i,j,k,3); }}} * A non-linear transformation can represent the individual anatomical variations, and is adapted for warping an MNI parcellation to the subject space. However, it is much heavier computationally. For each MRI volume, we need to store 6 additional volumes in the file, causing an important increase of the file size and the load time. The computation of MNI coordinates is also much longer, slowing down the interface of the MRI Viewer. * Using the SPM12 Segment algorithm requires the installation of a full version of SPM12, either manually or as [[https://neuroimage.usc.edu/brainstorm/Tutorials/Plugins|Brainstorm plugin]]. === References === * '''MNI space''': Refers to a system of coordinates for indexing the voxels within a volume, applicable to either individual MRI/CT volumes or anatomical atlases. * '''Anatomy template''': Set of anatomical files (MRI, surfaces, parcellations) constituting a brain atlas. As the reference anatomy, we typically use the [[http://nist.mni.mcgill.ca/?p=904|ICBM125 2009c Nonlinear Asymmetric]], but other options are described in the tutorial [[https://neuroimage.usc.edu/brainstorm/Tutorials/DefaultAnatomy|Using the anatomy templates]]. An anatomy template can be used for various purposes: * Replacing the subject anatomy in the Brainstorm database when no individual scans are available for the subject. Setting the anatomy of the subject is necessary for 2D/3D topography display and source estimation. * Warping an anatomy template to match the digitized head shape of a subject. See tutorial: [[Tutorials/TutWarping|Warping the anatomy templates]] * For group analysis at the source level: an intermediate step of projection on an anatomy template is necessary. See tutorial: [[Tutorials/CoregisterSubjects|Group analysis: Subjects coregistration]] * '''MNI template''': Anatomy template that has the particularity to be registered into an MNI space (MNI152, Colin27). * '''MNI parcellations''': Volume of integers where each value represents an anatomical label, and registered to an MNI space. A non-linear deformation field can be applied to an MNI parcellation in order to create a volume parcellation in subject space. The anatomical regions can be used as [[https://neuroimage.usc.edu/brainstorm/Tutorials/ExploreAnatomy#Subcortical_regions:_Volume|volume scouts]], for reference in the [[https://neuroimage.usc.edu/brainstorm/Tutorials/ExploreAnatomy#Subcortical_regions:_Volume|MRI viewer]], or for [[https://neuroimage.usc.edu/brainstorm/Tutorials/ECoG|labelling SEEG contacts]]. == Talairach coordinates == ''> This is not much used ''in Brainstorm anymore. '' '' ''If we cannot compute the MNI normalization as presented in the previous section, we use an approximation to the Talaraich coordinate system. It relies on two points, the posterior and anterior commissure, and the midsagittal plane. The third point needed here, the interhemispheric point, is used to define this plane. You can read about the differences between these two systems on that page: '' === Anterior commissure (AC) === ''Description of the anterior commissure at [[http://en.wikipedia.org/wiki/Anterior_commissure|this Wikipedia page]]. '' ''Technique to localize it: '' * ''Use the axial orientation. '' * ''Start from a slice just below the corpus callosum and move around it (slightly up or down) '' * ''You are looking for a small fiber tract that connects the two hemispheres '' * ''You should find two spots corresponding to this description. The more frontal one is the anterior commissure, the other one is the posterior commissure '' * ''Once you have localized it: if it is visible on more than one slice, use the upper one (the one closest to the top of the head). '' '' {{attachment:AC.gif||width="601",height="214"}} '' === Posterior commissure (PC) === ''Description of the posterior commissure at [[http://en.wikipedia.org/wiki/Posterior_commissure|this Wikipedia page]]. '' ''Technique to localize it: '' * ''Use the axial orientation '' * ''It is a fiber tract similar to the anterior commissure, but a few centimeters more posterior. '' * ''If it is visible on more than one slice, pick the lowest one. '' '' {{attachment:PC.gif||width="600",height="213"}} '' === Interhemispheric point (IH) === ''Pick any point in the interhemispheric space, somewhere in the top of the head. Do not use a point too close from the commissures. '' '' {{attachment:IH.gif||width="599",height="213"}} <
><
> '' == Neuromag coordinates == ''This coordinates system is not used in Brainstorm, and described here only FYI. All the information contained in Neuromag .FIF files are in this CS, and converted to Brainstorm SCS at importation. '' ''It is defined in the following way: '' * ''__Based on__: Nasion, left pre-auricular point (LPA), and right pre-auricular point (RPA). '' * ''__Origin__: Intersection of the line L through LPA and RPA and a plane orthogonal to L and passing through the nasion. '' * ''__Axis X__: From the origin towards the RPA point (exactly through) '' * ''__Axis Y__: From the origin towards the nasion (exactly through) '' * ''__Axiz Z__: From the origin towards the top of the head '' == Converting between coordinate systems == ''The conversions between coordinate systems is handled with one single function cs_convert: '' * ''sMri: MRI structure from the database: right-click on the MRI file > File > Export to Matlab > sMri '' * ''src/dest: Source and destination coordinates systems: {'voxel', 'mri', 'scs', 'mni', 'world'} '' * ''P: List of points [Npoints x 3] '' * ''All the the coordinates have to be in '''meters''' (not millimeters). '' {{{ }}} ''Examples: '' {{{ }}} == Brainstorm .pos files == ''The .pos files generated with the [[Tutorials/TutDigitize|Brainstorm Digitizer]] contain both the positions of the '''anatomical landmarks''' (nasion, left ear, right ear) and the position of the '''head localization coils''' (HPI). '' ''Having the two sets of points allows us to convert automatically from the native CTF coordinates (based on the coils) to the recommended landmarks in Brainstorm (based on the anatomical landmarks). When a '''Brainstorm .pos file''' is present in the CTF '''.ds folder''', it is loaded automatically and used to convert the positions of the EEG and MEG sensors to the anatomical reference. This is done automatically without any message or user confirmation. In this case, you should mark the '''anatomical landmarks''' (real nasion and tragus/helix junctions) in the MRI Viewer when importing the anatomy. This is what is described in the [[Tutorials/ImportAnatomy|introduction tutorials]]. '' ''Otherwise, if you are importing CTF recordings '''without a Brainstorm .pos file''' in the .ds folders, or if you are importing the .pos files after linking the recordings to the database, you should typically select the positions of the '''CTF HPI coils''' in the MRI viewer. '' ''The syntax of these .pos files is the following, one line per digitized point: '' {{{ }}} ''In the .pos files, the anatomical landmarks are labelled '''Nasion/LPA/RPA''', and the CTF HPI coils are labelled '''HPI-N/HPI-L/HPI-R''' (for nasion coil, left coil, right coil). Note that in the CTF software, the HPI coils are labelled NAS/LPA/RPA, which can lead to some confusion. '' ''We usually take multiple measures of each reference point and average them when we load the file. This helps improving the accuracy of the registration. '' {{{ }}} == Additional documentation == * ''Tutorial: [[http://neuroimage.usc.edu/brainstorm/Tutorials/ChannelFile|Channel file / MRI registration]] '' * ''Forum: [[http://neuroimage.usc.edu/forums/showthread.php?1429|Bad MEG-MRI registration]] '' * ''Forum: [[http://neuroimage.usc.edu/forums/showthread.php?1389|Coregistration validation]] '' * ''Forum: Import the position of SEEG/ECOG contacts: [[http://neuroimage.usc.edu/forums/showthread.php?2206|Post #2206]], [[http://neuroimage.usc.edu/forums/showthread.php?1958|Post #1958]], [[http://neuroimage.usc.edu/forums/showthread.php?2357|Post #2357]] '' ''<> ''