Utilities to load and save image objects
guessed_image_type(*args, **kwargs) | Guess image type from file filename |
load(filename, **kwargs) | Load file given filename, guessing at file type |
read_img_data(*args, **kwargs) | Read data from image associated with files |
save(img, filename) | Save an image to file adapting format to filename |
which_analyze_type(*args, **kwargs) | Is binaryblock from NIfTI1, NIfTI2 or Analyze header? |
Guess image type from file filename
guessed_image_type deprecated.2.1
Parameters: | filename : str
|
---|---|
Returns: | image_class : class
|
Load file given filename, guessing at file type
Parameters: | filename : string
**kwargs : keyword arguments
|
---|---|
Returns: | img : SpatialImage
|
Read data from image associated with files
read_img_data deprecated.Please use img.dataobj.get_unscaled() instead.2.0.1
If you want unscaled data, please use img.dataobj.get_unscaled() instead. If you want scaled data, use img.get_data() (which will cache the loaded array) or np.array(img.dataobj) (which won’t cache the array). If you want to load the data as for a modified header, save the image with the modified header, and reload.
Parameters: | img : SpatialImage
prefer : str, optional
|
---|---|
Returns: | arr : ndarray
|
Notes
Summary: please use the get_data method of img instead of this function unless you are sure what you are doing.
In general, you will probably prefer prefer='scaled', because this gives the data as the image format expects to return it.
Use prefer == ‘unscaled’ with care; the modified Analyze-type formats such as SPM formats, and nifti1, specify that the image data array is given by the raw data on disk, multiplied by a scalefactor and maybe with the addition of a constant. This function, with unscaled returns the data on the disk, without these format-specific scalings applied. Please use this funciton only if you absolutely need the unscaled data, and the magnitude of the data, as given by the scalefactor, is not relevant to your application. The Analyze-type formats have a single scalefactor +/- offset per image on disk. If you do not care about the absolute values, and will be removing the mean from the data, then the unscaled values will have preserved intensity ratios compared to the mean-centered scaled data. However, this is not necessarily true of other formats with more complicated scaling - such as MINC.
Save an image to file adapting format to filename
Parameters: | img : SpatialImage
filename : str
|
---|---|
Returns: | None : |
Is binaryblock from NIfTI1, NIfTI2 or Analyze header?
which_analyze_type deprecated.2.1
Parameters: | binaryblock : bytes
|
---|---|
Returns: | hdr_type : str
|
Notes
Algorithm: