Metadata-Version: 2.4
Name: spotter
Version: 0.0.9
Summary: Approximate forward models of fluxes and spectra time-series of non-uniform stars.
Author: Lionel Garcia, Benjamin Rackham
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: equinox
Requires-Dist: healpy
Requires-Dist: jax
Requires-Dist: jaxlib
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: tinygp
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: ipykernel; extra == 'dev'
Requires-Dist: matplotlib; extra == 'dev'
Requires-Dist: nox; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Provides-Extra: docs
Requires-Dist: arviz; extra == 'docs'
Requires-Dist: corner; extra == 'docs'
Requires-Dist: docutils; extra == 'docs'
Requires-Dist: ipykernel; extra == 'docs'
Requires-Dist: ipywidgets; extra == 'docs'
Requires-Dist: jaxoplanet; extra == 'docs'
Requires-Dist: jaxopt; extra == 'docs'
Requires-Dist: jupyterlab; extra == 'docs'
Requires-Dist: matplotlib; extra == 'docs'
Requires-Dist: myst-nb; extra == 'docs'
Requires-Dist: myst-parser; extra == 'docs'
Requires-Dist: numpyro-ext; extra == 'docs'
Requires-Dist: sphinx; extra == 'docs'
Requires-Dist: sphinx-autoapi<3.2.0; extra == 'docs'
Requires-Dist: sphinx-book-theme; extra == 'docs'
Requires-Dist: sphinx-copybutton; extra == 'docs'
Requires-Dist: toml; extra == 'docs'
Provides-Extra: test
Requires-Dist: jaxoplanet>=0.1.0; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-xdist; extra == 'test'
Description-Content-Type: text/markdown

# spotter

<p align="center">
    <img src="https://spotter.readthedocs.io/en/latest/_static/spotter.png" width="270">
</p>

<p align="center">
Approximate forward models of fluxes and spectra time-series of non-uniform stars
  <br>
  <p align="center">
    <a href="https://github.com/lgrcia/spotter">
      <img src="https://img.shields.io/badge/github-lgrcia/spotter-white.svg?style=flat" alt="github"/></a>
    <a href="LICENCE">
      <img src="https://img.shields.io/badge/license-MIT-lightgray.svg?style=flat" alt="license"/>
    </a>
  </p>
</p>

*spotter* serves as a flexible, low-level backend for scientific applications that require modeling stellar surfaces using spherical pixelation. While it is not a comprehensive simulation suite like [StarSim](https://ui.adsabs.harvard.edu/abs/2016A&A...586A.131H/abstract) or [SOAP](https://ui.adsabs.harvard.edu/abs/2014ApJ...796..132D/abstract), *spotter* provides core building blocks for custom workflows, including:
- Modeling [surface features](https://spotter.readthedocs.io/en/latest/notebooks/introduction/) (e.g., stellar spots or faculae) with arbitrary shapes
- Forward modeling of stellar surface [flux](https://spotter.readthedocs.io/en/latest/notebooks/multiband/), [spectra](https://spotter.readthedocs.io/en/latest/notebooks/spectral/), [radial velocities](https://spotter.readthedocs.io/en/latest/notebooks/rv/), and CCFs
- Simulation of [observables during transits](https://spotter.readthedocs.io/en/latest/notebooks/spot_crossing/) by stellar or planetary companions
- Gaussian process frameworks for representing [stellar surfaces](https://spotter.readthedocs.io/en/latest/notebooks/surface_gp/) and [modeling their flux time series](https://spotter.readthedocs.io/en/latest/notebooks/flux_gp/)

*spotter* uses the [HEALPix](https://healpix.sourceforge.io/) subdivision scheme and is powered by the high-performance numerical package [JAX](https://jax.readthedocs.io/en/latest/https://spotter.readthedocs.io/en/latest/notebooks/quickstart.html), enabling its use on multiple CPUs and accelerators like GPUs and TPUs.

Documentation can be found at [spotter.readthedocs.io](https://spotter.readthedocs.io)

## Installation

To install *spotter* from pypi
    
```bash
pip install spotter
```

To get the latest version under development, clone the repository and install the package using pip:

```bash
git clone https://github.com/lgrcia/spotter
pip install -e spotter
```