isistools

Python-based review tools for ISIS3 coregistration workflows. Replaces Qmos and Qnet with modern, interactive visualization using HoloViews, Panel, and datashader.

Documentation

Installation

pip install isistools

For development:

git clone https://github.com/michaelaye/isistools.git
cd isistools
pip install -e ".[dev]"

Quick start

# Interactive footprint map in the browser
isistools footprints cubes.lis

# Export publication-ready PNG
isistools footprints cubes.lis --png --title "My Mosaic"

# Mosaic review with control network (Qmos replacement)
isistools mosaic cubes.lis --cnet control.net

# Tie point review (Qnet replacement)
isistools tiepoints cubes.lis control.net

# Batch footprintinit (parallel)
isistools footprintinit cubes.lis -j 8

# Control network summary
isistools cnet-info control.net

# Map-project a CTX cube with a CSM camera model (optional feature,
# replaces ISIS cam2map — see the csm2map docs chapter for install details)
isistools csm2map input.cub output.tif --map equi.map
isistools csm2map-compare isis.cub csm.tif

Note on csm2map: this is an optional subcommand that requires the [csm] extra plus a conda-forge CSM stack (ale, usgscsm, rasterio). It is not installed by default — users who only want the viewer tools don't pay the extra dependency cost. See the csm2map chapter for installation instructions, including an Apple Silicon gotcha where csmapi must be built from source.

Why?

ISIS's Qmos and Qnet have several pain points:

• Qmos requires level-1 images but displays footprints in map projection, and renders image content very slowly.
• Qnet requires level-2 images but displays them flipped in detector readout order.
• Both use a color scheme where registered control points are nearly invisible while unregistered points are prominent.

isistools fixes all of these. See the documentation for details on each command, the Python API, and example figures.

License

MIT