--- name: "fors_img_science" section: "7" platform: "linux" package: "cpl-plugin-fors-doc" version: "5.5.6+dfsg-4" release: "Debian 11 (Bullseye)" platforms: ["linux"] url: "https://new.carta.tech/fors_img_science" --- # fors\_img\_science(7) Reduce imaging scientific exposure ## NAME fors\_img\_science - Reduce imaging scientific exposure ## SYNOPSIS esorex **fors\_img\_science** \[OPTIONS\] FILE.sof ## DESCRIPTION Input files:\ DO category: Type: Explanation: Number:\ SCIENCE\_IMG Raw Science image 1\ MASTER\_BIAS FITS image Master bias 1\ MASTER\_SKY\_FLAT\_IMG FITS image Master sky flat field 1\ PHOT\_COEFF\_TABLE FITS table Observed extinction coefficients 0+\ EXTINCTION\_PER\_NIGHT FITS table Extinction per night 0+\ STATIC\_PHOT\_COEFF\_TABLE FITS table Static filters photometry coefficients 0+\ DETECTOR\_ILLUMINATED\_REGION FITS table Table with detector illuminated regions 0+ Output files:\ DO category: Data type: Explanation:\ SCIENCE\_REDUCED\_IMG FITS image Reduced science image\ PHOT\_BACKGROUND\_SCI\_IMG FITS image Reduced science image background\ SOURCES\_SCI\_IMG FITS image Unfiltered SExtractor output\ OBJECT\_TABLE\_SCI\_IMG FITS table Extracted sources properties\ SCIENCE\_REDUCED\_IMG\_IDP FITS image Reduced science image in IDP-compliant format\ SCIENCE\_REDUCED\_WEIGHT\_IDP FITS image Ancillary file with the weights for IDP the image\ SCIENCE\_REDUCED\_ERR\_IDP FITS image Ancillary file with the errors for IDP the image ## OPTIONS - **--magsyserr** *\* Systematic error in magnitude (float; default: 0.01). The full name of this option for the EsoRex configuration file is **fors.fors\_img\_science.magsyserr** \[default = *0.01*\]. - **--sex\_exe** *\* SExtractor executable (str; default: ´/usr/bin/source-extractor´). The full name of this option for the EsoRex configuration file is **fors.fors\_img\_science.sex\_exe** \[default = */usr/bin/source-extractor*\]. - **--sex\_config** *\* SExtractor configuration file (str; default: ´/usr/share/cpl- plugins/fors-5.5.6/config/fors.sex´). The full name of this option for the EsoRex configuration file is **fors.fors\_img\_science.sex\_config** \[default = */usr/share/cpl-plugins/fors-5.5.6/config/fors.sex*\]. - **--sex\_mag** *\* SExtractor magnitude (str; default: ´MAG\_APER´). The full name of this option for the EsoRex configuration file is **fors.fors\_img\_science.sex\_mag** \[default = *MAG\_APER*\]. - **--sex\_magerr** *\* SExtractor magnitude error (str; default: ´MAGERR\_APER´). The full name of this option for the EsoRex configuration file is **fors.fors\_img\_science.sex\_magerr** \[default = *MAGERR\_APER*\]. - **--sex\_radius** *\* Background error map median filter radius (unbinned pixels) (int; default: 64). The full name of this option for the EsoRex configuration file is **fors.fors\_img\_science.sex\_radius** \[default = *64*\]. - **--idp\_generate** *\* If TRUE compliant IDP science products are generated (bool; default: False). The full name of this option for the EsoRex configuration file is **fors.fors\_img\_science.idp\_generate** \[default = *False*\]. - **--idp\_weights\_threshold** *\* Every pixel in the MASTER\_SKY\_FLAT\_IMG below the threshold will be put to 0 in the weight-map, 1 otherwise. Ignored if IDP generation is not requested (float; default: 0.5). The full name of this option for the EsoRex configuration file is **fors.fors\_img\_science.idp\_weights\_threshold** \[default = *0.5*\]. 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 fors pipeline can be downloaded as a PDF file using the following URL: - **ftp://ftp.eso.org/pub/dfs/pipelines/fors/fors-pipeline-manual-4.9.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 fors pipeline are [*fors\_align\_sky*(7)](/fors_align_sky/7.md), [*fors\_align\_sky\_lss*(7)](/fors_align_sky_lss/7.md), [*fors\_bias*(7)](/fors_bias/7.md), [*fors\_calib*(7)](/fors_calib/7.md), [*fors\_config*(7)](/fors_config/7.md), [*fors\_dark*(7)](/fors_dark/7.md), [*fors\_detect\_objects*(7)](/fors_detect_objects/7.md), [*fors\_detect\_spectra*(7)](/fors_detect_spectra/7.md), [*fors\_extract*(7)](/fors_extract/7.md), [*fors\_extract\_objects*(7)](/fors_extract_objects/7.md), [*fors\_extract\_slits*(7)](/fors_extract_slits/7.md), [*fors\_flatfield*(7)](/fors_flatfield/7.md), [*fors\_img\_screen\_flat*(7)](/fors_img_screen_flat/7.md), [*fors\_img\_sky\_flat*(7)](/fors_img_sky_flat/7.md), [*fors\_normalise\_flat*(7)](/fors_normalise_flat/7.md), [*fors\_photometry*(7)](/fors_photometry/7.md), [*fors\_pmos\_calib*(7)](/fors_pmos_calib/7.md), [*fors\_pmos\_extract*(7)](/fors_pmos_extract/7.md), [*fors\_pmos\_science*(7)](/fors_pmos_science/7.md), [*fors\_remove\_bias*(7)](/fors_remove_bias/7.md), [*fors\_resample*(7)](/fors_resample/7.md), [*fors\_science*(7)](/fors_science/7.md), [*fors\_spec\_mflat*(7)](/fors_spec_mflat/7.md), [*fors\_subtract\_sky*(7)](/fors_subtract_sky/7.md), [*fors\_subtract\_sky\_lss*(7)](/fors_subtract_sky_lss/7.md), [*fors\_sumflux*(7)](/fors_sumflux/7.md), [*fors\_trace\_flat*(7)](/fors_trace_flat/7.md), [*fors\_wave\_calib*(7)](/fors_wave_calib/7.md), [*fors\_wave\_calib\_lss*(7)](/fors_wave_calib_lss/7.md), [*fors\_zeropoint*(7)](/fors_zeropoint/7.md) ## VERSION fors\_img\_science 5.5.6 ## AUTHOR ESO PPS Group \ ## BUG REPORTS Please report any problems to usd-help@eso.org. Alternatively, you may send a report to the ESO User Support Department \. ## LICENSE This file is currently part of the FORS Instrument Pipeline Copyright (C) 2002-2011 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