Metadata-Version: 2.4
Name: species
Version: 0.10.2.dev0
Summary: Toolkit for atmospheric characterization of directly imaged exoplanets
Author-email: Tomas Stolker <stolker@strw.leidenuniv.nl>
License-Expression: MIT
Project-URL: Documentation, https://species.readthedocs.io
Project-URL: Repository, https://github.com/tomasstolker/species
Project-URL: Issues, https://github.com/tomasstolker/species/issues
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Astronomy
Requires-Python: <3.14,>=3.11
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: astropy
Requires-Dist: dust-extinction
Requires-Dist: h5py
Requires-Dist: matplotlib
Requires-Dist: numba
Requires-Dist: numpy
Requires-Dist: pooch
Requires-Dist: scipy
Requires-Dist: spectres
Requires-Dist: tqdm
Requires-Dist: typeguard
Provides-Extra: full
Requires-Dist: astrodbkit2; extra == "full"
Requires-Dist: astroquery; extra == "full"
Requires-Dist: dynesty; extra == "full"
Requires-Dist: emcee; extra == "full"
Requires-Dist: molmass; extra == "full"
Requires-Dist: pandas; extra == "full"
Requires-Dist: PyMieScatt; extra == "full"
Requires-Dist: pymultinest; extra == "full"
Requires-Dist: requests; extra == "full"
Requires-Dist: schwimmbad; extra == "full"
Requires-Dist: shapely; extra == "full"
Requires-Dist: specutils; extra == "full"
Requires-Dist: SQLAlchemy; extra == "full"
Requires-Dist: ultranest; extra == "full"
Requires-Dist: xlrd; extra == "full"
Provides-Extra: docs
Requires-Dist: cython; extra == "docs"
Requires-Dist: jupyter; extra == "docs"
Requires-Dist: nbsphinx; extra == "docs"
Requires-Dist: pandoc; extra == "docs"
Requires-Dist: sphinx; extra == "docs"
Requires-Dist: sphinx-automodapi; extra == "docs"
Requires-Dist: sphinx_book_theme; extra == "docs"
Provides-Extra: test
Requires-Dist: black; extra == "test"
Requires-Dist: flake8; extra == "test"
Requires-Dist: pycodestyle; extra == "test"
Requires-Dist: pylint; extra == "test"
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Dynamic: license-file

*species*
=========

**spe**\ctral **c**\ haracterization and **i**\ nference for **e**\ xoplanet **s**\ cience

.. container::

    |PyPI Status| |Python Versions| |CI Status| |Docs Status| |Code Coverage| |Code Quality| |License|

*species* is a toolkit for atmospheric characterization of directly imaged exoplanets. It provides a coherent framework for spectral and photometric analysis which builds on publicly-available data and models from various resources.

There are tools available for retrieval of atmospheric and evolutionary parameters, synthetic photometry, interpolation of a variety atmospheric and evolutionary model grids, color-magnitude and color-color diagrams, empirical spectral analysis, spectral and photometric calibration, and analysis of emission lines. The package has been released on `PyPI <https://pypi.org/project/species/>`_ and is actively developed and maintained on `Github <https://github.com/tomasstolker/species>`_.

Documentation
-------------

Documentation can be found at `http://species.readthedocs.io <http://species.readthedocs.io>`_.

Tutorials
---------

There are several `Jupyter notebooks <https://species.readthedocs.io/en/latest/tutorials.html>`_ with tutorials for various types of analyses and functionalities.

Attribution
-----------

Please cite `Stolker et al. (2020) <https://ui.adsabs.harvard.edu/abs/2020A%26A...635A.182S/abstract>`_ whenever results from *species* are used in a publication. Please also make sure to give credit to the relevant papers regarding the use of the publicly available data that *species* benefits from.

Contributing
------------

Contributions are welcome so please consider `forking <https://help.github.com/en/articles/fork-a-repo>`_ the repository and creating a `pull request <https://github.com/tomasstolker/species/pulls>`_. Bug reports and feature requests can be provided by creating an `issue <https://github.com/tomasstolker/species/issues>`_ on the Github page.

License
-------

Copyright 2025 Tomas Stolker and `contributors <https://github.com/tomasstolker/species/graphs/contributors>`_.

*species* is distributed under the MIT License. See `LICENSE <https://github.com/tomasstolker/species/blob/main/LICENSE>`_ for the terms and conditions.

.. |PyPI Status| image:: https://img.shields.io/pypi/v/species
   :target: https://pypi.python.org/pypi/species

.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/species
   :target: https://pypi.python.org/pypi/species

.. |CI Status| image:: https://github.com/tomasstolker/species/actions/workflows/main.yml/badge.svg?branch=main
   :target: https://github.com/tomasstolker/species/actions/workflows/main.yml

.. |Docs Status| image:: https://img.shields.io/readthedocs/species
   :target: http://species.readthedocs.io

.. |Code Coverage| image:: https://codecov.io/gh/tomasstolker/species/branch/main/graph/badge.svg?token=LSSCPMJ5JH
   :target: https://codecov.io/gh/tomasstolker/species

.. |Code Quality| image:: https://img.shields.io/codefactor/grade/github/tomasstolker/species
   :target: https://www.codefactor.io/repository/github/tomasstolker/species

.. |License| image:: https://img.shields.io/github/license/tomasstolker/species
   :target: https://github.com/tomasstolker/species/blob/main/LICENSE
