NiBabel

Access a cacophony of neuro-imaging file formats

This Page

Reggie -- the one

nibabel.analyze.AnalyzeImage

digraph inheritance6d2e08605d { rankdir=LR; ratio=compress; fontsize=14; size="6.0, 8.0"; "SpatialImage" [shape=ellipse,URL="nibabel.spatialimages.SpatialImage.html#nibabel.spatialimages.SpatialImage",fontname=Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans,fontsize=14,color=dodgerblue1,style=filled,height=0.75]; "AnalyzeImage" [shape=ellipse,URL="#nibabel.analyze.AnalyzeImage",fontname=Vera Sans, DejaVu Sans, Liberation Sans, Arial, Helvetica, sans,fontsize=14,color=dodgerblue1,style=filled,height=0.75]; "SpatialImage" -> "AnalyzeImage" [arrowsize=0.5,style="setlinewidth(0.5)"]; }

class nibabel.analyze.AnalyzeImage(data, affine, header=None, extra=None, file_map=None)

Initialize image

Parameters :

data : array-like

image data. It should be some object that retuns an array from np.asanyarray

affine : (4,4) array

homogenous affine giving relationship between voxel coordinates and world coordinates

header : None or mapping or header instance, optional

metadata for this image format

extra : None or mapping, optional

metadata to associate with image that cannot be stored in the metadata of this image type

file_map : mapping, optional

mapping giving file information for this image format

Methods

ImageArrayProxy
filespec_to_file_map
filespec_to_files
from_file_map
from_filename
from_files
from_filespec
from_image
get_affine
get_data
get_data_dtype
get_filename
get_header
get_shape
header_class
instance_to_filename
load(klass, filename)
make_file_map
save(klass, img, filename) Save img in our own format, to name implied by filename
set_data_dtype
set_filename
to_file_map
to_filename
to_files
to_filespec
update_header
class ImageArrayProxy(file_like, header)

Analyze-type implemention of array proxy protocol

The array proxy allows us to freeze the passed fileobj and header such that it returns the expected data array.

classmethod AnalyzeImage.from_file_map(klass, file_map)

class method to create image from mapping in file_map `

AnalyzeImage.get_data_dtype()
AnalyzeImage.get_header()

Return header

AnalyzeImage.get_shape()
AnalyzeImage.header_class

alias of AnalyzeHeader

AnalyzeImage.set_data_dtype(dtype)
AnalyzeImage.to_file_map(file_map=None)

Write image to file_map or contained self.file_map

Parameters :

file_map : None or mapping, optional

files mapping. If None (default) use object’s file_map attribute instead

AnalyzeImage.update_header()

Harmonize header with image data and affine

>>> data = np.zeros((2,3,4))
>>> affine = np.diag([1.0,2.0,3.0,1.0])
>>> img = AnalyzeImage(data, affine)
>>> hdr = img.get_header()
>>> img.get_shape()
(2, 3, 4)
>>> img.update_header()
>>> hdr.get_data_shape()
(2, 3, 4)
>>> hdr.get_zooms()
(1.0, 2.0, 3.0)