---
name: "fors_photometry"
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_photometry"
---

# fors\_photometry(7)

Compute corrected flatfield

## NAME

fors\_photometry - Compute corrected flatfield

## SYNOPSIS

esorex **fors\_photometry** \[OPTIONS\] FILE.sof

## DESCRIPTION

Input files:\
   DO category:               Type:       Explanation:             Number:\
   PHOT\_TABLE                 FITS table  Expected extinction params  1\
   ALIGNED\_PHOT               FITS table  Photometry                  1+\
   MASTER\_SKY\_FLAT\_IMG        FITS image  Master flat field           1

Output files:\
   DO category:               Data type:  Explanation:\
   PHOT\_COEFF\_TABLE           FITS image  Observed extinction coefficients\
   CORRECTION\_MAP             FITS image  Correction map (magnitude)\
   CORRECTION\_FACTOR          FITS image  Correction map (flux)\
   MASTER\_FLAT\_IMG            FITS image  Corrected master flat field

## OPTIONS

- **--fitz** *\<bool\>*

  Fit zeropoint (bool; default: True). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.fitz** \[default = *True*\].

- **--fit\_all\_mag** *\<bool\>*

  Always fit star magnitudes (bool; default: False). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.fit\_all\_mag** \[default = *False*\].

- **--fite** *\<str\>*

  Fit atmospheric extinctions (str; default: ´pernight´). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.fite** \[default = *pernight*\].

- **--fitc** *\<bool\>*

  Fit color correction term (bool; default: False). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.fitc** \[default = *False*\].

- **--use\_all\_stars** *\<bool\>*

  Use also non-standard stars to fit polynomial f (bool; default: False). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.use\_all\_stars** \[default = *False*\].

- **--degreef1** *\<int\>*

  FLatfield correction map polynomial degree (x) (int; default: 0). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.degreef1** \[default = *0*\].

- **--degreef2** *\<int\>*

  Flatfield correction map polynomial degree (y), or negative for triangular coefficient matrix (int; default: -1). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.degreef2** \[default = *-1*\].

- **--degreep** *\<int\>*

  Extinction/color coupling degree (int; default: 0). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.degreep** \[default = *0*\].

- **--mjd\_obs\_target** *\<float\>*

  MJD-OBS used to match the raw frame from which EXTINCTION\_PER\_NIGHT and PHOT\_COEFF inherit MJD-OBS. If negative theMJD-OBS of the first raw frame isused (float; default: -1.0). The full name of this option for the EsoRex configuration file is **fors.fors\_photometry.mjd\_obs\_target** \[default = *-1.0*\].

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\_science*(7)](/fors_img_science/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\_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\_photometry 5.5.6

## AUTHOR

Jonas M. Larsen \<usd-help@eso.org\>

## BUG REPORTS

Please report any problems to usd-help@eso.org. Alternatively, you may send a report to the ESO User Support Department \<usd-help@eso.org\>.

## 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
