Metadata-Version: 2.0
Name: zap
Version: 2.0
Summary: ZAP (the Zurich Atmosphere Purge) is a high precision sky subtraction tool.
Home-page: https://github.com/musevlt/zap
Author: Kurt Soto, Simon Conseil
Author-email: simon.conseil@univ-lyon1.fr
License: MIT
Keywords: astronomy,astrophysics,science,muse,vlt,sky subtraction
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Dist: astropy
Requires-Dist: numpy
Requires-Dist: scikit-learn
Requires-Dist: scipy
Provides-Extra: plot
Requires-Dist: matplotlib; extra == 'plot'

ZAP (the Zurich Atmosphere Purge)
---------------------------------

Tired of sky subtraction residuals? ZAP them!

ZAP is a high precision sky subtraction tool which can be used as complete sky
subtraction solution, or as an enhancement to previously sky-subtracted MUSE
data.  The method uses PCA to isolate the residual sky subtraction features and
remove them from the observed datacube. Future developments will include
modification for use on a variety of instruments.

The last stable release of ZAP can be installed simply with pip::

    pip install zap

Or into the user path with::

    pip install --user zap

Links
~~~~~

- `documentation <http://zap.readthedocs.io/en/latest/>`_

- `git repository <https://github.com/musevlt/zap>`_

- `changelog <https://github.com/musevlt/zap/blob/master/CHANGELOG>`_

Citation
~~~~~~~~

The paper describing the original method can be found here:
http://adsabs.harvard.edu/abs/2016MNRAS.458.3210S

Please cite ZAP as::

\bibitem[Soto et al.(2016)]{2016MNRAS.458.3210S} Soto, K.~T., Lilly, S.~J., Bacon, R., Richard, J., \& Conseil, S.\ 2016, \mnras, 458, 3210


2.0 (2017-09-08)
----------------

- Compatibility with the WFM-AO mode.

- Use `Scikit-learn`_'s implementation for the PCA instead of the custom one.
  This solved an issue with spatial variations introduced by zap. Also it is
  much faster than the previous implementation. A drawback however is that it is
  no more possible to save the SVD file.

- Use only one *sky segment* by default, which means that the cube is
  no more split on the wavelength axis. Originally zap used 11 segments, whose
  goals were to have coherent groups of sky emission lines, with a smaller
  number of eigenvalues per segment. And it also allowed to parallelize the
  computation. But, the segments were also responsible for continuum
  oscillations, and made the choice of the number of eigenvalues per segment
  very difficult and very sensitive. With only one segment the performance of
  the sky subtraction is much better, thanks to the higher correlation between
  sky lines on the whole wavelength range.

  So using only one segment allows to greatly reduce the risk of killing an
  emission line with the new PCA. It is still possible to modify the segments if
  needed::

      from zap.zap import SKYSEG
      SKYSEG[:] = [0, 5400, ..., 10000]

- New continuum filter type with a polynomial fit (``cftype='fit'``). Must be
  used with care though, as the fit can easily go out of control in the red part
  of the spectrum.

- Change the default median filter width to 300, for the ``median`` and
  ``weight`` continuum filters. The values used previously, 100 and 50, were too
  small which explains the background oscillations in the red part of the
  spectra.

- New parameter (``ncpu``) to set the number of used CPU.

- Remove the possibility to save the SVD result in a FITS file. This is because
  of the change of PCA implementation. It is still possible to pass the SVD
  computed by ``SVDoutput`` to ``process``, passing the in-memory object
  directly without saving it to disk.

- Speed improvements, mostly thanks to the new PCA implementation.

- New parameter to save the explained variance curves.


1.0 (2016-04-02)
----------------

First public release. This is the version described in the 2016MNRAS.458.3210S
paper.

.. _Scikit-learn: http://scikit-learn.org/stable/modules/generated/sklearn.decomposition.PCA.html#sklearn.decomposition.PCA



