vMPT — visual MSA Planning Tool

Interactive Bokeh app for planning JWST/NIRSpec MSA observations directly on an image of the target field. vMPT combines:

  • Automated MSA pointing optimization — vmpt/optimizer.py is a lightweight Python module that searches (RA, Dec, V3 PA) for the best MSA pointing and roll angle. Inspired by hMPT (Z. Wu et al., CfA / Harvard), which is itself inspired by ESA’s eMPT (Bonaventura et al. 2023). The MSA shutter geometry, V2/V3 ↔ (s, d) coordinate mapping, and constraint machinery are independently implemented; the search algorithm (grid → differential-evolution refine) is a simpler version than hMPT’s. Three modes: Democracy (count), Meritocracy (Σ weight), Hierarchy (strict priority tiers).

  • Shutter-collision protection — mark high-priority targets whose spectra must not overlap any other source on the detector under the current Disperser / Filter. Slitlet-aware row buffer (v1.2.1+) reserves one row above and below each protected slitlet, including against stuck-open shutters.

  • Hand-picking + live conflict feedback — click any shutter to open an N-shutter slitlet, watch the orange spec-overlap layer light up in real time, undo / redo at will.

  • APT- / eMPT-ready export — write an MPT_plan.json + .cat bundle that loads straight into APT, plus the three CSVs that feed the eMPT pipeline.

  • Sharing — save the whole session as a JSON file, send it to a collaborator, and they pick up exactly where you left off.

Where to go next

Installation

pip install jwst-vmpt, or from source if you’re a developer.

Quick start

Load an example field, aim the MSA, pick shutters, export.

MSA pointing optimizer

Democracy / Meritocracy / Hierarchy + shutter-collision protection.

Catalogs

CSV / ASCII / FITS columns, multi-catalog stacking, weights, priorities.

Exporting & sharing

APT MPT plan, eMPT bundle, session JSON.

API reference

vmpt.optimizer, vmpt.msa, vmpt.wavelengths, …

Changelog

Release notes for every version.

Citation

If you use vMPT in a paper, please cite the underlying algorithms:

  • hMPT — Wu, Z. et al. (in prep); CfA/Harvard. Lightweight Python script for optimizing MSA pointing and roll angles, inspired by ESA’s eMPT (and the inspiration for vMPT’s own optimizer). https://github.com/zihaowu-astro/hMPT

  • eMPT — Bonaventura, N. et al. (2023), A&A 672, A40. ESA’s reference MSA Planning Tool pipeline.

vMPT itself is a free reimplementation that adds the visual hand-pick layer + shutter-collision protection on top.