.TH FORS_FLATFIELD "7" "5.3.32" "fors_flatfield" "fors recipes"
.SH NAME
fors_flatfield \- Flat field correction of input frame

.SH SYNOPSIS
esorex
.B fors_flatfield
[OPTIONS] FILE.sof

.SH 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).
.PP
In the table below the MXU acronym can be alternatively read as MOS and
LSS.
.PP

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



.SH OPTIONS

.PP
Note that it is possible to create a configuration file containing these
options, along with suitable default values. Please refer to the details
provided by the 'esorex \-\-help' command.

.SH SEE ALSO
The full documentation for the fors pipeline can be downloaded as 
a PDF file using the following URL:
.IP
.B ftp://ftp.eso.org/pub/dfs/pipelines/fors/fors\-pipeline\-manual\-4.9.pdf
.PP
An overview over the existing ESO pipelines can be found on the web page
\fBhttps://www.eso.org/sci/software/pipelines/\fR.
.PP
Basic documentation about the EsoRex program can be found at the esorex (1) 
man page.
.PP
It is possible to call the pipelines from python using the python\-cpl package.
See \fBhttps://packages.python.org/python\-cpl/index.html\fR for further
information.
.PP
The other recipes of the fors pipeline are
.IR fors_align_sky (7),
.IR fors_align_sky_lss (7),
.IR fors_bias (7),
.IR fors_calib (7),
.IR fors_config (7),
.IR fors_dark (7),
.IR fors_detect_objects (7),
.IR fors_detect_spectra (7),
.IR fors_extract (7),
.IR fors_extract_objects (7),
.IR fors_extract_slits (7),
.IR fors_img_science (7),
.IR fors_img_screen_flat (7),
.IR fors_img_sky_flat (7),
.IR fors_normalise_flat (7),
.IR fors_photometry (7),
.IR fors_pmos_calib (7),
.IR fors_pmos_extract (7),
.IR fors_pmos_science (7),
.IR fors_remove_bias (7),
.IR fors_resample (7),
.IR fors_science (7),
.IR fors_spec_mflat (7),
.IR fors_subtract_sky (7),
.IR fors_subtract_sky_lss (7),
.IR fors_sumflux (7),
.IR fors_trace_flat (7),
.IR fors_wave_calib (7),
.IR fors_wave_calib_lss (7),
.IR fors_zeropoint (7)

.SH VERSION
fors_flatfield 5.3.32

.SH AUTHOR
Carlo Izzo <usd\-help@eso.org>

.SH BUG REPORTS
Please report any problems to usd\-help@eso.org. Alternatively, you may send a report to the ESO User Support Department <usd\-help@eso.org>.

.SH LICENSE
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