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.

coord_transform¶

nilearn.image.coord_transform(x, y, z, affine)[source]¶

Convert the x, y, z coordinates from one image space to another space.

Parameters:

xnumber or ndarray (any shape): The x coordinates in the input space.
ynumber or ndarray (same shape as x): The y coordinates in the input space.
znumber or ndarray: The z coordinates in the input space.
affine2D 4x4 ndarray: Affine that maps from input to output space.

Returns:

xnumber or ndarray (same shape as input): The x coordinates in the output space.
ynumber or ndarray (same shape as input): The y coordinates in the output space.
znumber 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 (50, 50, 50)
>>> image.coord_transform(50, 50, 50, niimg.affine)
(-48.0, -84.0, -22.0)

Examples using `nilearn.image.coord_transform`¶

Encoding models for visual stimuli

Comparing connectomes on different reference atlases

coord_transform¶

Examples using nilearn.image.coord_transform¶

Examples using `nilearn.image.coord_transform`¶