Yet another nd2 (Nikon NIS Elements) file reader.

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for talley from gravatar.com talley

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: BSD License (BSD-3-Clause)
  • Author: Talley Lambert
  • Requires: Python <3.10, >=3.7
Classifiers

Project description

nd2

License PyPI Python Version Test codecov

Yet another .nd2 (Nikon NIS Elements) file reader.

This reader provides a Cython wrapper for the official Nikon SDK (currently version 1.7.0.0, released Jun 23, 2021).

Features good metadata retrieval, and direct to_dask and to_xarray options for lazy and/or annotated arrays.

It does not currently support legacy format nd2 files (JPEG_XL files starting with bytes 0x0000000c)

install

pip install nd2

(linux support coming but not yet ready)

usage

import nd2

# directly read file to numpy array:
my_array = nd2.imread('some_file.nd2')


# or open a file with ND2File
f = nd2.ND2File('some_file.nd2')

# attributes:   # example output
f.shape         # (10, 2, 256, 256)
f.ndim          # 4
f.dtype         # np.dtype('uint16')
f.axes          # 'TCYX'

# methods
f.pixel_size()  # (0.1, 0.1, 0.5) (x,y,z)
f.asarray()     # np.ndarray, greedy reader
f.to_dask()     # dask.array.Array, lazy reader
f.to_xarray()   # xr.DataArray, with labeled axes/coords

# metadata           # returns instance of ...
f.attributes()       # nd2.structures.Attributes
f.metadata()         # nd2.structures.Metadata
f.metadata(frame=3)  # nd2.structures.FrameMetadata
f.experiment()       # List[nd2.structures.ExpLoop]
f.text_info()        # dict of misc info

f.close()  # don't forget to close when done!

# ... or you can use it as a context manager
with nd2.ND2File('some_file.nd2') as ndfile:
    print(ndfile.metadata())
    xarr = ndfile.to_xarray(delayed=False)

issues

This is a work in progress (though working pretty well for most files!). If you have an nd2 file that errors or otherwise provides unexpected results, please open an issue and link to the file. I'd love to add it to the growing list of test files. (Note, if nd2._util.is_old_format('your.nd2') returns True, this is a legacy format that is not yet supported.)

alternatives

  • pims_nd2 - pims-based reader. also uses the SDK, (but uses version v9 from Apr 2016)
  • nd2reader - pims-based reader, using reverse-engineered file headers. mostly tested on NIS Elements 4.30.02
  • nd2file - another pure-python, chunk map reader, developed 2017

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for talley from gravatar.com talley

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: BSD License (BSD-3-Clause)
  • Author: Talley Lambert
  • Requires: Python <3.10, >=3.7
Classifiers

Release history Release notifications | RSS feed

0.10.1

0.10.0

0.9.0

0.8.1

0.8.0

0.7.4

0.7.3

0.7.2

0.7.1

0.7.0

0.6.1

0.6.0

0.5.3

0.5.2

0.5.1

0.5.0

0.4.6

0.4.5

0.4.4

0.4.3

0.4.2

0.4.1

0.4.0

0.3.0

0.2.5

0.2.4

0.2.3 yanked

Reason this release was yanked:

incorrect image loading

0.2.2

0.2.1

0.2.0

0.1.6

0.1.5

0.1.4

0.1.3

0.1.2

0.1.1

0.1.0

This version

0.0.1rc5 pre-release

0.0.1rc4 pre-release

0.0.1rc3 pre-release

0.0.1rc0 pre-release

Download files

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

Source Distribution

nd2-0.0.1rc5.tar.gz (5.3 MB view hashes)

Uploaded Source

Built Distributions

nd2-0.0.1rc5-cp39-cp39-win_amd64.whl (793.1 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

nd2-0.0.1rc5-cp39-cp39-manylinux_2_24_x86_64.whl (1.5 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.24+ x86-64

nd2-0.0.1rc5-cp39-cp39-macosx_10_9_x86_64.whl (1.1 MB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

nd2-0.0.1rc5-cp38-cp38-win_amd64.whl (793.2 kB view hashes)

Uploaded CPython 3.8 Windows x86-64

nd2-0.0.1rc5-cp38-cp38-manylinux_2_24_x86_64.whl (1.5 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.24+ x86-64

nd2-0.0.1rc5-cp38-cp38-macosx_10_9_x86_64.whl (1.1 MB view hashes)

Uploaded CPython 3.8 macOS 10.9+ x86-64

nd2-0.0.1rc5-cp37-cp37m-win_amd64.whl (791.8 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

nd2-0.0.1rc5-cp37-cp37m-manylinux_2_24_x86_64.whl (1.4 MB view hashes)

Uploaded CPython 3.7m manylinux: glibc 2.24+ x86-64

nd2-0.0.1rc5-cp37-cp37m-macosx_10_9_x86_64.whl (1.1 MB view hashes)

Uploaded CPython 3.7m macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page