The fors_flatfield recipe
===============================================================

.. data:: fors_flatfield

Synopsis
--------

Flat field correction of input frame

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

This recipe is used to divide the input frame by the normalised flat
field frame produced by recipe fors_normalise_flat. The input frame must
be already bias subtracted (e.g., by recipe fors_remove_bias).

In the table below the MXU acronym can be alternatively read as MOS and
LSS.


Input files
^^^^^^^^^^^^
::

  DO category:               Type:       Explanation:         Required:
  SCIENCE_UNBIAS_MXU
  or STANDARD_UNBIAS_MXU     Raw         Bias subtracted frame   Y
  MASTER_NORM_FLAT_MXU       Calib       Normalised flat frame   Y

Output files
^^^^^^^^^^^^
::

  DO category:               Data type:  Explanation:
  SCIENCE_UNFLAT_MXU
  or STANDARD_UNFLAT_MXU     FITS image  Flat field corrected frame


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

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

   Create an object for the recipe fors_flatfield.

::

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



.. 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 `Carlo Izzo <usd-help@eso.org>`_. Alternatively, you may 
send a report to the `ESO User Support Department <usd-help@eso.org>`_.

Copyright
---------

This file is currently part of the FORS Instrument Pipeline
Copyright (C) 2002-2010 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  02110-1301  USA


.. codeauthor:: Carlo Izzo <usd-help@eso.org>
