Atlases
Atlases can either be a plugin JAR file that implements the Atlas plugin interface or a folder with an extension of .atlas which contains atlas files that follow the FSL Atlas Specification. To load an atlas in Mango, open Add/Remove Plugins from the toolbox, click Add, then select either the JAR file or .atlas folder.
Once loaded, the atlas will appear as a drop-down of the coordinate mode button. Two atlases -- Talairach and MNI -- are included by default with Mango. If FSL is installed, Mango will attempt to automatically load the atlases included with this software package. To manually load an atlas, see below.
Creating an Atlas
Mango can read atlas data that follows the FSL Atlas specification. An atlas of this kind is composed of two files. An XML file that contains a map of anatomical labels and an image file that references these labels.
The atlas data that comes with an FSL installation can easily be packaged for Mango. To create a Mango atlas, follow these steps:
- Create a folder and give it an extension of .atlas.
- Copy the XML file to this folder.
- Note in the XML file the relative path of the image file. Create any subfolders necessary for this path and copy the image to this location.
- Open Add/Remove Plugins from the toolbox, click Add, then select the .atlas folder.
See this downloadable atlas as an example of how to package a Mango atlas.
Atlas Use Notes
- Only one <images> tag in an XML file will be recognized.
- For probabilistic atlases, only the <summaryimagefile> tag is currently supported.
- The following are considered delimiters in a label string . , / :
- Loaded atlas folders are not displayed in the Image Browser (iMango only).
- Once unpacked, the .atlas.zip file can be removed from the device (iMango only).
Atlas Spec Extensions
- A maximum of 4 label parts can be displayed. If an atlas contains labels with more parts than this, use a <display> tag to specify which labels to use. For example, <display>*.*. .*.*</display> would specify that the first, second, fourth, and fifth parts are to be displayed.
- A <transform> tag can be used to transform the input coordinate. This tag should contain 16 space-delimited values.
- A <transformedname> tag can be used to differentiate between the transformed and non-transformed state (Papaya only).