toolsandogh

A Python toolbox for iSCAT microscopy data analysis, developed by the Sandoghdar Division of the Max Planck Institute for the Science of Light (MPL).

Overview

toolsandogh provides a small, reusable library for loading, processing, analyzing, and storing microscopy videos. It is designed around a canonical 5D data model---T (time), C (channel), Z (slice), Y (row), X (column)---implemented as lazy xarray arrays backed by Dask.

Features

  • Lazy, out-of-core computation: Videos are kept as Dask arrays so you can work with datasets larger than memory.
  • Labeled, metadata-rich arrays: Results are xarray.DataArray objects with TCZYX dimensions and OME metadata.
  • Multiple microscopy formats: Read and write RAW/BIN, TIFF, OME-TIFF, OME-Zarr, ND2, and other formats supported by bioio.
  • Reusable analysis primitives: Rolling statistics, radial variance transform, synthetic data generation, and more.

Installation

This project uses the uv package manager. Clone the repository and run:

uv sync

To install in editable mode for development:

uv pip install -e ".[dev]"

Quick start

import toolsandogh as sand

# Load a video (any bioio-supported format or raw BIN/RAW file).
video = sand.load_video("movie.nd2")

# Apply a rolling average along the time axis.
smoothed = sand.rolling_average(video, window_size=5, dim="T")

# Save the result back to disk.
sand.store_video(smoothed, "smoothed.ome.tiff")

Use help(sand.load_video) or help(sand.store_video) for details on the available arguments.

Repository layout

  • src/toolsandogh/ --- the main Python package.
  • src/toolsandogh/tests/ --- pytest test suite.
  • DESIGN.md --- design conventions and coding standards.

Contributing

Please see DESIGN.md for coding conventions, documentation standards, and architecture decisions. In brief:

  • All public functions must be type-hinted and documented in numpydoc style.
  • Code is linted with ruff and type-checked with pyright.
  • Prefer free functions; keep data in xarray.DataArray/Dataset form.
  • Tests go in src/toolsandogh/tests/.

License

GPL-3.0-or-later.

Project links

Data verified by PyPI on Jul 10, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.5.4)

2 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for marcoheisig from gravatar.com marcoheisig Avatar for sandoghdarlab from gravatar.com sandoghdarlab

Credits

Author: Marco Heisig

GitHub Statistics

Data verified by PyPI on Jul 10, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

GPL-3.0-or-later
View SPDX License List

Requires

Python >=3.12

Tags

tools utilities python microscopy

Report project as malware

Download files

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

Source Distribution

toolsandogh-0.3.3.tar.gz (278.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

toolsandogh-0.3.3-py3-none-any.whl (81.8 kB view details)

Uploaded Python 3

File details

Details for the file toolsandogh-0.3.3.tar.gz.

File metadata

  • Download URL: toolsandogh-0.3.3.tar.gz
  • Upload date:
  • Size: 278.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for toolsandogh-0.3.3.tar.gz
Algorithm Hash digest
SHA256 445913391923acfca820d089851956b2f37b1803e5e0f27da216de3095bd81a8
MD5 500f9a4447f497513e825b888e7a5189
BLAKE2b-256 4862117687eb24700adbe6914826b51ac25a1022cc184bb2a77628af7be56bab

See more details on using hashes here.

Provenance

The following attestation bundles were made for toolsandogh-0.3.3.tar.gz:

Publisher: release.yml on SandoghdarLab/toolsandogh

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file toolsandogh-0.3.3-py3-none-any.whl.

File metadata

  • Download URL: toolsandogh-0.3.3-py3-none-any.whl
  • Upload date:
  • Size: 81.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for toolsandogh-0.3.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3ebc5c195241cb70045bd942c3b65c03fa144a53fddec84e791b3465c735d184
MD5 7c96c55d930c69392491a7fe4a9dd81f
BLAKE2b-256 d4ebdd8f323cccd778b56c9e97be7ee1f2deabcc7048674c1273186df667f139

See more details on using hashes here.

Provenance

The following attestation bundles were made for toolsandogh-0.3.3-py3-none-any.whl:

Publisher: release.yml on SandoghdarLab/toolsandogh

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.5.4

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

This release

0.3.3 This release

2 files

0.3.2

2 files

0.3.1

2 files

0.2.0

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3.1

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page