drpangloss

The best of all possible interferometry models.

Contributors: Dori Blakely, Benjamin Pope

What is drpangloss?

drpangloss is a package for modelling optical interferometry data in JAX.

Installation

drpangloss is hosted on PyPI; the easiest way to install it is:

pip install drpangloss

You can also build from source. To do so, clone the git repo, enter the directory, and run

pip install .

We recommend using a virtual environment to avoid dependency conflicts.

Using uv (recommended):

uv python install 3.11
uv venv --python 3.11 .venv
uv pip install --python .venv/bin/python -e . pytest
uv run --python .venv/bin/python pytest -q

Use & Documentation

Documentation is published at benjaminpope.github.io/drpangloss.

Documentation tooling is currently migrating from MkDocs to Zensical. During this transition, both builders are supported from the same configuration file.

Local docs checks:

uv run --python .venv/bin/python mkdocs build --strict
uv run --python .venv/bin/python zensical build --clean

Collaboration & Development

We welcome collaboration and development contributions. See CONTRIBUTING.md for development setup, testing, and pull request workflow.

Current modernization priorities are tracked in REVIEW_NOTES.md and docs/review_2026-03-03.md.

Name

Why is it called drpangloss?

The leading optical interferometry model fitting code is CANDID. In Voltaire's Candide, Dr Pangloss' belief that we live in the best of all possible worlds is a satire of Leibniz' theodicy. But we do live in a world with Jax, so that if we can't optimize the world, at least we can optimize our fits to VLTI data.