Skip to main content

imread: Image reading library

Project description

Simple module with a small number of functions:

Reads an image file
Reads an image file with multiple images. Currently, TIFF and STK (a TIFF sub-based format) support this function.
Writes an image file

This grew out of frustration at current image loading solutions in Python, in either my packages [mahotas] or packages from others [scikits.image, for example].

The relationship with numpy is very contained and this could be easily repurposed to load images in other frameworks, even other programming languages.


To install on debian/ubuntu:

sudo apt-get install libpng12-dev libtiff4-dev libwebp-dev

To install on Mac:

sudo port install libpng tiff webp

Bug Reports

Please report any bugs either on github or by email to

If you are not sure of whether this is the correct behaviour, you can discuss this on the pythonvision mailing list

If at all possible, include a small image as a test case.


Version 0.2.3 (2012-06-8)

  • Fix imread_multi

Version 0.2.2 (2012-06-5)

  • Add formatstr argument to imread
  • Open files in binary mode on Windows (patch by Christoph Gohlke)
  • Read-only support for LSM files
  • Read-only support for XCF files (through xcf2png)
  • Fix writing of non-contiguous images (at least PNG was affected)

Version 0.2.1 (2012-02-11)

  • Add missing files to distribution

Version 0.2 (2012-03-19)

  • Compile on MSVC++ (Patches by Christoph Gohlke)
  • Support for WebP
  • Support for 1-bit TIFFs
  • Better error message
  • Support for multi-page TIFF reading
  • Experimental read-only support for STK files

Version 0.1 (2012-02-28)

  • Support for PNG
  • Support for TIFF
  • Support for JPEG

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for imread, version 0.2.3
Filename, size File type Python version Upload date Hashes
Filename, size imread-0.2.3.tar.gz (25.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page