Skip to content
Python Image Sequence: Load video and sequential images in many formats with a simple, consistent interface.
Branch: master
Clone or download
nkeim Merge pull request #313 from caspervdw/pyavexporter
FIX: Fix PyAv exporter for newer pyav versions
Latest commit eda864a Nov 6, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
conda-recipe Fix (a really minor) typo Nov 10, 2016
doc ENH: Built-in as_grey pipeline Jul 2, 2018
examples fix example notebook a bit so that it works with current pims Jul 28, 2014
pims Merge pull request #313 from caspervdw/pyavexporter Nov 6, 2018
.gitattributes
.gitignore
.travis.yml
MANIFEST.in
README.md Add `nd2reader` as a reader: a Pure Python module for reading Nikon N… Jul 4, 2017
download_bioformats_test.py TST: Added 3 more filetypes Apr 9, 2015
license.txt
setup.cfg
setup.py
soft-matter-docs-deploy.enc
versioneer.py

README.md

pims: Python Image Sequence

build status

What Problem Does PIMS Solve?

Scientific video can be packaged in various ways: familiar video formats like .AVI and .MOV, folders full of numbered images, or "stacks" of TIFF images. Each of these requires a separate Python module. And, once loaded, they have different methods for accessing individual images, looping through the images in bulk, accessing a specific range, or dealing with multidimensional files. PIMS can do all of these using a consistent interface, handling the differences between different inputs invisibly.

Formats readable by pims include:

  • Directories or zipfiles of still images (most formats, including TIFF, JPEG, PNG, BMP), and TIFF stacks
  • Microscope images supported by the Bio-formats project, including Leica, Nikon, Olympus, and Zeiss formats. Requires separate installation; see below.
  • Movie formats and codecs supported by ffmpeg, including AVI, QuickTime MOV, and H.264 (MP4). May require separate installation; see below.
  • CINE files from Vision Research cameras
  • SEQ files from NorPix StreamPix software

PIMS is based on readers by:

  • scikit-image
  • matplotlib
  • scipy
  • ffmpeg and PyAV (video formats such as AVI, MOV)
  • jpype (interface with Bio-formats)
  • Pillow (improved TIFF support)
  • libtiff (alternative TIFF support)
  • tifffile (alterative TIFF support)
  • pims_nd2 (improved Nikon .nd2 support)
  • imageio (a multi-purpose reader package that reads and writes many formats)
  • moviepy (a Python module that supports video editing)
  • nd2reader (a Pure Python module for reading Nikon NIS Elements ND2 images and metadata)

Examples & Documentation

Everything is demonstrated in this IPython notebook.

Read the documentation for installation instructions, examples, and further reference.

Core Contributors

  • Daniel Allan founding contributor, slicing and iteration logic, basic readers, display tools
  • Thomas Caswell major refactor, abstract base class
  • Casper van der Wel bioformats readers, display tools
  • Thomas Dimiduk filetype-detecting dispatch logic

Support

This package was developed in part by Daniel Allan, as part of his PhD thesis work on microrheology in Robert L. Leheny's group at Johns Hopkins University in Baltimore, MD. The work was supported by the National Science Foundation under grant number CBET-1033985. Later work was supported by Brookhaven National Lab. Dan can be reached at dallan@bnl.gov.

This package was developed in part by Thomas A Caswell as part of his PhD thesis work in Sidney R Nagel's and Margaret L Gardel's groups at the University of Chicago, Chicago IL. This work was supported in part by NSF Grant DMR-1105145 and NSF-MRSEC DMR-0820054. Later work was supported by Brookhaven National Lab. Tom can be reached at tcaswell@gmail.com.

This package was developed in part by Casper van der Wel, as part of his PhD thesis work in Daniela Kraft's group at the Huygens-Kamerlingh-Onnes laboratory, Institute of Physics, Leiden University, The Netherlands. This work was supported by the Netherlands Organisation for Scientific Research (NWO/OCW).

You can’t perform that action at this time.