NAME

fors_sumflux - Integrate flux from all or part of the input frame

SYNOPSIS

esorex fors_sumflux [OPTIONS] FILE.sof

DESCRIPTION

This recipe is used to monitor any lamp flux on the CCD. The input raw image should be
either a FLUX_ARC_LSS or a FLUX_FLAT_LSS frame. After the background subtraction the total
signal is integrated and divided by the exposure time and by the total number of CCD
original pixels (keeping into account a possible rebinned readout). In the case of FORS2
frames the background is the median level evaluated from the available overscan regions.
In the case of FORS1 data, where overscan regions are missing, the background is evaluated
as the median level of the first 200 CCD columns for flat field data, while for arc lamp
data a background map evaluated from the regions without spectral lines is computed and
subtracted. The background subtracted frame is written to output in all cases, and the QC
parameters QC LAMP FLUX and QC LAMP FLUXERR are computed.
Input files:
DO category: Type: Explanation: Required:
FLUX_FLAT_LSS Raw Flat field exposure Y
or FLUX_ARC_LSS Raw Arc lamp exposure Y
Output files:
DO category: Data type: Explanation:
FLUX_LAMP_LSS FITS image Background subtracted integration region

OPTIONS

--xlow<long>
X coordinate of lower left corner of integration region (pixel) (long; default: 0).
The full name of this option for the EsoRex configuration file is
fors.fors_sumflux.xlow [default = 0].
--ylow<long>
Y coordinate of lower left corner of integration region (pixel) (long; default: 0).
The full name of this option for the EsoRex configuration file is
fors.fors_sumflux.ylow [default = 0].
--xhigh<long>
X coordinate of upper right corner of integration region (pixel) (0 = CCD size)
(long; default: 0). The full name of this option for the EsoRex configuration file
is fors.fors_sumflux.xhigh [default = 0].
--yhigh<long>
Y coordinate of upper right corner of integration region (pixel) (0 = CCD size)
(long; default: 0). The full name of this option for the EsoRex configuration file
is fors.fors_sumflux.yhigh [default = 0].
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.

AUTHOR

BUGREPORTS

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