Provided by: cpl-plugin-hawki-doc_1.8.12+dfsg-2_all bug

NAME

       hawki_cal_flat - Twillight flat recipe

SYNOPSIS

       esorex hawki_cal_flat [OPTIONS] FILE.sof

DESCRIPTION

       hawki_cal_flat -- HAWKĪI imaging flat-field creation from twillight images.

       The  input  of  the recipe files listed in the Set Of Frames (sof-file) must be tagged as:
       raw-file.fits FLAT  or  Optional  inputs  are:  bpmdark-file.fits  BPM_HOT  dark-file.fits
       DARK_IM    dark_err-file.fits    DARK_ERR    The    recipe    creates    as   an   output:
       hawki_cal_flat_setxx.fits     (FLAT_IM):     Master      flat      for      filter      xx
       hawki_cal_flat_err_setxx.fits       (FLAT_ERRMAP):       Master       flat       residuals
       hawki_cal_flat_bpmflat_setxx.fits      (BPM_COLD):      BPM      from       the       flat
       hawki_cal_flat_stats_setxx.fits  (FLAT_STATS): Stats of the individual flats Optionally it
       also creates: hawki_cal_flat_bpm_setxx.fits (BPM): Bad pixel mask combining bpm from  dark
       and flat hawki_cal_flat_stats_ec_setxx.fits (FLAT_STATS_EVEN_COL): Stats of the individual
       flats for even columns hawki_cal_flat_stats_oc_setxx.fits (FLAT_STATS_ODD_COL):  Stats  of
       the     individual    flats    for    odd    columns    hawki_cal_flat_stats_er_setxx.fits
       (FLAT_STATS_EVEN_ROW):    Stats    of    the    individual    flats    for    even    rows
       hawki_cal_flat_stats_or_setxx.fits (FLAT_STATS_ODD_ROW): Stats of the individual flats for
       odd rows Return code: esorex exits with an  error  code  of  0  if  the  recipe  completes
       successfully or 1 otherwise

OPTIONS

       --zone <str>
              Stats  zone  (str;  default: ´1,1,2048,2048´). The full name of this option for the
              EsoRex configuration file is hawki.hawki_cal_flat.zone [default = 1,1,2048,2048].

       --normalise <bool>
              Flag to apply the normalisation (bool; default:  False).  The  full  name  of  this
              option for the EsoRex configuration file is hawki.hawki_cal_flat.normalise [default
              = False].

       --second_pass <bool>
              Flag to apply a second pass computation (bool; default: True).  The  full  name  of
              this  option  for the EsoRex configuration file is hawki.hawki_cal_flat.second_pass
              [default = True].

       --sigma_badres <float>
              sigma for detection of bad flat results (float; default: 1.0).  The  full  name  of
              this  option for the EsoRex configuration file is hawki.hawki_cal_flat.sigma_badres
              [default = 1.0].

       --sigma_bpm <float>
              sigma for detection of bad pixels (float; default: 10.0). The  full  name  of  this
              option for the EsoRex configuration file is hawki.hawki_cal_flat.sigma_bpm [default
              = 10.0].

       --lowval_bpm <float>
              values of the flat below this will be included in the bpm. In units of  final  flat
              (normalised if normalise is on) (float; default: 0.1). The full name of this option
              for the EsoRex configuration file  is  hawki.hawki_cal_flat.lowval_bpm  [default  =
              0.1].

       --highval_bpm <float>
              values  of  the flat above this will be included in the bpm. In units of final flat
              (normalized if normalise is on) (float; default:  10.0).  The  full  name  of  this
              option  for  the  EsoRex  configuration  file  is  hawki.hawki_cal_flat.highval_bpm
              [default = 10.0].

       --select_auto <bool>
              Flag to automatically select the good input frames (bool; default: True). The  full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              hawki.hawki_cal_flat.select_auto [default = True].

       --select_auto_max_bins <long>
              Maximum number of frames requested (long; default:  10).  The  full  name  of  this
              option        for        the        EsoRex        configuration       file       is
              hawki.hawki_cal_flat.select_auto_max_bins [default = 10].

       --select_min_level <str>
              Minimum ADU level for frames selection (str; default: ´-1.0´).  The  full  name  of
              this      option      for      the      EsoRex      configuration      file      is
              hawki.hawki_cal_flat.select_min_level [default = -1.0].

       --select_max_level <str>
              Maximum ADU level for frames selection (str; default: ´25000´). The  full  name  of
              this      option      for      the      EsoRex      configuration      file      is
              hawki.hawki_cal_flat.select_max_level [default = 25000].

       --select_max_rms <str>
              Maximum RMS for frames selection (str; default: ´4000´).  The  full  name  of  this
              option  for  the  EsoRex  configuration file is hawki.hawki_cal_flat.select_max_rms
              [default = 4000].

       --select_min_nframes <long>
              Minimum number of frames requested (long; default: 3). The full name of this option
              for   the  EsoRex  configuration  file  is  hawki.hawki_cal_flat.select_min_nframes
              [default = 3].

       --extra_stats <bool>
              Request for even/odd column/rows statistics (bool; default: False). The  full  name
              of     this     option     for     the     EsoRex     configuration     file     is
              hawki.hawki_cal_flat.extra_stats [default = False].

       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.

SEE ALSO

       The full documentation for the hawki pipeline can be downloaded as a PDF  file  using  the
       following URL:

              ftp://ftp.eso.org/pub/dfs/pipelines/hawki/hawki-pipeline-manual-1.8.12.pdf

       An   overview   over   the   existing   ESO  pipelines  can  be  found  on  the  web  page
       http://www.eso.org/sci/software/pipelines/.

       Basic documentation about the EsoRex program can be found at the esorex (1) man page.

       It is possible to call the pipelines  from  python  using  the  python-cpl  package.   See
       http://packages.python.org/python-cpl/index.html for further information.

       The  other  recipes  of  the hawki pipeline are hawki_step_stitch(7), hawki_cal_zpoint(7),
       hawki_util_gendist(7),         hawki_step_apply_dist(7),         hawki_step_detect_obj(7),
       hawki_util_stdstars(7),       hawki_step_basic_calib(7),       hawki_step_photom_2mass(7),
       hawki_util_extinction(7),        hawki_step_compute_bkg(7),         hawki_step_combine(7),
       hawki_cal_dark(7),  hawki_sci_jitter(7), hawki_tec_filtchk(7), hawki_step_subtract_bkg(7),
       hawki_step_refine_offsets(7), hawki_cal_distortion(7), hawki_step_stats(7)

VERSION

       hawki_cal_flat 1.8.12

AUTHOR

       Cesar Enrique Garcia Dabo <usd-help@eso.org>

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

LICENSE

       This  file  is  part  of  the  HAWKI  Instrument Pipeline Copyright (C) 2002,2011 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., 59 Temple Place, Suite 330, Boston,
       MA  02111-1307  USA