Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

An image reader for nd2 (NIS Elements) multidimensional images

Project description

build status

pims_nd2 contains a reader for nd2 files produced by NIS Elements. The reader is based on the included SDK from Nikon, which makes it compatible with older versions of nd2 files. The reader is written in the pims framework, enabling easy access to multidimensional files, lazy slicing, and nice display in IPython.

Installation

pims_nd2 is implemented on Windows, Linux and OSX systems. To obtain the latest stable version, install via PyPi:

pip install pims_nd2

The ND2 SDK binaries are included in the package and will be copied into the pims_nd2 package folder.

Dependencies

This reader requires pims version 0.3.0.

Examples

The following code opens a movie file and displays a frame. Note that frames are only actually read when necessary:

from pims import ND2_Reader
frames = ND2_Reader('some_movie.nd2')
frames[82]  # display frame 82
frames.close()

The following code opens the multidimensional demo file included in the package and iterates through the first 3 frames. Note that we use a context manager here. We tell the reader which axis to iterate over and which axes to include in one frame. Also we select which channel to read.

from pims import ND2_Reader
with ND2_Reader('cluster.nd2') as frames:
    frames.iter_axes = 't'  # 't' is the default already
    frames.bundle_axes = 'zyx'  # when 'z' is available, this will be default
    frames.default_coords['c'] = 1  # 0 is the default setting
    for frame in frames[:3]:
        # do something with 3D frames in channel 1

The best way to use the reader is using a context manager. If you do not use a context manager, make sure to call frames.close() at the end of your script.

Metadata access can be done on two levels: reader level and frame level.

frames.metadata['mpp']  # calibration in microns per pixel
frames[0].metadata['t_ms']  # time of frame in milliseconds

Supporting Grant

This reader was developed 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).

Project details


Release history Release notifications

This version
History Node

1.0

History Node

0.4

History Node

0.3

History Node

0.2

History Node

0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
pims_nd2-1.0.zip (19.8 MB) Copy SHA256 hash SHA256 Source None Nov 25, 2015

Supported by

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