nd2-rs 0.1.3

Pure Rust library for reading Nikon ND2 microscopy files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

# nd2-rs

Pure Rust library for reading Nikon ND2 microscopy files (v2.0, v2.1, v3.0).

## Installation

```toml
[dependencies]
nd2-rs = "0.1"
```

## Usage

```rust
use nd2_rs::{Nd2File, Result};

fn main() -> Result<()> {
    let mut nd2 = Nd2File::open("image.nd2")?;
    let sizes = nd2.sizes()?;
    let pixels = nd2.read_frame_2d(0, 0, 0, 0)?;
    let frame = nd2.read_frame(12)?; // sequence index
    Ok(())
}
```

## CLI

```bash
nd2-rs info image.nd2
```

`info` prints concise dataset shape JSON:

```json
{
  "positions": 132,
  "frames": 181,
  "channels": 3,
  "height": 2044,
  "width": 2048
}
```

`frame` supports writing a single channel to 16-bit TIFF by sequence or by `(p, t, c, z)`.

## Error reporting

`Nd2Error` is now grouped by source:
- `File` for malformed/invalid file contents
- `Input` for user-provided indices and arguments
- `Internal` for internal arithmetic/logic issues
- `Unsupported` for unsupported ND2/CLX variants

## Docs

- [DATASTRUCTURE.md](DATASTRUCTURE.md) – format details and parsing

## References

Inspired by the Python [nd2 library](https://github.com/tlambert03/nd2).

## License

MIT OR Apache-2.0