The naco_img_lampflat recipe
===============================================================

.. data:: naco_img_lampflat

Synopsis
--------

Flat recipe using a lamp

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

naco_img_lampflat -- NACO imaging flat-field creation from lamp images.

The files listed in the Set Of Frames (sof-file) must be tagged:
NACO-raw-file.fits CAL_FLAT_LAMP

Furthermore, the input set of frames must have values of the FITS key ESO INS LAMP2 SET that alternate between zero and non-zero (with non-zero for the first frame).

It is further required that the light from the lamp is in a range without a significant thermal background.


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

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

   Create an object for the recipe naco_img_lampflat.

::

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

Parameters
----------

.. py:attribute:: naco_img_lampflat.param.r

    Rejected left right bottom and top border [pixel] (str; default: '200  200 200 200') [default="200 200 200 200"].


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

::

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

   naco_img_lampflat.param.r = "200 200 200 200"


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

::

   import cpl
   naco_img_lampflat = cpl.Recipe("naco_img_lampflat")
   [...]
   res = naco_img_lampflat( ..., param = {"r":"200 200 200 200"})


.. 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 `Lars Lundin <usd-help@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 NACO Instrument Pipeline
Copyright (C) 2002, 2003, 2005, 2008 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:: Lars Lundin <usd-help@eso.org>
