Skip to main content

Analytical tools for cryo-electron microscopy (stitching + napari validator).

Project description

PANDORICA

PANDORICA

Analytical tools for electron microscopy.

Bundled tools

  • pandorica.stitch — serial-section tomogram stitcher: MT-graph-driven alignment with an image-only fallback, diffeomorphism-guarded TPS warp, global pose solve, CPU/GPU volume export. Plain-language tour: HOW_IT_WORKS.md. Dense reference: pandorica/stitch/README.md.
  • pandorica.napari — napari plugin: visually validate the stitcher on real datasets and record coarse-alignment ground truth by hand.

Install

pip install pandorica                # core stitcher + CLI
pip install "pandorica[napari]"      # add the napari validator widgets

Use

python -m pandorica.stitch.cli <input_dir>
from pandorica.stitch.cli import run_stitch
run_stitch("path/to/sections")       # writes <input_dir>/stitched_output/

If tardis_em is also installed, the same entry point is exposed as the tardis_stitch console script.

Citation

If pandorica contributes to a publication or presentation, please cite the software:

@software{kiewisz_pandorica_2026,
  author  = {Kiewisz, Robert},
  title   = {pandorica: analytical tools for electron microscopy},
  year    = {2026},
  version = {1.0.3},
  url     = {https://github.com/RRobert92/pandorica},
  license = {PolyForm-Noncommercial-1.0.0}
}

Related prior work (scholarly context; not required by pandorica's license)

Pandorica's stitcher is a from-scratch Python reimplementation in the serial-section EM lineage; it does not include code from these projects. Citing them is a scholarly courtesy when positioning your work, not a legal obligation imposed by pandorica:

  • Lindow et al., Journal of Microscopy (2021), SerialSectionAligner — doi:10.1111/jmi.13039
  • Weber et al., PLoS ONE (2014), microtubulestitching

See pandorica/stitch/README.md for full author lists and the wider related-work list (IMOD, msemalign, Okapi-EM, …).

License

PolyForm Noncommercial License 1.0.0 — free for research, study, and use by educational, public-research, charitable, public-health, environmental, and government institutions, regardless of funding source. Commercial use requires a separate license; see COMMERCIAL.md to request one. Full terms in LICENSE.

Contributions require a Developer Certificate of Origin sign-off — see CONTRIBUTING.md.

Contact

Robert Kiewisz — robert.kiewisz@gmail.com

Project details


Download files

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

Source Distribution

pandorica-1.1.6.tar.gz (187.1 kB view details)

Uploaded Source

Built Distribution

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

pandorica-1.1.6-py3-none-any.whl (174.3 kB view details)

Uploaded Python 3

File details

Details for the file pandorica-1.1.6.tar.gz.

File metadata

  • Download URL: pandorica-1.1.6.tar.gz
  • Upload date:
  • Size: 187.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.0

File hashes

Hashes for pandorica-1.1.6.tar.gz
Algorithm Hash digest
SHA256 389b4d00419e7d175755cc6187cc1676b173915ccb80cc36ca5ebd20932c3850
MD5 861d7dfce5b7f01b68a5317ac457cad6
BLAKE2b-256 a9d5ce10c061a3c55dc1bc39ae3fb586110a48c910eac81284f53624b597a22f

See more details on using hashes here.

File details

Details for the file pandorica-1.1.6-py3-none-any.whl.

File metadata

  • Download URL: pandorica-1.1.6-py3-none-any.whl
  • Upload date:
  • Size: 174.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.0

File hashes

Hashes for pandorica-1.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 0a1e801804c35aae1e7b85e83b3cf89eb4079d9ffc5350bf1b24a03360e49cbb
MD5 f361361ea5a6945a192674d3b093f4a0
BLAKE2b-256 6f18b4c5965cf4ccfd57eecbbd45881d2848d4736439c32bd5888765ab41164e

See more details on using hashes here.

Supported by

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