skillfed

PIMS

Python Image Sequence

pims v0.7 184.6K downloads/30d#10,028 on PyPI275
Permissive license BSD-3-clause AGING released

What it is and what it does

PIMS abstracts away the complexity of reading scientific video and image data in many different formats. Instead of learning separate libraries for AVI files, TIFF stacks, Nikon microscope images, and numbered image sequences, you use a single consistent interface. It handles the format detection, loading, and frame access transparently, letting you focus on your image analysis rather than file I/O plumbing.

The package is built on top of established libraries like imageio, numpy, tifffile, and optional integrations with ffmpeg and Bio-formats. It supports video formats (AVI, MOV, MP4), image stacks (TIFF, JPEG, PNG), microscope vendor formats (Leica, Nikon, Olympus, Zeiss), and specialized camera formats (CINE, SEQ). You can slice frames, iterate in bulk, access specific ranges, and work with multidimensional data using the same API regardless of source.

Use it for:

  • Load and iterate through frames from a microscopy experiment stored as a TIFF stack or vendor-specific format without learning format-specific APIs.
  • Process video files (AVI, MOV, MP4) frame-by-frame in a scientific analysis pipeline using a consistent interface.
  • Build batch image processing workflows that accept multiple input formats and automatically detect and read them.
  • Access specific frame ranges or multidimensional slices from large image sequences without loading entire files into memory.
  • Prototype image analysis code that needs to work with both video files and numbered image directories interchangeably.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

PIMS provides a unified interface to read scientific video and image sequences from diverse formats—video files, image stacks, microscope formats, and numbered image directories—using consistent methods for accessing, slicing, and iterating through frames.

Yes, if you work with scientific video or microscopy images in multiple formats and want to avoid format-specific boilerplate. The aging maintenance status (last release 795 days ago) and high install friction mean it's best for established workflows where the dependency chain is already stable. No known vulnerabilities. Not recommended for new projects unless you specifically need multi-format support.

Install

pims on PyPI

pip

pip install pims

uv

uv add pims

poetry

poetry add pims

Installing PIMS

Before you install

High install friction due to five runtime dependencies including imageio, numpy, and tifffile. Maintenance is aging—last release was 795 days ago (June 2024), though the repository remains active with a recent commit in March 2025. Suitable for established workflows rather than new projects.

License in practice

BSD-3-clause permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart

pip install pims
import pims
frames = pims.open('video.avi')
for frame in frames:
    print(frame.shape)

Requires numpy and imageio; optional support for additional formats (ffmpeg, Bio-formats, Nikon .nd2) needs separate installation.

Verify before relying

  • Whether Bio-formats and ffmpeg optional dependencies are straightforward to install on common systems
  • Current state of support for modern microscope formats beyond those listed in the description

Package facts

License BSD-3-clause (permissive)
Python support supports the current Python release (>=3.7)
Install friction high — source build required
Runtime dependencies 5 — imageio, numpy, packaging, slicerator, tifffile
Maintenance aging — 795 days since the last release
Last repo commit
First released
Downloads 184,643/month — #10,028 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: pims-0.7.tar.gz

Development Status :: 4 - BetaProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9

Tags

read video frames pythonimage sequence loaderscientific microscopy imagestiff stack readervideo file interfaceframe iteration librarymulti-format image reader
microscopyvideo-processingimage-io

More Information Analysis packages