Utilities to read and write images in various formats.
The following plug-ins are available:
Plugin | Description |
fits | FITS image reading via PyFITS |
gtk | Fast image display using the GTK library |
tifffile | Load and save TIFF and TIFF-based images using tifffile.py |
matplotlib | Display or save images using Matplotlib |
imread | Image reading and writing via imread |
imageio | Image reading via the ImageIO Library |
pil | Image reading via the Python Imaging Library |
gdal | Image reading via the GDAL Library (www.gdal.org) |
simpleitk | Image reading and writing via SimpleITK |
qt | Fast image display using the Qt library |
skimage.io.call_plugin (kind, *args, **kwargs) | Find the appropriate plugin of ‘kind’ and execute it. |
skimage.io.concatenate_images (ic) | Concatenate all images in the image collection into an array. |
skimage.io.find_available_plugins ([loaded]) | List available plugins. |
skimage.io.imread (fname[, as_gray, plugin, …]) | Load an image from file. |
skimage.io.imread_collection (load_pattern[, …]) | Load a collection of images. |
skimage.io.imread_collection_wrapper (imread) | |
skimage.io.imsave (fname, arr[, plugin]) | Save an image to file. |
skimage.io.imshow (arr[, plugin]) | Display an image. |
skimage.io.imshow_collection (ic[, plugin]) | Display a collection of images. |
skimage.io.load_sift (f) | Read SIFT or SURF features from externally generated file. |
skimage.io.load_surf (f) | Read SIFT or SURF features from externally generated file. |
skimage.io.plugin_info (plugin) | Return plugin meta-data. |
skimage.io.plugin_order () | Return the currently preferred plugin order. |
skimage.io.pop () | Pop an image from the shared image stack. |
skimage.io.push (img) | Push an image onto the shared image stack. |
skimage.io.reset_plugins () | |
skimage.io.show () | Display pending images. |
skimage.io.use_plugin (name[, kind]) | Set the default plugin for a specified operation. |
skimage.io.ImageCollection (load_pattern[, …]) | Load and manage a collection of image files. |
skimage.io.MultiImage (filename[, …]) | A class containing a single multi-frame image. |
skimage.io.collection | Data structures to hold collections of images, with optional caching. |
skimage.io.manage_plugins | Handle image reading, writing and plotting plugins. |
skimage.io.sift | |
skimage.io.util |
skimage.io.call_plugin(kind, *args, **kwargs)
[source]
Find the appropriate plugin of ‘kind’ and execute it.
Parameters: |
|
---|
skimage.io.concatenate_images(ic)
[source]
Concatenate all images in the image collection into an array.
Parameters: |
|
---|---|
Returns: |
|
Raises: |
|
See also
ImageCollection.concatenate
, MultiImage.concatenate
skimage.io.find_available_plugins(loaded=False)
[source]
List available plugins.
Parameters: |
|
---|---|
Returns: |
|
skimage.io.imread(fname, as_gray=False, plugin=None, flatten=None, **plugin_args)
[source]
Load an image from file.
Parameters: |
|
---|---|
Returns: |
|
Other Parameters: | |
|
skimage.io.imread_collection(load_pattern, conserve_memory=True, plugin=None, **plugin_args)
[source]
Load a collection of images.
Parameters: |
|
---|---|
Returns: |
|
Other Parameters: | |
|
skimage.io.imread_collection_wrapper(imread)
[source]
skimage.io.imsave(fname, arr, plugin=None, **plugin_args)
[source]
Save an image to file.
Parameters: |
|
---|---|
Other Parameters: | |
|
When saving a JPEG, the compression ratio may be controlled using the quality
keyword argument which is an integer with values in [1, 100] where 1 is worst quality and smallest file size, and 100 is best quality and largest file size (default 75). This is only available when using the PIL and imageio plugins.
skimage.io.imshow(arr, plugin=None, **plugin_args)
[source]
Display an image.
Parameters: |
|
---|---|
Other Parameters: | |
|
skimage.io.imshow_collection(ic, plugin=None, **plugin_args)
[source]
Display a collection of images.
Parameters: |
|
---|---|
Other Parameters: | |
|
skimage.io.load_sift(f)
[source]
Read SIFT or SURF features from externally generated file.
This routine reads SIFT or SURF files generated by binary utilities from http://people.cs.ubc.ca/~lowe/keypoints/ and http://www.vision.ee.ethz.ch/~surf/.
This routine does not generate SIFT/SURF features from an image. These algorithms are patent encumbered. Please use skimage.feature.CENSURE
instead.
Parameters: |
|
---|---|
Returns: |
|
skimage.io.load_surf(f)
[source]
Read SIFT or SURF features from externally generated file.
This routine reads SIFT or SURF files generated by binary utilities from http://people.cs.ubc.ca/~lowe/keypoints/ and http://www.vision.ee.ethz.ch/~surf/.
This routine does not generate SIFT/SURF features from an image. These algorithms are patent encumbered. Please use skimage.feature.CENSURE
instead.
Parameters: |
|
---|---|
Returns: |
|
skimage.io.plugin_info(plugin)
[source]
Return plugin meta-data.
Parameters: |
|
---|---|
Returns: |
|
skimage.io.plugin_order()
[source]
Return the currently preferred plugin order.
Returns: |
|
---|
skimage.io.pop()
[source]
Pop an image from the shared image stack.
Returns: |
|
---|
skimage.io.push(img)
[source]
Push an image onto the shared image stack.
Parameters: |
|
---|
skimage.io.reset_plugins()
[source]
skimage.io.show()
[source]
Display pending images.
Launch the event loop of the current gui plugin, and display all pending images, queued via imshow
. This is required when using imshow
from non-interactive scripts.
A call to show
will block execution of code until all windows have been closed.
>>> import skimage.io as io
>>> for i in range(4): ... ax_im = io.imshow(np.random.rand(50, 50)) >>> io.show() # doctest: +SKIP
skimage.io.use_plugin(name, kind=None)
[source]
Set the default plugin for a specified operation. The plugin will be loaded if it hasn’t been already.
Parameters: |
|
---|
See also
available_plugins
To use Matplotlib as the default image reader, you would write:
>>> from skimage import io >>> io.use_plugin('matplotlib', 'imread')
To see a list of available plugins run io.available_plugins
. Note that this lists plugins that are defined, but the full list may not be usable if your system does not have the required libraries installed.
class skimage.io.ImageCollection(load_pattern, conserve_memory=True, load_func=None, **load_func_kwargs)
[source]
Bases: object
Load and manage a collection of image files.
Note that files are always stored in alphabetical order. Also note that slicing returns a new ImageCollection, not a view into the data.
Parameters: |
|
---|---|
Other Parameters: | |
|
ImageCollection can be modified to load images from an arbitrary source by specifying a combination of load_pattern
and load_func
. For an ImageCollection ic
, ic[5]
uses load_func(file_pattern[5])
to load the image.
Imagine, for example, an ImageCollection that loads every tenth frame from a video file:
class AVILoader: video_file = 'myvideo.avi' def __call__(self, frame): return video_read(self.video_file, frame) avi_load = AVILoader() frames = range(0, 1000, 10) # 0, 10, 20, ... ic = ImageCollection(frames, load_func=avi_load) x = ic[5] # calls avi_load(frames[5]) or equivalently avi_load(50)
Another use of load_func
would be to convert all images to uint8
:
def imread_convert(f): return imread(f).astype(np.uint8) ic = ImageCollection('/tmp/*.png', load_func=imread_convert)
For files with multiple images, the images will be flattened into a list and added to the list of available images. In this case, load_func
should accept the keyword argument img_num
.
>>> import skimage.io as io >>> from skimage import data_dir
>>> coll = io.ImageCollection(data_dir + '/chess*.png') >>> len(coll) 2 >>> coll[0].shape (200, 200)
>>> ic = io.ImageCollection('/tmp/work/*.png:/tmp/other/*.jpg')
Attributes: |
|
---|
__init__(load_pattern, conserve_memory=True, load_func=None, **load_func_kwargs)
[source]
Load and manage a collection of images.
concatenate()
[source]
Concatenate all images in the collection into an array.
Returns: |
|
---|---|
Raises: |
|
See also
conserve_memory
files
reload(n=None)
[source]
Clear the image cache.
Parameters: |
|
---|
class skimage.io.MultiImage(filename, conserve_memory=True, dtype=None, **imread_kwargs)
[source]
Bases: skimage.io.collection.ImageCollection
A class containing a single multi-frame image.
Parameters: |
|
---|
If conserve_memory=True
the memory footprint can be reduced, however the performance can be affected because frames have to be read from file more often.
The last accessed frame is cached, all other frames will have to be read from file.
The current implementation makes use of tifffile
for Tiff files and PIL otherwise.
>>> from skimage import data_dir
>>> img = MultiImage(data_dir + '/multipage.tif') # doctest: +SKIP >>> len(img) # doctest: +SKIP 2 >>> for frame in img: # doctest: +SKIP ... print(frame.shape) # doctest: +SKIP (15, 10) (15, 10)
__init__(filename, conserve_memory=True, dtype=None, **imread_kwargs)
[source]
Load a multi-img.
filename
© 2011 the scikit-image team
Licensed under the BSD 3-clause License.
http://scikit-image.org/docs/0.14.x/api/skimage.io.html