Metadata-Version: 2.5
Name: pyExtinction
Version: 2.1
Summary: Atmospheric extinction, from Buton et al. 2013A&A...549A...8B
Project-URL: repository, https://gitlab.in2p3.fr/ycopin/pyExtinction
Project-URL: documentation, https://ycopin.pages.in2p3.fr/pyExtinction
Project-URL: rtfd, https://pyextinction.readthedocs.io/en/latest/
Author-email: Clément Buton <c.buton@araiko.ai>, Yannick Copin <y.copin@ip2i.in2p3.fr>
Maintainer-email: Yannick Copin <y.copin@ipnl.in2p3.fr>
License-Expression: CECILL-C
License-File: LICENSE.txt
Requires-Python: >=3.10
Requires-Dist: astropy>=6
Requires-Dist: matplotlib>=3
Requires-Dist: numpy>=2
Requires-Dist: scipy>=1
Description-Content-Type: text/x-rst

======================================================================
                     pyExtinction's documentation
======================================================================

:Authors: Clément Buton, Yannick Copin
:Contact: Yannick Copin <y.copin@ip2i.in2p3.fr>
:Copyright: 2012-present, Clément Buton, Yannick Copin

.. image:: https://img.shields.io/badge/ascl-1403.002-blue.svg?colorB=262255
   :target: http://ascl.net/1403.002
   :alt: ascl:1403.002

.. image:: https://img.shields.io/pypi/v/pyExtinction
   :target: https://pypi.org/project/pyextinction
   :alt: pypi version

.. image:: https://readthedocs.org/projects/pyextinction/badge/?version=latest
   :target: http://pyextinction.readthedocs.org/en/latest/?badge=latest
   :alt: pyExtinction Documentation Status

Introduction
============

This Python module/script computes total atmospheric extinction from
decomposition into physical components (Rayleigh attenuation, ozone absorption,
aerosol extinction), as described in `Buton et al. (2013)
<http://adsabs.harvard.edu/abs/2013A%26A...549A...8B>`_, *Atmospheric
extinction properties above Mauna Kea from the Nearby Supernova Factory
spectro-photometric data set*.

Installation
------------

The module is installable from `pypi <https://pypi.org/project/pyextinction/>`_
(traditional dependencies: numpy_, scipy_, matplotlib_, astropy_):

.. code-block:: bash

   pip install pyextinction

Extinction parameters
---------------------

Default extinction parameters are adapted to mean `Mauna-Kea summit
<http://www.ifa.hawaii.edu/mko/>`_ conditions:

.. table:: Atmospheric extinction parameters.

   =================================  =================
   Parameter                          Value ± Error
   =================================  =================
   *Mauna Kea*
   ----------------------------------------------------
   Pressure                           616 ± 2 mbar
   Ozone column                       257 ± 23 DU
   Aerosols optical depth @ 1 µm      0.0076 ± 0.0014
   Aerosols angstrom exponent         1.26 ± 1.33
   =================================  =================

.. figure:: atmosphericExtinction.*
   :width: 80%

Please contact us if you have derived mean extinction parameters for other
locations.

Citations
---------

If you have found this extinction curve model useful for your research, we
would appreciate a reference to `Buton et al. (2013)
<http://adsabs.harvard.edu/abs/2013A%26A...549A...8B>`_.  The software itself
can be cited with `Buton & Copin (2014)
<http://adsabs.harvard.edu/abs/2014ascl.soft03002B>`_.

Downloads
---------

* *Mean* Mauna-Kea atmospheric extinction:
  `txt <https://gitlab.in2p3.fr/ycopin/pyExtinction/-/raw/master/docs/atmosphericExtinction.txt>`__,
  `fits <https://gitlab.in2p3.fr/ycopin/pyExtinction/-/raw/master/docs/atmosphericExtinction.fits>`__
* Latest version of the software is available from `gitlab repository
  <https://gitlab.in2p3.fr/ycopin/pyExtinction>`_
* On-line documentation can be found on `gitlab pages
  <https://ycopin.pages.in2p3.fr/pyExtinction>`_ (latest) and `rtfd
  <http://pyextinction.readthedocs.org/en/latest/>`_ (legacy)

Licence
-------

This code is placed under the `CeCILL-C free software license agreement
<http://www.cecill.info/licences/Licence_CeCILL-C_V1-en.html>`_.

Some external links cited in the paper (potentially deprecated)
===============================================================

* SkyProbe_
* `Mauna Loa Observatory`_
* `Total Ozone measurements`_

.. _numpy: https://numpy.org/
.. _scipy: https://www.scipy.org/
.. _matplotlib: https://matplotlib.org/
.. _astropy: https://www.astropy.org/
.. _SkyProbe: http://www.cfht.hawaii.edu/Instruments/Elixir/skyprobe/home.html
.. _Mauna Loa Observatory: http://www.esrl.noaa.gov/gmd/obop/mlo/
.. _Total Ozone measurements: http://www.esrl.noaa.gov/gmd/ozwv/dobson/
