.TH FORS_WAVE_CALIB_LSS "7" "5.5.7" "fors_wave_calib_lss" "fors recipes" .SH NAME fors_wave_calib_lss \- Derive dispersion relation from long\-slit arc lamp frame .SH SYNOPSIS esorex .B fors_wave_calib_lss [OPTIONS] FILE.sof .SH DESCRIPTION This recipe is used to wavelength calibrate one long slit spectrum, i.e., a FORS spectral obtained either in LSS mode or in MOS/MXU mode with all slits at the same offset. A pattern\-matching algorithm is applied as in recipe fors_detect_spectra. For more details on this data reduction strategy please refer to the FORS Pipeline User\'s Manual. .PP Note that specifying an input GRISM_TABLE will set some of the recipe configuration parameters to default values valid for a particular grism. .PP In the table below the LSS acronym can be alternatively read as MOS or MXU. .PP Input files: DO category: Type: Explanation: Required: LAMP_UNBIAS_LSS Calib Arc lamp exposure Y MASTER_LINECAT Calib Line catalog Y GRISM_TABLE Calib Grism table . .PP Output files: DO category: Data type: Explanation: REDUCED_LAMP_LSS FITS image Calibrated arc lamp exposure DISP_COEFF_LSS FITS table Inverse dispersion coefficients DISP_RESIDUALS_LSS FITS image Image of modeling residuals WAVELENGTH_MAP_LSS FITS image Wavelengths mapped on CCD SLIT_LOCATION_LSS FITS image Background subtracted arc frame SPECTRAL_RESOLUTION_LSS FITS table Spectral resolution table .SH OPTIONS .TP \fB\-\-dispersion\fR \fI\fR Expected spectral dispersion (Angstrom/pixel) (float; default: 0.0). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.dispersion\fR [default = \fI0.0\fR]. .TP \fB\-\-peakdetection\fR \fI\fR Initial peak detection threshold (ADU) (float; default: 0.0). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.peakdetection\fR [default = \fI0.0\fR]. .TP \fB\-\-wdegree\fR \fI\fR Degree of wavelength calibration polynomial (int; default: 0). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.wdegree\fR [default = \fI0\fR]. .TP \fB\-\-wradius\fR \fI\fR Search radius if iterating pattern\-matching with first\-guess method (int; default: 4). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.wradius\fR [default = \fI4\fR]. .TP \fB\-\-wreject\fR \fI\fR Rejection threshold in dispersion relation fit (pixel) (float; default: 0.7). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.wreject\fR [default = \fI0.7\fR]. .TP \fB\-\-wcolumn\fR \fI\fR Name of line catalog table column with wavelengths (str; default: \'WLEN\'). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.wcolumn\fR [default = \fIWLEN\fR]. .TP \fB\-\-startwavelength\fR \fI\fR Start wavelength in spectral extraction (float; default: 0.0). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.startwavelength\fR [default = \fI0.0\fR]. .TP \fB\-\-endwavelength\fR \fI\fR End wavelength in spectral extraction (float; default: 0.0). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.endwavelength\fR [default = \fI0.0\fR]. .TP \fB\-\-wmode\fR \fI\fR Interpolation mode of wavelength solution (0 = no interpolation, 1 = fill gaps, 2 = global model) (int; default: 2). The full name of this option for the EsoRex configuration file is \fBfors.fors_wave_calib_lss.wmode\fR [default = \fI2\fR]. .PP 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. .SH SEE ALSO The full documentation for the fors pipeline can be downloaded as a PDF file using the following URL: .IP .B ftp://ftp.eso.org/pub/dfs/pipelines/fors/fors\-pipeline\-manual\-4.9.pdf .PP An overview over the existing ESO pipelines can be found on the web page \fBhttps://www.eso.org/sci/software/pipelines/\fR. .PP Basic documentation about the EsoRex program can be found at the esorex (1) man page. .PP It is possible to call the pipelines from python using the python\-cpl package. See \fBhttps://packages.python.org/python\-cpl/index.html\fR for further information. .PP The other recipes of the fors pipeline are .IR fors_align_sky (7), .IR fors_align_sky_lss (7), .IR fors_bias (7), .IR fors_calib (7), .IR fors_config (7), .IR fors_dark (7), .IR fors_detect_objects (7), .IR fors_detect_spectra (7), .IR fors_extract (7), .IR fors_extract_objects (7), .IR fors_extract_slits (7), .IR fors_flatfield (7), .IR fors_img_science (7), .IR fors_img_screen_flat (7), .IR fors_img_sky_flat (7), .IR fors_normalise_flat (7), .IR fors_photometry (7), .IR fors_pmos_calib (7), .IR fors_pmos_extract (7), .IR fors_pmos_science (7), .IR fors_remove_bias (7), .IR fors_resample (7), .IR fors_science (7), .IR fors_spec_mflat (7), .IR fors_subtract_sky (7), .IR fors_subtract_sky_lss (7), .IR fors_sumflux (7), .IR fors_trace_flat (7), .IR fors_wave_calib (7), .IR fors_zeropoint (7) .SH VERSION fors_wave_calib_lss 5.5.7 .SH AUTHOR Carlo Izzo .SH BUG REPORTS Please report any problems to usd\-help@eso.org. Alternatively, you may send a report to the ESO User Support Department . .SH 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