--- name: "fors_detect_objects" 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_detect_objects" --- # fors\_detect\_objects(7) Detect objects in slit spectra ## NAME fors\_detect\_objects - Detect objects in slit spectra ## SYNOPSIS esorex **fors\_detect\_objects** \[OPTIONS\] FILE.sof ## DESCRIPTION This recipe is used to detect scientific objects spectra on a resampled image produced with recipe fors\_resample. Please refer to the FORS Pipeline User´s Manual for more details on object detection. In the table below the MXU acronym can be alternatively read as MOS and LSS, and SCI as STD. Input files: DO category: Type: Explanation: Required:\ MAPPED\_SCI\_MXU Calib Resampled slit spectra Y\ SLIT\_LOCATION\_MXU Calib Slit location on image Y Output files: DO category: Data type: Explanation:\ OBJECT\_TABLE\_SCI\_MXU FITS table Object positions in slit spectra ## OPTIONS - **--slit\_margin** *\* Number of pixels to exclude at each slit in object detection and extraction (int; default: 3). The full name of this option for the EsoRex configuration file is **fors.fors\_detect\_objects.slit\_margin** \[default = *3*\]. - **--ext\_radius** *\* Maximum extraction radius for detected objects (pixel) (int; default: 6). The full name of this option for the EsoRex configuration file is **fors.fors\_detect\_objects.ext\_radius** \[default = *6*\]. - **--cont\_radius** *\* Minimum distance at which two objects of equal luminosity do not contaminate each other (pixel) (int; default: 0). The full name of this option for the EsoRex configuration file is **fors.fors\_detect\_objects.cont\_radius** \[default = *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\_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\_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\_detect\_objects 5.5.6 ## AUTHOR Carlo Izzo \ ## 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-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