Journal of Open Source Software 11, 10712·2026

Journal of Open Source Software 11, 10712JOSS 11, 10712·2026·S. Wu‡, N. Starkman, et al.S. Wu‡, N. Starkman, J. Nibauer, et al.S. Wu‡, N. Starkman, J. Nibauer, S. Pearson·Journal of Open Source Software 11, 10712JOSS 11, 10712·2026
Journal of Open Source Software 11, 10712JOSS 11, 10712·2026
Potamides is a JAX package that infers a galaxy’s mass distribution from the shapes of its stellar streams.
Potamides is a JAX package that infers a galaxy’s mass distribution from the shapes of its stellar streams. Instead of simulating a stream for every trial potential, it fits the observed track with splines and compares its curvature directly to the potential’s accelerations, covering the pipeline from annotating streams to evaluating likelihoods. Led by Sirui Wu.
Abstract
Potamides is a Python package for inferring the mass distribution of galaxies from the projected shapes of stellar streams in imaging data. Stellar streams are elongated structures produced when star clusters or dwarf galaxies are tidally disrupted by their host. Because their projected tracks carry information about the host's gravitational field, the local curvature of a stream can constrain the underlying potential. The package implements and extends the curvature-based likelihood framework of Nibauer et al. (2023). Rather than generating a full dynamical realization of a stellar stream for each trial model, Potamides represents observed stream tracks with JAX-based splines. It evaluates gravitational accelerations in candidate potentials and compares them directly to the local stream geometry. This provides a lower-cost inference workflow that complements traditional forward-modeling approaches. Potamides supports the complete analysis pipeline for a galaxy, from annotating stream ridge-lines to evaluating likelihoods across many potential models.















