STAMP

Stereological Tools for Analysis of Microstructural Parameters

STAMP is a scientific Python package for quantitative 2-D microstructural analysis. It provides tools to load grain or precipitate measurements, apply stereological corrections to recover 3-D size distributions, compute descriptive statistics with confidence intervals, and generate publication-ready figures.

New features follow a spec-driven development workflow — a written spec is agreed before any code is written, ensuring the API, algorithm, and test plan are correct by design. See CONTRIBUTING.md for details.

Modules

Installation

pip install nanoshot-stamp

To also install JupyterLab for running the example notebooks:

pip install "nanoshot-stamp[notebooks]"

Or with uv:

uv add "nanoshot-stamp[notebooks]"

Documentation

Full documentation is available at stamp.readthedocs.io.

Citation

If you use STAMP in your research, please cite it:

@software{westraadt_stamp_2026,
  author  = {Westraadt, Johan},
  title   = {STAMP: Stereological Tools for Analysis of Microstructural Parameters},
  year    = {2026},
  url     = {https://github.com/jwestraadt/STAMP},
  license = {MIT}
}

Or use GitHub's Cite this repository button (powered by CITATION.cff).

Contributing

Contributions are welcome! See CONTRIBUTING.md for details.

License

MIT — see LICENSE for details.