SIMPLE SOLUTIONS

GIWAVECALIBRATION(7) - Linux man page online | Overview, conventions, and miscellany

Compute dispersion solution from an arc-lamp spectrum.

Chapter
2.16.2
GIWAVECALIBRATION(7) giraf recipes GIWAVECALIBRATION(7)

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 <long> Sigma Clipping: maximum number of iterations (long; 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 <long> Order of X polynomial fit (CURVE method only) (long; default: 1). The full name of this option for the EsoRex configuration file is giraffe.biasremoval.xorder [default = 1]. --bsremove-yorder <long> Order of Y polynomial fit (CURVE method only) (long; default: 1). The full name of this option for the EsoRex configuration file is giraffe.biasremoval.yorder [default = 1]. --bsremove-xstep <long> Sampling step along X (CURVE method only) (long; default: 1). The full name of this option for the EsoRex configuration file is giraffe.biasremoval.xstep [default = 1]. --bsremove-ystep <long> Sampling step along Y (CURVE method only) (long; 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 <long> Maximum number of iterations used for fitting the PSF profile. (long; default: 2). The full name of this option for the EsoRex configuration file is giraffe.extrac‐ tion.psf.iterations [default = 2]. --extr-hewidth <long> Horne extraction method: Number of extra pixels added to the fiber half-width. (long; default: 2). The full name of this option for the EsoRex configuration file is giraffe.extraction.horne.extrawidth [default = 2]. --extr-hmingood <long> Horne extraction method: Minimum number of points used for the profile fit. It sets the lower limit of data points for the pixel rejection. (long; default: 3). The full name of this option for the EsoRex configuration file is giraffe.extrac‐ tion.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 con‐ figuration file is giraffe.extraction.optimal.wfactor [default = 3.0]. --extr-obkgorder <long> Optimal extraction method: Order of the polynomial background model, which is fit‐ ted for each wavelength bin along the spatial direction. (long; default: 2). The full name of this option for the EsoRex configuration file is giraffe.extrac‐ tion.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 con‐ figuration 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 con‐ figuration 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 <long> 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. (long; 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.wlcali‐ bration.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.wlcalibra‐ tion.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 <long> Line detection fit maximum number of iterations. (long; default: 50). The full name of this option for the EsoRex configuration file is giraffe.wlcalibra‐ tion.line.iterations [default = 50]. --wcal-lfntest <long> Line detection fit maximum number of tests. (long; 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.wlcalibra‐ tion.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 <long> Dispersion direction flag. (long; 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 con‐ figuration file is giraffe.wlcalibration.opt.subslits [default = False]. --wcal-omniter <long> Optical model fit maximum number of iterations. (long; default: 50). The full name of this option for the EsoRex configuration file is giraffe.wlcalibration.opt.iter‐ ations [default = 50]. --wcal-omntest <long> Optical model fit maximum number of tests (long; 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.wlcalibra‐ tion.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 <long> PSF width fit sigma clipping maximum number of iterations. (long; default: 10). The full name of this option for the EsoRex configuration file is giraffe.wlcalibra‐ tion.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.wlcalibra‐ tion.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.wlcalibra‐ tion.wsol.sigma [default = 150.0]. --wcal-wsniter <long> Chebyshev correction sigma clipping maximum number of iterations (long; 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.xresidu‐ als [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.rebin‐ ning.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 <long> Size of output rebinned spectra, 0 means calculate size based on wavelength range and lambda stepsize (long; 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 = set‐ up]. --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 <long> Slit geometry calibration maximum number of iterations. (long; default: 1). The full name of this option for the EsoRex configuration file is giraffe.sgcalibra‐ tion.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.sgcalibra‐ tion.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 <long> Maximum number of iterations used for the RV determination. (long; default: 3). The full name of this option for the EsoRex configuration file is giraffe.sgcalibra‐ tion.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 <long> Peak model fit maximum number of iterations. (long; default: 50). The full name of this option for the EsoRex configuration file is giraffe.sgcalibration.peak.itera‐ tions [default = 50]. --scal-pfntest <long> Cross-correlation peak fit maximum number of tests (long; default: 7). The full name of this option for the EsoRex configuration file is giraffe.sgcalibra‐ tion.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.sgcali‐ bration.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 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 giraf pipeline are giframestack(7), gimasterbias(7), gimaster‐ dark(7), gimasterflat(7), giscience(7), gistandard(7)

VERSION

giwavecalibration 2.16.2

AUTHOR

Giraffe Pipeline <@eso.org>

BUG REPORTS

Please report any problems to @eso.org. Alternatively, you may send a report to the ESO User Support Department <@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
giwavecalibration 2.16.2 GIWAVECALIBRATION(7)
This manual Reference Other manuals
giwavecalibration(7) referred by giframestack(7) | gimasterbias(7) | gimasterdark(7) | gimasterflat(7) | giscience(7) | gistandard(7)
refer to giframestack(7) | gimasterbias(7) | gimasterflat(7) | giscience(7) | gistandard(7)
Download raw manual
Index giraf recipes (+7) giwavecalibration (+1) № 7 (+1560)
Go top