Metadata-Version: 2.4
Name: astro-elisa
Version: 0.2.2
Summary: Efficient library for spectral analysis in high-energy astrophysics.
Project-URL: Documentation, https://github.com/wcxve/elisa#readme
Project-URL: Issues, https://github.com/wcxve/elisa/issues
Project-URL: Source, https://github.com/wcxve/elisa
Author-email: Wang-Chen Xue <wcxuemail@gmail.com>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
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: Topic :: Scientific/Engineering :: Astronomy
Classifier: Typing :: Typed
Requires-Python: <3.14,>=3.10
Requires-Dist: arviz~=0.22.0
Requires-Dist: astropy<7.2,>=5.3
Requires-Dist: blackjax==1.3
Requires-Dist: corner~=2.2.2
Requires-Dist: dill~=0.4.0
Requires-Dist: emcee~=3.1.6
Requires-Dist: h5py<3.16,>=3.14
Requires-Dist: iminuit<2.33,>=2.31.1
Requires-Dist: jax<=0.7.0,>=0.4.35
Requires-Dist: jaxns~=2.6.9
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: multiprocess~=0.70.18
Requires-Dist: nautilus-sampler~=1.0.5
Requires-Dist: numpy>=1.24.1
Requires-Dist: numpyro<0.20,>=0.16.1
Requires-Dist: optimistix~=0.0.10
Requires-Dist: prettytable<3.18,>=3.12.0
Requires-Dist: quadax<0.3,>=0.2.6
Requires-Dist: scipy<1.17,>=1.11.1
Requires-Dist: seaborn~=0.13.2
Requires-Dist: tinygp~=0.3.0
Requires-Dist: tqdm~=4.67
Requires-Dist: ultranest~=4.4.0
Requires-Dist: zeus-mcmc~=2.5.4
Provides-Extra: dev
Requires-Dist: pre-commit~=4.0; extra == 'dev'
Requires-Dist: ruff>=0.12.0; extra == 'dev'
Provides-Extra: docs
Requires-Dist: ipywidgets; extra == 'docs'
Requires-Dist: jupyter; extra == 'docs'
Requires-Dist: jupyterlab-widgets; extra == 'docs'
Requires-Dist: myst-nb; extra == 'docs'
Requires-Dist: numba; extra == 'docs'
Requires-Dist: numpydoc; extra == 'docs'
Requires-Dist: pydata-sphinx-theme; extra == 'docs'
Requires-Dist: sphinx-autodoc-typehints; extra == 'docs'
Requires-Dist: sphinx-codeautolink; extra == 'docs'
Requires-Dist: sphinx-copybutton; extra == 'docs'
Requires-Dist: sphinx-design; extra == 'docs'
Requires-Dist: sphinx>=7.4.0; extra == 'docs'
Requires-Dist: widgetsnbextension; extra == 'docs'
Provides-Extra: test
Requires-Dist: coverage[toml]<7.13,>=7.8; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-xdist; extra == 'test'
Provides-Extra: xspec
Requires-Dist: xspex~=0.1.1; extra == 'xspec'
Description-Content-Type: text/markdown

# ELISA: Efficient Library for Spectral Analysis in High-Energy Astrophysics

[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/astro-elisa?color=blue&logo=Python&logoColor=white&style=for-the-badge)](https://pypi.org/project/astro-elisa)
[![PyPI - Version](https://img.shields.io/pypi/v/astro-elisa?color=blue&logo=PyPI&logoColor=white&style=for-the-badge)](https://pypi.org/project/astro-elisa)
[![License: GPL v3](https://img.shields.io/github/license/wcxve/elisa?color=blue&logo=open-source-initiative&logoColor=white&style=for-the-badge)](https://www.gnu.org/licenses/gpl-3.0)<br>
[![Coverage Status](https://img.shields.io/codecov/c/github/wcxve/elisa?logo=Codecov&logoColor=white&style=for-the-badge)](https://app.codecov.io/github/wcxve/elisa)
[![Documentation Status](https://img.shields.io/readthedocs/astro-elisa?logo=Read-the-Docs&logoColor=white&style=for-the-badge)](https://astro-elisa.readthedocs.io/en/latest/?badge=latest)

``ELISA`` aims to provide a modern and efficient tool to explore and
analyze the spectral data. It is designed to be user-friendly and flexible.
The key features of ``ELISA`` include:

- **Ease of Use**: Simple and intuitive interfaces
- **Robustness**: Utilizing the state-of-the-art algorithm to fit, test, and
  compare models
- **Performance**: Efficient computation backend based
  on [JAX](https://jax.readthedocs.io/en/latest/notebooks/quickstart.html)
- ...

**NOTE**: ``ELISA`` is currently under active development. Please be aware of
potential brittleness, bugs, and changes to the API as the design evolves.

-----

**Table of Contents**

- [Installation](#installation)
- [Documentation](#documentation)
- [License](#license)

## Installation

### Stable Version

It is recommended to install ``ELISA`` in a new [
``conda``](https://docs.conda.io/projects/conda/en/stable/user-guide/getting-started.html)
environment as follows:

1. Create a new ``conda`` environment. The following command creates a new
   environment named "elisa" with ``Python`` 3.11:

    ```console
    conda create -n elisa python=3.11
    ```

   Note that you can customize the environment name to your preference,
   and the ``Python`` version should range from 3.10 to 3.13.

2. Activate the environment we just created:

    ```console
    conda activate elisa
    ```

3. Install ``ELISA`` using ``pip``:

    ```console
    pip install astro-elisa
    ```

## Use ``XSPEC`` Models

If you want to use models
from [XSPEC](https://heasarc.gsfc.nasa.gov/xanadu/xspec/manual/Models.html),
make sure ``HEASoft`` and ``XSPEC v12.12.1+`` are installed on your system,
and the ``HEASoft`` environment is initialized, then use the following
command to install [``xspex``](https://github.com/wcxve/xspex):

   ```console
   pip install xspex
   ```

For more details, see the
corresponding [API docs](https://astro-elisa.readthedocs.io/en/stable/apidoc/elisa.models.xs.html).

### Development Version

The latest version of ``ELISA`` can be installed by the following command:

   ```console
   pip install -U git+https://github.com/wcxve/elisa.git
   ```

## Documentation

Read the documentation at: https://astro-elisa.readthedocs.io

## License

`ELISA` is distributed under the terms of
the [GPL-3.0](https://www.gnu.org/licenses/gpl-3.0-standalone.html) license.
