Repository files navigation

A simple Python-based tool for finding brain atlas regions based on MNI coordinates, with basic plotting abilities to show the sagittal, coronal, and axial views of the coordinates on the atlas.

The following atlases are currently supported:

• Automated anatomical labelling atlas[1]
• Automated anatomical labelling 3 atlas (1mm³ voxel version)[2]
• Human Connectome Project extended parcellation atlas[3]

If there is an atlas you would like to see added, please open anissue.

Example screenshot of the plotting:

See here for the list of requirements.

1. Install the package into the desired environment using pippip install mni-to-atlas.
2. Import theAtlasBrowser class into your workspace.
3. Create an instance of theAtlasBrowser class and specify an atlas to use (can be "AAL", "AAL3", or "HCPEx").
4. Provide MNI coordinates to theAtlasBrowser object to find the corresponding atlas regions. The brain regions for these coordinates are then returned as a list of strings.
   • The coordinates should be an (n x 3) array, where each row contains an x-, y-, and z-axis MNI coordinate.
   • By default, plotting the coordinates is not performed, however this can be changed by settingplot = True in thefind_regions method. In this case, a figure will be generated for each set of coordinates.

# Import the AtlasBrowser classfrommni_to_atlasimportAtlasBrowser# Instantiate the AtlasBrowser class and specify the atlas to useatlas=AtlasBrowser("AAL3")# Provide MNI coordinates as an (n x 3) arraycoordinates=np.array([[-24,-53,73],                        [-25,20,78]])# Find the brain regions at the MNI coordinates (plotting is optional)regions=atlas.find_regions(coordinates,plot=True)

1. Tzourio-Mazoyeret al. (2002) DOI:10.1006/nimg.2001.0978
2. Rollset al. (2020) DOI:10.1016/j.neuroimage.2019.116189
3. Huanget al. (2022) DOI:10.1007/s00429-021-02421-6