Registry / data / large-image-source-nd2

large-image-source-nd2

library1.34.1pypypi✓ verified 84d ago

A tilesource for the large-image framework that reads ND2 (NIS Elements) files. Version 1.34.1, released May 2026, follows large-image releases about every 2-4 weeks.

data ai-ml

pip install large-image-source-nd2

github ↗package ↗

INSTALL

IMPORT

SIG · LARGE-IMAGE-SOURCE

large-image-source-nd2

datapythonv1.34.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ND2FileTileSource

✓ from large_image_source_nd2 import ND2FileTileSource

Correct import path from v1.0+

open

✓ from large_image_source_nd2 import open

Use open() function to open ND2 files

Open an ND2 file and get a tile at level 0, position (0,0).

from large_image_source_nd2 import open ts = open('path/to/file.nd2') print(ts.getMetadata()) tile = ts.getTile(0, 0, 0) print(tile.shape)

Debug

Known issues

gotchaND2 files can contain multiple channels and frames; use getMetadata() to inspect dimensions before accessing tiles.

fix

Always call ts.getMetadata() to get axes and sizes.

affects: all

breakingRequires Python >=3.10. Python 3.9 or earlier will fail to install.

fix

Upgrade to Python 3.10+.

affects: >=1.34.0

deprecatedSupport for Girder <5 is deprecated; future versions may drop compatibility.

fix

Upgrade Girder to 5+ or use large_image without Girder.

affects: >=1.34.1

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'nd2'

Missing dependency: nd2 library is not installed.

fix

pip install nd2

FileNotFoundError: [Errno 2] No such file or directory: 'path/to/file.nd2'

File path is incorrect or file does not exist.

fix

Verify the file path and ensure the file exists.

ValueError: Invalid ND2 file

The file is not a valid ND2 format or is corrupted.

fix

Use nd2 library directly to validate the file: from nd2 import ND2File; f = ND2File('file.nd2').

Upgrade

Version history

1.34.1latest on PyPI · released Mar 24, 2026

Audit

Dependencies

large-imagerequiredCore framework for the tilesource

nd2requiredPython library for reading ND2 files

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/girder/large_image ↗

packagehttps://pypi.org/project/large-image-source-nd2/ ↗