Metadata-Version: 2.4
Name: trilobite
Version: 1.0.0a1
Summary: TRansient Inference Library for Observation, Bayesian Inference, and Time-domain Exploration
Author-email: Eliza Diggins <eliza.diggins@berkeley.edu>
License: GPL-3.0-or-later
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
Requires-Dist: numpy>=1.26
Requires-Dist: unyt>=2.9
Requires-Dist: h5py>=3.0
Requires-Dist: scipy>=1.10
Requires-Dist: matplotlib
Requires-Dist: tqdm
Requires-Dist: platformdirs
Requires-Dist: ruamel.yaml
Requires-Dist: emcee
Requires-Dist: corner
Requires-Dist: astropy
Provides-Extra: mpi
Requires-Dist: mpi4py>=3.0; extra == "mpi"
Provides-Extra: optical
Requires-Dist: speclite>=0.17; extra == "optical"
Requires-Dist: astroquery>=0.4.6; extra == "optical"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: pre-commit; extra == "dev"
Requires-Dist: jupyter; extra == "dev"
Provides-Extra: docs
Requires-Dist: astroquery>=0.4.6; extra == "docs"
Requires-Dist: alabaster>=1.0.0; extra == "docs"
Requires-Dist: matplotlib>=3.9.2; extra == "docs"
Requires-Dist: myst-parser>=4.0.0; extra == "docs"
Requires-Dist: pydata-sphinx-theme>=0.15.2; extra == "docs"
Requires-Dist: nbsphinx>=0.9.5; extra == "docs"
Requires-Dist: jupyter>=1.1.1; extra == "docs"
Requires-Dist: sphinx>=8.1.3; extra == "docs"
Requires-Dist: sphinx_design>=0.6.1; extra == "docs"
Requires-Dist: sphinx-gallery>=0.19.0; extra == "docs"
Requires-Dist: sphinx-plot-directive>=1.0.5; extra == "docs"
Requires-Dist: sphinxcontrib-applehelp>=2.0.0; extra == "docs"
Requires-Dist: sphinxcontrib-bibtex>=2.6.3; extra == "docs"
Requires-Dist: sphinxcontrib-devhelp>=2.0.0; extra == "docs"
Requires-Dist: sphinxcontrib-htmlhelp>=2.1.0; extra == "docs"
Requires-Dist: sphinxcontrib-jsmath>=1.0.1; extra == "docs"
Requires-Dist: sphinxcontrib-qthelp>=2.0.0; extra == "docs"
Requires-Dist: sphinxcontrib-serializinghtml>=2.0.0; extra == "docs"
Requires-Dist: sphinxcontrib-tikz>=0.4.20; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Requires-Dist: numpydoc; extra == "docs"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-xdist; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: hypothesis; extra == "test"

.. image:: https://raw.githubusercontent.com/TransientsExtragalactic/Trilobite/main/docs/source/images/logo.svg
   :width: 260px
   :align: center
   :alt: Trilobite

|Tests| |docs| |docs-stable| |RUFF| |PRE-COMMIT| |ISORT| |NUMPYDOC| |DOCFORMATTER| |COMMITIZEN| |CONVENTIONAL-COMMITS| |ASTROPY| |CONTRIBUTORS| |LAST-COMMIT|

----

The **TR**\ansient **I**\nference **L**\ibrary for **O**\bservation, **B**\ayesian **I**\nference, and **T**\ime-domain **E**\xploration
(**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:

.. code-block:: bash

    pip install trilobite

Install from source:

.. code-block:: bash

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

For full setup instructions, see the
`Installation Guide <https://transientsextragalactic.github.io/Trilobite/getting_started/installation.html>`_.

----

Documentation
=============

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

    `https://transientsextragalactic.github.io/Trilobite <https://transientsextragalactic.github.io/Trilobite>`_

----

Contributing
============

Development takes place on
`GitHub <https://github.com/TransientsExtragalactic/Trilobite>`_.

Bug reports, feature requests, and documentation improvements are welcome via the issue tracker.
Contributions should follow the established coding, documentation, and
`Conventional Commits <https://www.conventionalcommits.org/en/v1.0.0/>`_ 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**.

----

.. |Tests| image:: https://github.com/TransientsExtragalactic/Trilobite/actions/workflows/run_tests.yml/badge.svg
   :target: https://github.com/TransientsExtragalactic/Trilobite/actions/workflows/run_tests.yml
   :alt: Tests

.. |docs| image:: https://img.shields.io/badge/docs-latest-brightgreen.svg
   :target: https://transientsextragalactic.github.io/Trilobite
   :alt: Latest Docs

.. |docs-stable| image:: https://img.shields.io/badge/docs-stable-brightgreen.svg
   :target: https://transientsextragalactic.github.io/Trilobite/stable
   :alt: Stable Docs

.. |ruff| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
   :target: https://github.com/astral-sh/ruff
   :alt: Ruff

.. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit
   :target: https://github.com/pre-commit/pre-commit
   :alt: pre-commit

.. |numpydoc| image:: https://img.shields.io/badge/docstyle-numpydoc-459db9
   :target: https://numpydoc.readthedocs.io/en/latest/
   :alt: Docstring style: numpydoc

.. |commitizen| image:: https://img.shields.io/badge/commitizen-friendly-brightgreen.svg
   :target: https://commitizen-tools.github.io/commitizen/
   :alt: Commit style: Conventional + Gitmoji

.. |conventional-commits| image:: https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white
   :target: https://www.conventionalcommits.org/en/v1.0.0/
   :alt: Commit style: Conventional Commits

.. |contributors| image:: https://img.shields.io/github/contributors/TransientsExtragalactic/Trilobite?cacheSeconds=86400
   :target: https://github.com/TransientsExtragalactic/Trilobite/graphs/contributors
   :alt: GitHub Contributors

.. |last-commit| image:: https://img.shields.io/github/last-commit/TransientsExtragalactic/Trilobite?cacheSeconds=86400
   :target: https://github.com/TransientsExtragalactic/Trilobite
   :alt: Last Commit

.. |ASTROPY| image:: http://img.shields.io/badge/powered%20by-AstroPy-orange.svg?style=flat
   :target: http://www.astropy.org/
   :alt: Powered by Astropy

.. |docformatter| image:: https://img.shields.io/badge/%20formatter-docformatter-fedcba
   :target: https://github.com/PyCQA/docformatter
   :alt: docformatter

.. |isort| image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat&labelColor=ef8336
   :target: https://pycqa.github.io/isort/
   :alt: isort
