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.0.3.tar.gz (140.0 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.0.3-py3-none-any.whl (134.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for pandorica-1.0.3.tar.gz
Algorithm Hash digest
SHA256 4a1120f74f0a51b32852a5cb1b8c06380a5eef1006ad9025d35721230cc0306a
MD5 d68ef5b7a67a1dd92f2e05b346b719b8
BLAKE2b-256 c6d843710a861dc17b8d7297171ad1b53a0e9d5c862795e6f9f34e2cb184b94a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pandorica-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 134.2 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.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 61919ae16c15cd7d191879348210a9c1e20240c30c9abc2d2962fe25c5a66ac1
MD5 a2794b652072f6d89862e3eedf818842
BLAKE2b-256 9156352053bb18fb0edb3195858798ddfcbffbf800cac61be65360c2142f018b

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