Source code for medpy.io.load

# Copyright (C) 2013 Oskar Maier
# 
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
#
# author Oskar Maier
# version r0.3.1
# since 2012-05-28
# status Release

# build-in modules
import os.path

# third-party modules
import numpy as np
import SimpleITK as sitk

# own modules
from .header import Header
from ..core import Logger
from ..core import ImageLoadingError

# code
[docs]def load(image): r""" Loads the ``image`` and returns a ndarray with the image's pixel content as well as a header object. The header can, with restrictions, be used to extract additional meta-information about the image (e.g. using the methods in `~medpy.io.Header`). Additionally it serves as meta-data container that can be passes to `~medpy.io.save.save` when the altered image is saved to the hard drive again. Note that the transfer of meta-data is only possible, and even then not guaranteed, when the source and target image formats are the same. MedPy relies on SimpleITK, which enables the power of ITK for image loading and saving. The supported image file formats should include at least the following. Medical formats: - ITK MetaImage (.mha/.raw, .mhd) - Neuroimaging Informatics Technology Initiative (NIfTI) (.nia, .nii, .nii.gz, .hdr, .img, .img.gz) - Analyze (plain, SPM99, SPM2) (.hdr/.img, .img.gz) - Digital Imaging and Communications in Medicine (DICOM) (.dcm, .dicom) - Digital Imaging and Communications in Medicine (DICOM) series (<directory>/) - Nearly Raw Raster Data (Nrrd) (.nrrd, .nhdr) - Medical Imaging NetCDF (MINC) (.mnc, .MNC) - Guys Image Processing Lab (GIPL) (.gipl, .gipl.gz) Microscopy formats: - Medical Research Council (MRC) (.mrc, .rec) - Bio-Rad (.pic, .PIC) - LSM (Zeiss) microscopy images (.tif, .TIF, .tiff, .TIFF, .lsm, .LSM) - Stimulate / Signal Data (SDT) (.sdt) Visualization formats: - VTK images (.vtk) Other formats: - Portable Network Graphics (PNG) (.png, .PNG) - Joint Photographic Experts Group (JPEG) (.jpg, .JPG, .jpeg, .JPEG) - Tagged Image File Format (TIFF) (.tif, .TIF, .tiff, .TIFF) - Windows bitmap (.bmp, .BMP) - Hierarchical Data Format (HDF5) (.h5 , .hdf5 , .he5) - MSX-DOS Screen-x (.ge4, .ge5) For informations about which image formats, dimensionalities and pixel data types your current configuration supports, run `python3 tests/support.py > myformats.log`. Further information see https://simpleitk.readthedocs.io . Parameters ---------- image : string Path to the image to load. Returns ------- image_data : ndarray The image data as numpy array with order `x,y,z,c`. image_header : Header The image metadata as :mod:`medpy.io.Header`. Raises ------ ImageLoadingError If the image could not be loaded due to some reason. """ logger = Logger.getInstance() logger.info('Loading image {}...'.format(image)) if not os.path.exists(image): raise ImageLoadingError('The supplied image {} does not exist.'.format(image)) if os.path.isdir(image): # !TODO: this does not load the meta-data, find a way to load it from a series, too logger.info('Loading image as DICOM series. If more than one found in folder {} defaulting to first.'.format(image)) sitkimage = sitk.ReadImage(sitk.ImageSeriesReader_GetGDCMSeriesFileNames(image)) else: sitkimage = sitk.ReadImage(image) # Make image array data and header header = Header(sitkimage=sitkimage) image = sitk.GetArrayFromImage(sitkimage) # Roll axes from z,y,x,c to x,y,z,c if image.ndim == 4: image = np.moveaxis(image, -1, 0) image = image.T return image, header