__all__ = ['imread'] import numpy as np try: from PIL import Image except ImportError: raise ImportError("The Python Image Library could not be found. " "Please refer to " "https://pypi.python.org/pypi/Pillow/ (or " "http://pypi.python.org/pypi/PIL/) " "for further instructions.") from skimage.util import img_as_ubyte, img_as_uint, img_as_int from six import string_types from .tifffile import imread as tif_imread, imsave as tif_imsave def imread(fname, dtype=None): """Load an image from file. Parameters ---------- fname : str File name. dtype : numpy dtype object or string specifier Specifies data type of array elements. Notes ----- Tiff files are handled by Christophe Golhke's tifffile.py, and support many advanced image types including multi-page and floating point. """ if hasattr(fname, 'lower') and dtype is None: if fname.lower().endswith(('.tiff', '.tif')): return tif_imread(fname) im = Image.open(fname) try: # this will raise an IOError if the file is not readable im.getdata()[0] except IOError: site = "http://pillow.readthedocs.org/en/latest/installation.html#external-libraries" raise ValueError('Could not load "%s"\nPlease see documentation at: %s' % (fname, site)) else: return pil_to_ndarray(im, dtype) def pil_to_ndarray(im, dtype=None): """Import a PIL Image object to an ndarray, in memory. Parameters ---------- Refer to ``imread``. """ fp = im.fp if hasattr(im, 'fp') else None if im.mode == 'P': if _palette_is_grayscale(im): im = im.convert('L') else: im = im.convert('RGB') elif im.mode == '1': im = im.convert('L') elif im.mode.startswith('I;16'): shape = im.size dtype = '>u2' if im.mode.endswith('B') else '= 0: arr = arr.astype(np.uint8) mode = 'L' mode_base = 'L' elif arr.min() >= 0: arr = img_as_uint(arr) mode = 'I;16' mode_base = 'I' else: arr = img_as_int(arr) mode = 'I' mode_base = 'I' else: arr = img_as_ubyte(arr) mode = 'L' mode_base = 'L' if arr.ndim == 2: im = Image.new(mode_base, arr.T.shape) im.fromstring(arr.tostring(), 'raw', mode) else: try: im = Image.frombytes(mode, (arr.shape[1], arr.shape[0]), arr.tostring()) except AttributeError: im = Image.fromstring(mode, (arr.shape[1], arr.shape[0]), arr.tostring()) return im def imsave(fname, arr, format_str=None): """Save an image to disk. Parameters ---------- fname : str or file-like object Name of destination file. arr : ndarray of uint8 or float Array (image) to save. Arrays of data-type uint8 should have values in [0, 255], whereas floating-point arrays must be in [0, 1]. format_str: str Format to save as, this is defaulted to PNG if using a file-like object; this will be derived from the extension if fname is a string Notes ----- Tiff files are handled by Christophe Golhke's tifffile.py, and support many advanced image types including multi-page and floating point. All other image formats use the Python Imaging Libary. See http://pillow.readthedocs.org/en/latest/handbook/image-file-formats.html for a list of other supported formats. Integer type images are only supported for PNGs. All images besides single channel PNGs are converted using `img_as_uint8`. Single Channel PNGS have the following behavior: - Boolean types -> convert to uint8 - Integer values in {0, 256} -> convert to uin8 - Integer values > 0 -> convert to uint16 - Integer values < 0 -> convert to int16 - Floating point images -> convert to uint16 """ # default to PNG if file-like object if not isinstance(fname, string_types) and format_str is None: format_str = "PNG" arr = np.asanyarray(arr).squeeze() use_tif = False if hasattr(fname, 'lower'): if fname.lower().endswith(('.tiff', '.tif')): use_tif = True if not format_str is None: if format_str.lower() in ['tiff', 'tif']: use_tif = True if use_tif: tif_imsave(fname, arr) return if arr.ndim not in (2, 3): raise ValueError("Invalid shape for image array: %s" % arr.shape) if arr.ndim == 3: if arr.shape[2] not in (3, 4): raise ValueError("Invalid number of channels in image array.") if arr.dtype.kind == 'b': arr = arr.astype(np.uint8) img = ndarray_to_pil(arr, format_str=None) img.save(fname, format=format_str) def imshow(arr): """Display an image, using PIL's default display command. Parameters ---------- arr : ndarray Image to display. Images of dtype float are assumed to be in [0, 1]. Images of dtype uint8 are in [0, 255]. """ Image.fromarray(img_as_ubyte(arr)).show() def _app_show(): pass