The muse_scipost_correct_dar recipe
===============================================================

.. data:: muse_scipost_correct_dar

Synopsis
--------

Apply DAR correction for MUSE pixel tables.

Description
-----------

Correct the coordinates in the pixel table by differential atmospheric refraction. This is a task separated from muse_scipost.


Constructor
-----------

.. method:: cpl.Recipe("muse_scipost_correct_dar")
   :noindex:

   Create an object for the recipe muse_scipost_correct_dar.

::

   import cpl
   muse_scipost_correct_dar = cpl.Recipe("muse_scipost_correct_dar")

Parameters
----------

.. py:attribute:: muse_scipost_correct_dar.param.lambdamin

    Cut off the data below this wavelength after loading the pixel  table(s). (float; default: 4000.0) [default=4000.0].
.. py:attribute:: muse_scipost_correct_dar.param.lambdamax

    Cut off the data above this wavelength after loading the pixel  table(s). (float; default: 10000.0) [default=10000.0].
.. py:attribute:: muse_scipost_correct_dar.param.lambdaref

    Reference wavelength used for correction of differential atmospheric  refraction. The R-band (peak wavelength ~7000 Angstrom) that is  usually used for guiding, is close to the central wavelength of MUSE,  so a value of 7000.0 Angstrom should be used if nothing else is known.  A value less than zero switches DAR correction off. (float; default:  7000.0) [default=7000.0].
.. py:attribute:: muse_scipost_correct_dar.param.darcheck

    Carry out a check of the theoretical DAR correction using source  centroiding. If "correct" it will also apply an empirical correction.  (str; default: 'none') [default="none"].


The following code snippet shows the default settings for the available 
parameters.

::

   import cpl
   muse_scipost_correct_dar = cpl.Recipe("muse_scipost_correct_dar")

   muse_scipost_correct_dar.param.lambdamin = 4000.0
   muse_scipost_correct_dar.param.lambdamax = 10000.0
   muse_scipost_correct_dar.param.lambdaref = 7000.0
   muse_scipost_correct_dar.param.darcheck = "none"


You may also set or overwrite some or all parameters by the recipe 
parameter `param`, as shown in the following example:

::

   import cpl
   muse_scipost_correct_dar = cpl.Recipe("muse_scipost_correct_dar")
   [...]
   res = muse_scipost_correct_dar( ..., param = {"lambdamin":4000.0, "lambdamax":10000.0})


.. seealso:: `cpl.Recipe <https://packages.python.org/python-cpl/recipe.html>`_
   for more information about the recipe object.

Bug reports
-----------

Please report any problems to `Ole Streicher <https://support.eso.org>`_. Alternatively, you may 
send a report to the `ESO User Support Department <usd-help@eso.org>`_.

Copyright
---------

This file is part of the MUSE Instrument Pipeline
Copyright (C) 2005, 2019 European Southern Observatory

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, 
MA  02111-1307  USA

.. codeauthor:: Ole Streicher <https://support.eso.org>