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

NAME

       giwavecalibration - Compute dispersion solution from an arc-lamp spectrum.

SYNOPSIS

       esorex giwavecalibration [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

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

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

       --wcal-lswidth <str>
              List of window widths [pxl] used for line detection  and  fit  (e.g.   ´60,40,15´).
              (str;  default:  ´10,10,10,10,10´).  The  full  name  of this option for the EsoRex
              configuration file is giraffe.wlcalibration.line.widths [default = 10,10,10,10,10].

       --wcal-lssep <float>
              Factor used to compute the minimum line separation from the window  width.  (float;
              default:  0.9).  The  full name of this option for the EsoRex configuration file is
              giraffe.wlcalibration.line.separation [default = 0.9].

       --wcal-lsfxratio <float>
              Selects only lines whose neighbours have  a  relative  intensity  less  than  1.  /
              fluxratio.  (float;  default:  50.0).  The  full name of this option for the EsoRex
              configuration file is giraffe.wlcalibration.line.fluxratio [default = 50.0].

       --wcal-lsbright <float>
              Selects lines having an intensity greater or equal to the given intensity.  (float;
              default:  0.0).  The  full name of this option for the EsoRex configuration file is
              giraffe.wlcalibration.line.brightness [default = 0.0].

       --wcal-lscount <int>
              Sets the minimum number of lines to select; selected are  lines  with  the  highest
              nominal  intensity.  A  value  of 0 turns this selection off.  If the value is less
              than 0 the selection is skipped if the line list does  not  contain  enough  lines.
              (int; default: -80). The full name of this option for the EsoRex configuration file
              is giraffe.wlcalibration.line.count [default = -80].

       --wcal-lswrange <str>
              Selects only lines within the given wavelength range [nm]. (str; default: ´0.,0.´).
              The   full   name   of   this   option   for   the  EsoRex  configuration  file  is
              giraffe.wlcalibration.line.wrange [default = 0.,0.].

       --wcal-lfmodel <str>
              Line profile model. (str; default: ´psfexp´). The full name of this option for  the
              EsoRex configuration file is giraffe.wlcalibration.line.model [default = psfexp].

       --wcal-lfres <str>
              Use  optical  model  residuals for line detection. (str; default: ´auto´). The full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              giraffe.wlcalibration.line.residuals [default = auto].

       --wcal-lfthreshold <float>
              Line  detection  threshold during the line fitting (multiple of bias sigma) (float;
              default: 1.0). The full name of this option for the EsoRex  configuration  file  is
              giraffe.wlcalibration.line.threshold [default = 1.0].

       --wcal-lfoffset <float>
              Maximum  allowed  difference between the fitted and raw line peak position. (float;
              default: 10.0). The full name of this option for the EsoRex configuration  file  is
              giraffe.wlcalibration.line.offset [default = 10.0].

       --wcal-lfniter <int>
              Line  detection fit maximum number of iterations. (int; default: 50). The full name
              of     this     option     for     the     EsoRex     configuration     file     is
              giraffe.wlcalibration.line.iterations [default = 50].

       --wcal-lfntest <int>
              Line  detection  fit  maximum  number of tests. (int; default: 7). The full name of
              this option for the EsoRex configuration file  is  giraffe.wlcalibration.line.tests
              [default = 7].

       --wcal-lfdchisq <float>
              Line  detection  fit  minimum  chi-square difference. (float; default: 0.0001). The
              full   name   of   this   option   for   the   EsoRex   configuration    file    is
              giraffe.wlcalibration.line.dchisquare [default = 0.0001].

       --wcal-lfreswid <float>
              Line  width/resolution  width  factor. (float; default: 0.5). The full name of this
              option for the EsoRex configuration file is  giraffe.wlcalibration.line.rwidthratio
              [default = 0.5].

       --wcal-lfexpwid <float>
              Exponential  line  profile  exponent; it will not be fitted if it is larger than 0.
              (float; default: -3.0). The full name of this option for the  EsoRex  configuration
              file is giraffe.wlcalibration.line.exponent [default = -3.0].

       --wcal-soffset <str>
              Initial slit position offsets along the x and y direction and rotation angle. (str;
              default: ´setup´). The full name of this option for the EsoRex  configuration  file
              is giraffe.wlcalibration.slit.offset [default = setup].

       --wcal-ommodel <str>
              Optical  model.  (str;  default:  ´xoptmod2´). The full name of this option for the
              EsoRex configuration file is giraffe.wlcalibration.opt.model [default = xoptmod2].

       --wcal-omdir <int>
              Dispersion direction flag. (int; default: 1). The full name of this option for  the
              EsoRex configuration file is giraffe.wlcalibration.opt.direction [default = 1].

       --wcal-omsol <bool>
              Controls  optical  model parameter fitting. (bool; default: True). The full name of
              this option for the EsoRex configuration file is giraffe.wlcalibration.opt.solution
              [default = True].

       --wcal-omflags <str>
              List  of  flags  defining  the  set of free parameters used for fitting the optical
              model. Possible values are: fcoll, gcam,  theta,  sdx,  sdy,  sphi  (str;  default:
              ´sdx,sdy,sphi´).  The full name of this option for the EsoRex configuration file is
              giraffe.wlcalibration.opt.flags [default = sdx,sdy,sphi].

       --wcal-omsslits <bool>
              Controls subslit geometry usage in the optical model fit; subslits are used if  set
              to  `true´.  (bool;  default:  False).  The full name of this option for the EsoRex
              configuration file is giraffe.wlcalibration.opt.subslits [default = False].

       --wcal-omniter <int>
              Optical model fit maximum number of iterations. (int; default: 50). The  full  name
              of     this     option     for     the     EsoRex     configuration     file     is
              giraffe.wlcalibration.opt.iterations [default = 50].

       --wcal-omntest <int>
              Optical model fit maximum number of tests (int; default: 7). The full name of  this
              option   for  the  EsoRex  configuration  file  is  giraffe.wlcalibration.opt.tests
              [default = 7].

       --wcal-omdchisq <float>
              Optical model fit minimum chi-square difference. (float; default: 0.0001). The full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              giraffe.wlcalibration.opt.dchisquare [default = 0.0001].

       --wcal-xwsigma <float>
              PSF width fit sigma clipping factor. (float; default: 1.25). The full name of  this
              option   for  the  EsoRex  configuration  file  is  giraffe.wlcalibration.psf.sigma
              [default = 1.25].

       --wcal-xwniter <int>
              PSF width fit sigma clipping maximum number of iterations. (int; default: 10).  The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              giraffe.wlcalibration.psf.iterations [default = 10].

       --wcal-xwmfrac <float>
              PSF width fit sigma clipping minimum fraction  of  points  accepted/total.  (float;
              default:  0.9).  The  full name of this option for the EsoRex configuration file is
              giraffe.wlcalibration.psf.fraction [default = 0.9].

       --wcal-xworder <str>
              X and Y polynomial orders for PSF x-width Chebyshev fit. (str; default: ´2,2´). The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              giraffe.wlcalibration.psf.order [default = 2,2].

       --wcal-wssigma <float>
              Chebyshev correction sigma clipping factor. (float; default: 150.0). The full  name
              of     this     option     for     the     EsoRex     configuration     file     is
              giraffe.wlcalibration.wsol.sigma [default = 150.0].

       --wcal-wsniter <int>
              Chebyshev correction sigma clipping maximum number  of  iterations  (int;  default:
              10).   The  full  name  of  this  option  for  the  EsoRex  configuration  file  is
              giraffe.wlcalibration.wsol.iterations [default = 10].

       --wcal-wsmfrac <float>
              Chebyshev correction sigma clipping  minimum  fraction  of  points  accepted/total.
              (float;  default:  0.9).  The full name of this option for the EsoRex configuration
              file is giraffe.wlcalibration.wsol.fraction [default = 0.9].

       --wcal-wsorder <str>
              X and Y polynomial orders for the wavelength solution Chebyshev  correction.  (str;
              default:  ´6,4´). The full name of this option for the EsoRex configuration file is
              giraffe.wlcalibration.wsol.order [default = 6,4].

       --wcal-rebin <bool>
              Rebin extracted arc-lamp spectra. (bool; default: True).  The  full  name  of  this
              option for the EsoRex configuration file is giraffe.wcal.rebin [default = True].

       --rbin-method <str>
              Method  to  use  :  `linear´ or `spline´ (str; default: ´linear´). The full name of
              this option for the EsoRex configuration file is giraffe.rebinning.method  [default
              = linear].

       --rbin-xresid <bool>
              Use  x  residuals  during rebinning? `true´/`false´ (bool; default: True). The full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              giraffe.rebinning.xresiduals [default = True].

       --rbin-lstep <float>
              Lambda  step size, only used if scaling method is ´linear´ (float; default: 0.005).
              The  full  name  of  this   option   for   the   EsoRex   configuration   file   is
              giraffe.rebinning.lstep [default = 0.005].

       --rbin-scmethod <str>
              Scaling  method:  `log´ or `linear´ (str; default: ´linear´). The full name of this
              option for the EsoRex configuration file is giraffe.rebinning.scalemethod  [default
              = linear].

       --rbin-size <int>
              Size  of  output rebinned spectra, 0 means calculate size based on wavelength range
              and lambda stepsize (int; default: 0). The full name of this option for the  EsoRex
              configuration file is giraffe.rebinning.size [default = 0].

       --rbin-range <str>
              Rebinning range: `setup´ or `common´ (str; default: ´setup´). The full name of this
              option for the EsoRex configuration  file  is  giraffe.rebinning.range  [default  =
              setup].

       --wcal-slit <bool>
              Controls  the  slit  geometry calibration. (bool; default: False). The full name of
              this option for the EsoRex configuration file is giraffe.wcal.slitgeometry [default
              = False].

       --scal-cniter <int>
              Slit geometry calibration maximum number of iterations. (int; default: 1). The full
              name    of    this    option    for    the    EsoRex    configuration    file    is
              giraffe.sgcalibration.iterations [default = 1].

       --scal-zmax <float>
              Maximum  allowed  pixel  value.  To be effective it must be larger than 0.  (float;
              default: 10000.0). The full name of this option for the EsoRex  configuration  file
              is giraffe.sgcalibration.zmax [default = 10000.0].

       --scal-cstep <float>
              Cross-correlation  step. (float; default: -0.005). The full name of this option for
              the EsoRex configuration file is giraffe.sgcalibration.cc.step [default = -0.005].

       --scal-cdomain <str>
              Restricts the cross-correlation to the given domain. (str; default:  ´0.,0.´).  The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              giraffe.sgcalibration.cc.domain [default = 0.,0.].

       --scal-rvlimits <str>
              Delta  RV  limits  of  the  cross-correlation  window  in  km/s.   (str;   default:
              ´-200.,200.´).  The  full  name of this option for the EsoRex configuration file is
              giraffe.sgcalibration.rv.limits [default = -200.,200.].

       --scal-rvniter <int>
              Maximum number of iterations used for the RV determination. (int; default: 3).  The
              full    name    of   this   option   for   the   EsoRex   configuration   file   is
              giraffe.sgcalibration.rv.iterations [default = 3].

       --scal-rvwfactor <float>
              Data window width factor. The FWHM times this value determines  the  window  width.
              (float;  default:  1.5).  The full name of this option for the EsoRex configuration
              file is giraffe.sgcalibration.rv.wfactor [default = 1.5].

       --scal-pfniter <int>
              Peak model fit maximum number of iterations. (int; default: 50). The full  name  of
              this      option      for      the      EsoRex      configuration      file      is
              giraffe.sgcalibration.peak.iterations [default = 50].

       --scal-pfntest <int>
              Cross-correlation peak fit maximum number of tests (int; default: 7). The full name
              of     this     option     for     the     EsoRex     configuration     file     is
              giraffe.sgcalibration.peak.tests [default = 7].

       --scal-pfdchisq <float>
              Cross-correlation peak fit minimum chi-square difference. (float; default: 0.0001).
              The   full   name   of   this   option   for   the  EsoRex  configuration  file  is
              giraffe.sgcalibration.peak.dchisquare [default = 0.0001].

       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), gimasterflat(7), giscience(7), gistandard(7)

VERSION

       giwavecalibration 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