trilobite 1.0.0a1

TRansient Inference Library for Observation, Bayesian Inference, and Time-domain Exploration

---

The TRansient Inference Library for Observation, Bayesian Inference, and Time-domain Exploration (TRILOBITE) is a powerful, modular computational library for modeling the interaction of transient astrophysical outflows with their surrounding environments.

TRILOBITE bridges the gap between theory and observation by combining shock dynamics, microphysical prescriptions, and radiative transfer into a unified framework — enabling rapid-deployment modeling of GRBs, TDEs, supernovae, and other astrophysical transients.

Overview

What can it do?

• Customizable transient models — Pre-built models for GRBs, TDEs, and supernovae, fully configurable for your science case.

• Modular physics components — Mix-and-match dynamics, radiation, and opacity modules to build novel transient models from scratch.

• Flexible Bayesian inference — End-to-end parameter estimation pipelines for fitting models to radio and multi-wavelength data.

• Ecosystem integration — Native compatibility with astropy, emcee, and modern radio data formats.

Who is it for?

• Researchers modeling transient shock physics and radio emission

• Scientists building custom astrophysical forward models

• Observers looking to constrain explosion parameters from data

---

Quick Install

Install from PyPI:

pip install trilobite

Install from source:

git clone https://github.com/TransientsExtragalactic/Trilobite
cd Trilobite
pip install -e .

For full setup instructions, see the Installation Guide.

---

Documentation

The full documentation — user guides, API references, worked examples, and theory background — is available at:

https://transientsextragalactic.github.io/Trilobite

---

Contributing

Development takes place on GitHub.

Bug reports, feature requests, and documentation improvements are welcome via the issue tracker. Contributions should follow the established coding, documentation, and Conventional Commits style guidelines.

---

Citation

If you use Trilobite in your research, please acknowledge it with:

We acknowledge the use of the Trilobite software package, written by E. Diggins et al., in this work.

TRILOBITE is developed and maintained by Eliza Diggins and the Extragalactic Transients Group (TREX) in the Department of Astronomy at the University of California, Berkeley.

---