Skip to content

rreilink/imageio

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

IMAGEIO

Build Status Coverage Status Pypi downloads Documentation Status

Website: http://imageio.github.io

The imageio library aims to support reading and writing a wide range of image data, including animated images, volumetric data, and scientific formats. It is written in pure Python (2.x and 3.x) and is designed to be powerful, yet simple in usage and installation.

Imageio has a relatively simple core that provides a common interface to different file formats. The actual file formats are implemented in plugins, which makes imageio easy to extend.

Example

Here's a minimal example of how to use imageio. See the docs for more examples.
>>> import imageio
>>> im = imageio.imread('chelsea.png')
>>> im.shape  # im is a numpy array
(300, 451, 3)
>>> imageio.imsave('chelsea-gray.jpg', im[:, :, 0])

API in a nutshell

As a user, you just have to remember a handfull of functions:
  • imread() and imsave() - for single images
  • mimread() and mimsave() - for image series (animations)
  • volread() and volsave() - for volumetric image data
  • read() and save() - for more control (e.g. streaming)
  • See the user api for more information

Features

  • Simple interface via a consise set of functions.
  • Easy to install using conda or pip.
  • Few dependencies (only Numpy).
  • Pure Python, runs on Python 2.x, 3.x, and Pypy
  • Lots of supported formats.
  • Can also read from zipfiles, http/ftp, and raw bytes.
  • Easy to extend using plugins.
  • Loads of unit tests with continuous integration.

Releases

No releases published

Packages

No packages published

Languages

  • Python 98.6%
  • Shell 1.4%