Note

This page is a reference documentation. It only explains the function signature, and not how to use it. Please refer to the user guide for the big picture.

7.5.3. nilearn.image.coord_transform

nilearn.image.coord_transform(x, y, z, affine)
Convert the x, y, z coordinates from one image space to another
space.
Parameters:

x : number or ndarray (any shape)

The x coordinates in the input space

y : number or ndarray (same shape as x)

The y coordinates in the input space

z : number or ndarray

The z coordinates in the input space

affine : 2D 4x4 ndarray

affine that maps from input to output space.

Returns:

x : number or ndarray (same shape as input)

The x coordinates in the output space

y : number or ndarray (same shape as input)

The y coordinates in the output space

z : number or ndarray (same shape as input)

The z coordinates in the output space

Warning: The x, y and z have their output space (e.g. MNI) coordinate

ordering, not 3D numpy image ordering.

Examples

Transform data from coordinates to brain space. The “affine” matrix can be found as the ”.affine” attribute of a nifti image, or using the “get_affine()” method for older nibabel installations:

>>> from nilearn import datasets, image
>>> niimg = datasets.load_mni152_template()
>>> # Find the MNI coordinates of the voxel (10, 10, 10)
>>> image.coord_transform(50, 50, 50, niimg.affine)
(-10.0, -26.0, 28.0)

7.5.3.1. Examples using nilearn.image.coord_transform