Provided by: cpl-plugin-giraf-doc_2.16.10+dfsg-1build3_all bug

NAME

       gimasterflat - Create the fiber master flat field and the localization mask.

SYNOPSIS

       esorex gimasterflat [OPTIONS] FILE.sof

DESCRIPTION

       For detailed information please refer to the GIRAFFE pipeline user manual.

       It is available at http://www.eso.org/pipelines.

OPTIONS

       --fiber-splist <str>
              Index list of spectra to use for localization (e.g. 2,10,30-40,55).  (str; default:
              ´´).  The  full  name  of  this  option  for  the  EsoRex  configuration  file   is
              giraffe.fibers.spectra [default = ].

       --fiber-nspec <int>
              Number  of spectra to localize. (int; default: 0). The full name of this option for
              the EsoRex configuration file is giraffe.fibers.nspectra [default = 0].

       --remove-bias <bool>
              Enable bias removal (bool; default: True). The full name of  this  option  for  the
              EsoRex configuration file is giraffe.biasremoval.remove [default = True].

       --bsremove-method <str>
              Bias removal method (str; default: ´PROFILE´). The full name of this option for the
              EsoRex configuration file is giraffe.biasremoval.method [default = PROFILE].

       --bsremove-areas <str>
              Bias  areas  to  use  (Xl0:Xr0:Yl0:Yr0,  ...   ,Xln:Xrn:Yln:Yrn)   (str;   default:
              ´5:40:0:4095´).  The  full name of this option for the EsoRex configuration file is
              giraffe.biasremoval.areas [default = 5:40:0:4095].

       --bsremove-sigma <float>
              Sigma Clipping: sigma threshold factor (float; default: 2.5). The full name of this
              option  for  the  EsoRex configuration file is giraffe.biasremoval.sigma [default =
              2.5].

       --bsremove-niter <int>
              Sigma Clipping: maximum number of iterations (int; default: 5). The  full  name  of
              this  option  for  the  EsoRex configuration file is giraffe.biasremoval.iterations
              [default = 5].

       --bsremove-mfrac <float>
              Sigma Clipping:  minimum  fraction  of  points  accepted/total  [0.0..1.0]  (float;
              default:  0.8).  The  full name of this option for the EsoRex configuration file is
              giraffe.biasremoval.fraction [default = 0.8].

       --bsremove-xorder <int>
              Order of X polynomial fit (CURVE method only) (int; default: 1). The full  name  of
              this  option  for  the  EsoRex  configuration  file  is  giraffe.biasremoval.xorder
              [default = 1].

       --bsremove-yorder <int>
              Order of Y polynomial fit (CURVE method only) (int; default: 1). The full  name  of
              this  option  for  the  EsoRex  configuration  file  is  giraffe.biasremoval.yorder
              [default = 1].

       --bsremove-xstep <int>
              Sampling step along X (CURVE method only) (int; default: 1). The full name of  this
              option  for  the  EsoRex configuration file is giraffe.biasremoval.xstep [default =
              1].

       --bsremove-ystep <int>
              Sampling step along Y (CURVE method only) (int; default: 1). The full name of  this
              option  for  the  EsoRex configuration file is giraffe.biasremoval.ystep [default =
              1].

       --sloc-mode <str>
              Localization mode: Use all spectra or the 5 SIWC spectra (str; default: ´all´). The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              giraffe.localization.mode [default = all].

       --sloc-start <int>
              Bin along x-axis (int; default: -1). The full name of this option  for  the  EsoRex
              configuration file is giraffe.localization.start [default = -1].

       --sloc-retries <int>
              Initial  localization  detection xbin retries. (int; default: 10). The full name of
              this option for  the  EsoRex  configuration  file  is  giraffe.localization.retries
              [default = 10].

       --sloc-binsize <int>
              Initial localization detection xbin size. (int; default: -1). The full name of this
              option for the EsoRex configuration file is giraffe.localization.binsize [default =
              -1].

       --sloc-ewidth <float>
              Localization  detection  extra  width. (float; default: 1.0). The full name of this
              option for the EsoRex configuration file is giraffe.localization.ewidth [default  =
              1.0].

       --sloc-ywidth <int>
              Full  width  [pxl] of the equilizing filter (distance between two adjacent fibers).
              (int; default: -1). The full name of this option for the EsoRex configuration  file
              is giraffe.localization.ywidth [default = -1].

       --sloc-center <str>
              Method  used for mask center computation. (str; default: ´centroid´). The full name
              of this option for the EsoRex  configuration  file  is  giraffe.localization.center
              [default = centroid].

       --sloc-norm <bool>
              Enable  spectrum  normalization  along the dispersion axis. (bool; default: False).
              The  full  name  of  this   option   for   the   EsoRex   configuration   file   is
              giraffe.localization.normalize [default = False].

       --sloc-noise <float>
              Threshold  multiplier.  (float; default: 7.0). The full name of this option for the
              EsoRex configuration file is giraffe.localization.noise [default = 7.0].

       --sloc-threshold <str>
              Selects thresholding algorithm: local, row or global (str; default:  ´local´).  The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              giraffe.localization.threshold [default = local].

       --sloc-ron <float>
              New bias sigma (RON) value for dark subtraction (float; default:  -1.0).  The  full
              name  of  this option for the EsoRex configuration file is giraffe.localization.ron
              [default = -1.0].

       --sloc-yorder <int>
              Order of Chebyshev polynomial fit. (int; default: 4). The full name of this  option
              for the EsoRex configuration file is giraffe.localization.yorder [default = 4].

       --sloc-worder <int>
              Order  of  Chebyshev  2D  polynomial  fit. (int; default: 2). The full name of this
              option for the EsoRex configuration file is giraffe.localization.worder [default  =
              2].

       --sloc-sigma <float>
              Localization  clipping: sigma threshold factor (float; default: 2.5). The full name
              of this option for the  EsoRex  configuration  file  is  giraffe.localization.sigma
              [default = 2.5].

       --sloc-niter <int>
              Localization  clipping:  number  of  iterations (int; default: 5). The full name of
              this option for the EsoRex configuration  file  is  giraffe.localization.iterations
              [default = 5].

       --sloc-mfrac <float>
              Localization clipping: minimum fraction of points accepted/total.  (float; default:
              0.9).  The  full  name  of  this  option  for  the  EsoRex  configuration  file  is
              giraffe.localization.fraction [default = 0.9].

       --psf-model <str>
              PSF  profile model: `psfexp´, `psfexp2´ (str; default: ´psfexp2´). The full name of
              this option for the EsoRex  configuration  file  is  giraffe.psf.model  [default  =
              psfexp2].

       --psf-norm <bool>
              Use  normalized  pixel values. (bool; default: False). The full name of this option
              for the EsoRex configuration file is giraffe.psf.normalize [default = False].

       --psf-binsize <int>
              Size of bin along dispersion axis (int; default: 64). The full name of this  option
              for the EsoRex configuration file is giraffe.psf.binsize [default = 64].

       --psf-maxwidth <float>
              Maximum  width  of  the  PSF profile. (float; default: 16.0). The full name of this
              option for the EsoRex configuration file is giraffe.psf.maxwidth [default = 16.0].

       --psf-width <float>
              Initial width of the PSF profile. (float; default: 0.0).  The  full  name  of  this
              option for the EsoRex configuration file is giraffe.psf.width [default = 0.0].

       --psf-exponent <float>
              Exponent  of  the  exponential  PSF  profile  (will not be fitted if > 0).  (float;
              default: -3.0). The full name of this option for the EsoRex configuration  file  is
              giraffe.psf.exponent [default = -3.0].

       --psf-pfniter <int>
              Maximum  number  of  iterations  used  for  the fit of the fiber PSF profile. (int;
              default: 120). The full name of this option for the EsoRex  configuration  file  is
              giraffe.psf.profile.iterations [default = 120].

       --psf-pfntest <int>
              Maximum  number  of  tests used for the fit of the fiber PSF profile (int; default:
              7).  The  full  name  of  this  option  for  the  EsoRex  configuration   file   is
              giraffe.psf.profile.tests [default = 7].

       --psf-pfdchisq <float>
              Minimum  chi-square  difference  used for the fit of the fiber PSF profile. (float;
              default: 0.001). The full name of this option for the EsoRex configuration file  is
              giraffe.psf.profile.dchisquare [default = 0.001].

       --psf-prmfit <bool>
              2D  fit  of  the  PSF profile parameters using a Chebyshev polynomial model. (bool;
              default: False). The full name of this option for the EsoRex configuration file  is
              giraffe.psf.parameters.fit [default = False].

       --psf-yorder <int>
              Order  of Chebyshev polynomial fit. (int; default: 4). The full name of this option
              for the EsoRex configuration file is giraffe.psf.parameters.yorder [default = 4].

       --psf-worder <int>
              Order of Chebyshev 2D polynomial fit. (int; default: 4).  The  full  name  of  this
              option  for the EsoRex configuration file is giraffe.psf.parameters.worder [default
              = 4].

       --psf-sigma <float>
              PSF parameter fitting: sigma threshold factor (float; default: 3.5). The full  name
              of  this  option  for the EsoRex configuration file is giraffe.psf.parameters.sigma
              [default = 3.5].

       --psf-niter <int>
              PSF parameter fitting: number of iterations (int; default: 10). The  full  name  of
              this  option for the EsoRex configuration file is giraffe.psf.parameters.iterations
              [default = 10].

       --psf-mfrac <float>
              PSF parameter fitting: minimum fraction of points accepted/total.  (float; default:
              0.8).  The  full  name  of  this  option  for  the  EsoRex  configuration  file  is
              giraffe.psf.parameters.fraction [default = 0.8].

       --extr-method <str>
              Extraction method: ´SUM´, ´HORNE´ or ´OPTIMAL´ (str; default: ´SUM´). The full name
              of  this  option  for  the  EsoRex  configuration file is giraffe.extraction.method
              [default = SUM].

       --extr-ron <float>
              New bias sigma (RON) value for bias  and  dark  corrected  image  (float;  default:
              -1.0).  The  full  name  of  this  option  for  the  EsoRex  configuration  file is
              giraffe.extraction.ron [default = -1.0].

       --extr-psfmodel <str>
              PSF profile model: `psfexp´, `psfexp2´ (str; default: ´psfexp2´). The full name  of
              this  option  for  the  EsoRex  configuration  file is giraffe.extraction.psf.model
              [default = psfexp2].

       --extr-psfsigma <float>
              Sigma clippging threshold  used  for  rejecting  data  points  during  PSF  fitting
              (Horne´s  sigma).  It  is  used to reject bad pixels and cosmics.  (float; default:
              7.0).  The  full  name  of  this  option  for  the  EsoRex  configuration  file  is
              giraffe.extraction.psf.sigma [default = 7.0].

       --extr-psfniter <int>
              Maximum  number  of iterations used for fitting the PSF profile. (int; default: 2).
              The  full  name  of  this   option   for   the   EsoRex   configuration   file   is
              giraffe.extraction.psf.iterations [default = 2].

       --extr-hewidth <int>
              Horne  extraction  method:  Number  of  extra pixels added to the fiber half-width.
              (int; default: 2). The full name of this option for the EsoRex  configuration  file
              is giraffe.extraction.horne.extrawidth [default = 2].

       --extr-hmingood <int>
              Horne extraction method: Minimum number of points used for the profile fit. It sets
              the lower limit of data points for the pixel rejection.   (int;  default:  3).  The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              giraffe.extraction.horne.mingood [default = 3].

       --extr-omfrac <float>
              Optimal extraction method: Minimum fraction of the data points used for fitting the
              fiber  profiles.  It sets the lower limit for the pixel rejection. (float; default:
              0.9).  The  full  name  of  this  option  for  the  EsoRex  configuration  file  is
              giraffe.extraction.optimal.fraction [default = 0.9].

       --extr-owfactor <float>
              Optimal  extraction method: Factor by which the fiber PSF half width is multiplied.
              Adjacent spectra within  this  area  are  assumed  to  affect  the  spectrum  being
              extracted.  (float;  default:  3.0).  The  full  name of this option for the EsoRex
              configuration file is giraffe.extraction.optimal.wfactor [default = 3.0].

       --extr-obkgorder <int>
              Optimal extraction method: Order of  the  polynomial  background  model,  which  is
              fitted for each wavelength bin along the spatial direction.  (int; default: 2). The
              full   name   of   this   option   for   the   EsoRex   configuration    file    is
              giraffe.extraction.optimal.bkgorder [default = 2].

       --transmission <bool>
              Controls  the  relative  fiber transmission computation. (bool; default: True). The
              full   name   of   this   option   for   the   EsoRex   configuration    file    is
              giraffe.masterflat.transmission [default = True].

       --slight <bool>
              Controls  the  scattered  light model computation. (bool; default: False). The full
              name of this option for the EsoRex configuration file is  giraffe.masterflat.slight
              [default = False].

       --slight-model <str>
              Name  of the scattered light model to use. (str; default: ´polynom´). The full name
              of this option for  the  EsoRex  configuration  file  is  giraffe.slight.model.name
              [default = polynom].

       --slight-order <str>
              Scattered  light  model  fit X and Y order. (str; default: ´4,2´). The full name of
              this  option  for  the  EsoRex  configuration  file  is  giraffe.slight.model.order
              [default = 4,2].

       --slight-xstep <int>
              Interspectrum  region sampling step along the dispersion direction.  (int; default:
              10).  The  full  name  of  this  option  for  the  EsoRex  configuration  file   is
              giraffe.slight.xstep [default = 10].

       --slight-ystep <int>
              Interspectrum  region sampling step along the spatial direction. (int; default: 1).
              The  full  name  of  this   option   for   the   EsoRex   configuration   file   is
              giraffe.slight.ystep [default = 1].

       --slight-xslice <str>
              Interspectrum  region  sampling  step along the dispersion direction for a specific
              region. This overrides ´xstep´ for the given region. (str;  default:  ´none´).  The
              full name of this option for the EsoRex configuration file is giraffe.slight.xslice
              [default = none].

       --slight-ewidth <float>
              Extra width [pixels] added to both sides of  a  spectrum  trace.  (float;  default:
              0.5).  The  full  name  of  this  option  for  the  EsoRex  configuration  file  is
              giraffe.slight.ewidth [default = 0.5].

       --slight-iswidth <int>
              Minimum width [pixels] required for interspectrum regions. (int; default:  2).  The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              giraffe.slight.iswidth [default = 2].

       --slight-istrim <bool>
              Turn off using the first and last interspectrum region. (bool; default: True).  The
              full name of this option for the EsoRex configuration file is giraffe.slight.istrim
              [default = True].

       --slight-phff <bool>
              Use photometric flat field correction. (bool; default: False).  The  full  name  of
              this  option  for  the  EsoRex  configuration file is giraffe.slight.phffcorrection
              [default = False].

       --slight-remove <bool>
              Remove scattered light from the input frame. (bool; default: False). The full  name
              of  this option for the EsoRex configuration file is giraffe.slight.remove [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 giraf pipeline can be downloaded as a PDF  file  using  the
       following URL:

              ftp://ftp.eso.org/pub/dfs/pipelines/giraffe/giraf-pipeline-manual-2.11.pdf

       An   overview   over   the   existing   ESO  pipelines  can  be  found  on  the  web  page
       https://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
       https://packages.python.org/python-cpl/index.html for further information.

       The   other   recipes   of   the  giraf  pipeline  are  giframestack(7),  gimasterbias(7),
       gimasterdark(7), giscience(7), gistandard(7), giwavecalibration(7)

VERSION

       gimasterflat 2.16.10

AUTHOR

       Giraffe Pipeline <https://support.eso.org/>

BUG REPORTS

       Please report any problems to https://support.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 GIRAFFE Instrument Pipeline
        Copyright (C) 2002-2014 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