--- name: "sinfo_rec_mflat" section: "7" platform: "linux" package: "cpl-plugin-sinfo-doc" version: "2.5.2+dfsg-2" release: "Debian 8 (Jessie)" platforms: ["linux"] url: "https://new.carta.tech/sinfo_rec_mflat" --- # sinfo\_rec\_mflat(7) Master flat determination ## NAME sinfo\_rec\_mflat - Master flat determination ## SYNOPSIS esorex **sinfo\_rec\_mflat** \[OPTIONS\] FILE.sof ## DESCRIPTION This recipe reduce normal raw flat fields. The input files are a set of flat fields with tag FLAT\_LAMP optionally one may have in input also several bad pixel maps to be coadded. The main products are a master flat field (PRO.CATG=MASTER\_FLAT\_LAMP) image a bad pixel map (PRO.CATG=BP\_MAP\_NO), a master bad pixel map (PRO.CATG=MASTER\_BP\_MAP) resulting by the coaddition of all bad pixel maps. ## OPTIONS - **--gen-overpar** *\* Overwrite DRS ini parameters: (bool; default: True). The full name of this option for the EsoRex configuration file is **sinfoni.general.overwrite\_parameters** \[default = *True*\]. - **--lc\_sw** *\* Correct for bad lines introduced by instrument software: (bool; default: False). The full name of this option for the EsoRex configuration file is **sinfoni.general.lc\_sw** \[default = *False*\]. - **--lc\_kappa** *\* Kappa sigma value (long; default: 18). The full name of this option for the EsoRex configuration file is **sinfoni.general.lc\_kappa** \[default = *18*\]. - **--lc\_filt\_rad** *\* Filtering radii applied during median filter. Should be small (long; default: 3). The full name of this option for the EsoRex configuration file is **sinfoni.general.lc\_filt\_rad** \[default = *3*\]. - **--product-density** *\* Density of pipeline products: 0 (low), 1 (low+skycor), 2 (med-QC), 3 (high-debug+skycor) (long; default: 2). The full name of this option for the EsoRex configuration file is **sinfoni.product.density** \[default = *2*\]. - **--bp\_norm-s\_factor** *\* Threshold Sigma Factor: to remove the column intensity tilt only pixels which lie within a defined noiselimit are used to fit a straight line (float; default: 5.0). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.sigma\_factor** \[default = *5.0*\]. - **--bp\_norm-method\_ind** *\* Bad pixel Method Index1: median of nearest neighbors,2: absolute distances check, 3: mean of nearest spectral neighbors (long; default: 1). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.method\_index** \[default = *1*\]. - **--bp\_norm-fct** *\* Factor: if \|pixel - median\| \> factor \* standard deviation -\> then the pixel value is replaced by the median of the 8 nearest neighbors (float; default: 10.0). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.factor** \[default = *10.0*\]. - **--bp\_norm-it** *\* Iterations: number of iterations to of median filtering to find bad pixel clusters (long; default: 8). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.iterations** \[default = *8*\]. - **--bp\_norm-lo\_rej** *\* low\_rejection: percentage of rejected low intensity pixels before averaging (float; default: 0.1). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.low\_rejection** \[default = *0.1*\]. - **--bp\_norm-hi\_rej** *\* high\_rejection: percentage of rejected high intensity pixels before averaging (float; default: 0.1). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.high\_rejection** \[default = *0.1*\]. - **--bp\_norm-llx** *\* llx: to compute image statistics on a rectangularzone of the image the coordinates of the rectangle are needed:lower left x coordinate (long; default: 270). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.llx** \[default = *270*\]. - **--bp\_norm-lly** *\* lly: to compute image statistics on a rectangularzone of the image the coordinates of the rectangle are needed:lower left y coordinate (long; default: 1000). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.lly** \[default = *1000*\]. - **--bp\_norm-urx** *\* urx: to compute image statistics on a rectangularzone of the image the coordinates of the rectangle are needed:upper right x coordinate (long; default: 310). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.urx** \[default = *310*\]. - **--bp\_norm-ury** *\* ury: to compute image statistics on a rectangularzone of the image the coordinates of the rectangle are needed:upper right y coordinate (long; default: 1200). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.ury** \[default = *1200*\]. - **--bp\_norm-thr\_ind** *\* Threshold Index: indicator that indicates if the values beyond a threshold deviation from the mean are flagged as bad pixels (bool; default: True). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.threshold\_index** \[default = *True*\]. - **--bp\_norm-mean\_fct** *\* Mean Factor: factor to the clean standard deviation to define the threshold deviation from the clean mean (float; default: 100.0). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.mean\_factor** \[default = *100.0*\]. - **--bp\_norm-min\_cut** *\* the minimum value of real data (float; default: 0.0). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.min\_cut** \[default = *0.0*\]. - **--bp\_norm-max\_cut** *\* the minimum value of real data (float; default: 50000.0). The full name of this option for the EsoRex configuration file is **sinfoni.bp\_norm.max\_cut** \[default = *50000.0*\]. - **--lamp\_flats-lo\_rej** *\* lower rejection: percentage of rejected low intensity pixels before averaging (float; default: 0.1). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.low\_rejection** \[default = *0.1*\]. - **--lamp\_flats-hi\_rej** *\* high rejection: percentage of rejected high intensity pixels before averaging (float; default: 0.1). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.high\_rejection** \[default = *0.1*\]. - **--lamp\_flats-interpol\_index** *\* Interpolation index switch: indicator if the bad pixels of the flatfield should be interpolated (bool; default: False). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.interpol\_index** \[default = *False*\]. - **--lamp\_flats-max\_rad** *\* Max Rad: maximal pixel distance from bad pixel to take valid pixels (long; default: 4). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.max\_rad** \[default = *4*\]. - **--lamp\_flats-bad\_ind** *\* indicator if a bad pixel mask should be generated or not (bool; default: False). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.bad\_ind** \[default = *False*\]. - **--lamp\_flats-sigma\_factor** *\* Sigma Factor: factor of the sigma noise limit; to remove the column intensity tilt only pixels which lie within a defined noise limit are used to fit a straight line (float; default: 5.0). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.sigma\_factor** \[default = *5.0*\]. - **--lamp\_flats-factor** *\* Factor: if \|pixel - median\| \> factor \* standard deviation -\> then the pixel value is replaced by the median of the 8 nearest neighbors (float; default: 3.0). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.factor** \[default = *3.0*\]. - **--lamp\_flats-iterations** *\* Iterations: number of iterations to of median filtering to find bad pixel clusters (long; default: 8). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.iterations** \[default = *8*\]. - **--lamp\_flats-bad\_lo\_rej** *\* low rejection: Percentage for bad pixel low rejection (float; default: 10.0). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.bad\_low\_rejection** \[default = *10.0*\]. - **--lamp\_flats-bad\_hi\_rej** *\* high rejection: Percentage for bad pixel high rejection (float; default: 10.0). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.bad\_high\_rejection** \[default = *10.0*\]. - **--lamp\_flats-llx** *\* Lower Lext X corner (long; default: 1350). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.llx** \[default = *1350*\]. - **--lamp\_flats-lly** *\* Lower Lext Y corner (long; default: 1000). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.lly** \[default = *1000*\]. - **--lamp\_flats-rrx** *\* Upper right X corner (long; default: 1390). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.urx** \[default = *1390*\]. - **--lamp\_flats-ury** *\* Upper right Y corner (long; default: 1200). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.ury** \[default = *1200*\]. - **--lamp\_flats-tresh\_ind** *\* Treshold index: (bool; default: False). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.thresh\_ind** \[default = *False*\]. - **--lamp\_flats-mean\_factor** *\* Mean Factor: factor to the clean standard deviation to define the threshold deviation from the clean mean (float; default: 10.0). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.mean\_factor** \[default = *10.0*\]. - **--lamp\_flats-qc\_fpn\_xmin1** *\* qc\_fpn\_xmin1 (long; default: 512). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_fpn\_xmin1** \[default = *512*\]. - **--lamp\_flats-qc\_fpn\_xmax1** *\* qc\_fpn\_xmax1 (long; default: 1536). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_fpn\_xmax1** \[default = *1536*\]. - **--lamp\_flats-qc\_fpn\_ymin1** *\* qc\_fpn\_ymin1 (long; default: 512). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_fpn\_ymin1** \[default = *512*\]. - **--lamp\_flats-qc\_fpn\_ymax1** *\* qc\_fpn\_ymax1 (long; default: 1536). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_fpn\_ymax1** \[default = *1536*\]. - **--lamp\_flats-qc\_fpn\_xmin2** *\* qc\_fpn\_xmin2 (long; default: 1350). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_fpn\_xmin2** \[default = *1350*\]. - **--lamp\_flats-qc\_fpn\_xmax2** *\* qc\_fpn\_xmax2 (long; default: 1390). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_fpn\_xmax2** \[default = *1390*\]. - **--lamp\_flats-qc\_fpn\_ymin2** *\* qc\_fpn\_ymin2 (long; default: 1000). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_fpn\_ymin2** \[default = *1000*\]. - **--lamp\_flats-qc\_fpn\_ymax2** *\* qc\_fpn\_ymax2 (long; default: 1200). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_fpn\_ymax2** \[default = *1200*\]. - **--lamp\_flats-qc\_thresh\_min** *\* qc\_thresh\_min (long; default: 0). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_thresh\_min** \[default = *0*\]. - **--lamp\_flats-qc\_thresh\_max** *\* qc\_thresh\_max (long; default: 49000). The full name of this option for the EsoRex configuration file is **sinfoni.lamp\_flats.qc\_thresh\_max** \[default = *49000*\]. 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 sinfo pipeline can be downloaded as a PDF file using the following URL: - **ftp://ftp.eso.org/pub/dfs/pipelines/sinfoni/sinfo-pipeline-manual-19.0.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 sinfo pipeline are [*sinfo\_utl\_cube2spectrum*(7)](/sinfo_utl_cube2spectrum/7.md), [*sinfo\_rec\_jitter*(7)](/sinfo_rec_jitter/7.md), [*sinfo\_utl\_ima\_line\_corr*(7)](/sinfo_utl_ima_line_corr/7.md), [*sinfo\_utl\_cube\_combine*(7)](/sinfo_utl_cube_combine/7.md), [*sinfo\_utl\_bp\_mask\_add*(7)](/sinfo_utl_bp_mask_add/7.md), [*sinfo\_utl\_skycor*(7)](/sinfo_utl_skycor/7.md), [*sinfo\_utl\_spectrum\_divide\_by\_blackbody*(7)](/sinfo_utl_spectrum_divide_by_blackbody/7.md), [*sinfo\_utl\_cube\_create*(7)](/sinfo_utl_cube_create/7.md), [*sinfo\_utl\_line\_oh\_select*(7)](/sinfo_utl_line_oh_select/7.md), [*sinfo\_utl\_cube2ima*(7)](/sinfo_utl_cube2ima/7.md), [*sinfo\_utl\_spectrum\_wavelength\_shift*(7)](/sinfo_utl_spectrum_wavelength_shift/7.md), [*sinfo\_rec\_distortion*(7)](/sinfo_rec_distortion/7.md), [*sinfo\_rec\_pupil*(7)](/sinfo_rec_pupil/7.md), [*sinfo\_rec\_wavecal*(7)](/sinfo_rec_wavecal/7.md), [*sinfo\_utl\_ima\_arith*(7)](/sinfo_utl_ima_arith/7.md), [*sinfo\_utl\_cube\_arith*(7)](/sinfo_utl_cube_arith/7.md), [*sinfo\_rec\_detlin*(7)](/sinfo_rec_detlin/7.md), [*sinfo\_utl\_skymap*(7)](/sinfo_utl_skymap/7.md), [*sinfo\_rec\_mdark*(7)](/sinfo_rec_mdark/7.md) ## VERSION sinfo\_rec\_mflat 2.5.2 ## AUTHOR Andrea Modigliani \ ## BUG REPORTS Please report any problems to Andrea.Modigliani@eso.org. Alternatively, you may send a report to the ESO User Support Department \. ## LICENSE This file is part of the SINFONI Instrument Pipeline Copyright (C) 2002,2003 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