pims: Python Image Sequence
=========================
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](https://www.openmicroscopy.org/site/support/bio-formats5.1/supported-formats.html), 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](http://scikit-image.org/)
* [ffmpeg](https://www.ffmpeg.org/) and [PyAV](http://mikeboers.github.io/PyAV/) (video formats such as AVI, MOV)
* [jpype](http://jpype.readthedocs.org/en/latest/) (interface with Bio-formats)
* [Pillow](http://pillow.readthedocs.org/en/latest/) (improved TIFF support)
* [tifffile](https://pypi.org/project/tifffile/) (alterative TIFF support)
* [pims_nd2](https://github.com/soft-matter/pims_nd2) (improved Nikon .nd2 support)
* [imageio](https://imageio.github.io) (a multi-purpose reader package that
reads and writes many formats)
* [moviepy](http://zulko.github.io/moviepy) (a Python module that supports
video editing)
* [nd2reader](https://github.com/rbnvrw/nd2reader) (a Pure Python module for reading Nikon NIS Elements ND2 images and metadata)
Examples & Documentation
------------------------
Everything is demonstrated in [this IPython notebook](http://nbviewer.ipython.org/github/soft-matter/pims/blob/main/examples/loading%20video%20frames.ipynb).
[**Read the documentation**](http://soft-matter.github.io/pims/) 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).
Raw data
{
"_id": null,
"home_page": "https://github.com/soft-matter/pims",
"name": "PIMS",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "PIMS Contributors",
"author_email": "dallan@pha.jhu.edu",
"download_url": "https://files.pythonhosted.org/packages/b8/02/5bf3639f5b77e9b183011c08541c5039ba3d04f5316c70312b48a8e003a9/pims-0.7.tar.gz",
"platform": null,
"description": "pims: Python Image Sequence\n=========================\n\nWhat Problem Does PIMS Solve?\n-----------------------------\n\nScientific video can be packaged in various ways: familiar video formats like\n.AVI and .MOV, folders full of numbered images, or \"stacks\" of TIFF images. Each\nof these requires a separate Python module. And, once loaded, they have\ndifferent methods for **accessing individual images, looping through the images\nin bulk, accessing a specific range, or dealing with multidimensional files**.\nPIMS can do all of these using a consistent interface, handling the differences\nbetween different inputs invisibly.\n\nFormats readable by pims include:\n* Directories or zipfiles of still images (most formats, including TIFF, JPEG, PNG, BMP), and TIFF stacks\n* Microscope images supported by the [Bio-formats project](https://www.openmicroscopy.org/site/support/bio-formats5.1/supported-formats.html), including Leica, Nikon, Olympus, and Zeiss formats. Requires separate installation; see below.\n* Movie formats and codecs supported by ffmpeg, including AVI, QuickTime MOV, and H.264 (MP4). May require separate installation; see below.\n* CINE files from Vision Research cameras\n* SEQ files from NorPix StreamPix software\n\nPIMS is based on readers by:\n* [scikit-image](http://scikit-image.org/)\n* [ffmpeg](https://www.ffmpeg.org/) and [PyAV](http://mikeboers.github.io/PyAV/) (video formats such as AVI, MOV)\n* [jpype](http://jpype.readthedocs.org/en/latest/) (interface with Bio-formats)\n* [Pillow](http://pillow.readthedocs.org/en/latest/) (improved TIFF support)\n* [tifffile](https://pypi.org/project/tifffile/) (alterative TIFF support)\n* [pims_nd2](https://github.com/soft-matter/pims_nd2) (improved Nikon .nd2 support)\n* [imageio](https://imageio.github.io) (a multi-purpose reader package that\n reads and writes many formats)\n* [moviepy](http://zulko.github.io/moviepy) (a Python module that supports\n video editing)\n* [nd2reader](https://github.com/rbnvrw/nd2reader) (a Pure Python module for reading Nikon NIS Elements ND2 images and metadata)\n\nExamples & Documentation\n------------------------\n\nEverything is demonstrated in [this IPython notebook](http://nbviewer.ipython.org/github/soft-matter/pims/blob/main/examples/loading%20video%20frames.ipynb).\n\n[**Read the documentation**](http://soft-matter.github.io/pims/) for\ninstallation instructions, examples, and further reference.\n\nCore Contributors\n-----------------\n\n * **Daniel Allan** founding contributor, slicing and iteration logic,\n basic readers, display tools\n * **Thomas Caswell** major refactor, abstract base class\n * **Casper van der Wel** bioformats readers, display tools\n * **Thomas Dimiduk** filetype-detecting dispatch logic\n\nSupport\n-------\n\nThis package was developed in part by Daniel Allan, as part of his\nPhD thesis work on microrheology in Robert L. Leheny's group at Johns Hopkins\nUniversity in Baltimore, MD. The work was supported by the National Science Foundation\nunder grant number CBET-1033985. Later work was supported by Brookhaven\nNational Lab. Dan can be reached at dallan@bnl.gov.\n\nThis package was developed in part by Thomas A Caswell as part of his\nPhD thesis work in Sidney R Nagel's and Margaret L Gardel's groups at\nthe University of Chicago, Chicago IL. This work was supported in\npart by NSF Grant DMR-1105145 and NSF-MRSEC DMR-0820054. Later work was\nsupported by Brookhaven National Lab. Tom can be\nreached at tcaswell@gmail.com.\n\nThis package was developed in part by Casper van der Wel, as part of his\nPhD thesis work in Daniela Kraft's group at the Huygens-Kamerlingh-Onnes laboratory,\nInstitute of Physics, Leiden University, The Netherlands. This work was\nsupported by the Netherlands Organisation for Scientific Research (NWO/OCW).\n",
"bugtrack_url": null,
"license": "BSD-3-clause",
"summary": "Python Image Sequence",
"version": "0.7",
"project_urls": {
"Homepage": "https://github.com/soft-matter/pims"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b8025bf3639f5b77e9b183011c08541c5039ba3d04f5316c70312b48a8e003a9",
"md5": "663b9b4f502678c255ef28cb23f6aab0",
"sha256": "55907a4c301256086d2aa4e34a5361b9109f24e375c2071e1117b9491e82946b"
},
"downloads": -1,
"filename": "pims-0.7.tar.gz",
"has_sig": false,
"md5_digest": "663b9b4f502678c255ef28cb23f6aab0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 87779,
"upload_time": "2024-06-10T19:20:42",
"upload_time_iso_8601": "2024-06-10T19:20:42.842119Z",
"url": "https://files.pythonhosted.org/packages/b8/02/5bf3639f5b77e9b183011c08541c5039ba3d04f5316c70312b48a8e003a9/pims-0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-10 19:20:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "soft-matter",
"github_project": "pims",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pims"
}
JSON
