|SExtractor| accepts images stored in |FITS|_ :cite:`1981AAS_44_363W`.
Both "Basic FITS" (one single header and one single body) and |MEF|_
files are recognized.
Binary |SExtractor| catalogs produced from |MEF| images are |MEF| files themselves.
If the catalog output format is set to ASCII, all catalogs from the individual extensions are concatenated in one big file; the :param:`EXT_NUMBER` catalog parameter can be used to tell which extension the detection belongs to.
.. important::
Contrary to most other astronomy packages, |SExtractor| does not rely on the `FITSIO <https://heasarc.gsfc.nasa.gov/fitsio/>`_ library and instead uses its own library for managing |FITS| files. As a consequence, some features of |FITS| such as image compression/tiling are not supported at this time.
For images with :math:`{\rm NAXIS} > 2`, only the first data-plane is loaded.
In |SExtractor|, as in all similar programs, |FITS| axis #1 is traditionally
referred to as the *x* axis, and |FITS| axis #2 as the *y* axis.
Double image mode
~~~~~~~~~~~~~~~~~
When the pixel data for a given field are available using the same pixel grid in several photometric channels, it is often best to measure object characteristics, like magnitudes, exactly at the same positions and through the same apertures for the different channels.
This to derive precise color indices for example.
|SExtractor| makes this possible by providing a special mode dubbed "double image mode" where detections are made on one image while measurements are carried out on another. Both images must have the exact same dimensions, obviously.
By repeatedly running |SExtractor| with various "measurement images" while keeping the same "detection image", one ends up with a set of catalogs having the same sources measured through different channels.
The detection image will generally be chosen in the band where the data are the deepest.
Alternatively, using a ":math:`\chi2` image" :cite:`1999AJ_117_68S` [#swarpchi2]_ as a detection image, will allow most of the sources present in at least one channel to be detected and measured.
Double image mode is automatically engaged when providing |SExtractor| with two images instead of one:
.. code-block:: console
$ sex detection.fits,measurement.fits
A space may be used instead of a coma. In the example above, :file:`detection.fits` is used as a detection image, while measurements are carried out on :file:`measurement.fits`.
.. [#swarpchi2]
:math:`\chi2` images can easily be generated using the |SWarp|_ package :cite:`2002ASPC_281_228B`.
In addition to the configuration file detailed above, |SExtractor| requires a file containing the list of measurements ("catalog parameters") that will be listed in the output catalog for every detection. This allows the software to compute only the measurements that are needed. The name of this catalog parameter file is traditionally suffixed with :file:`.param`, and must be specified using the :param:`PARAMETERS_NAME` config parameter. The full set of parameters can be queried with the command
In addition to the configuration file detailed above, |SExtractor| requires a file containing the list of measurements ("catalog parameters") that will be listed in the output catalog for every detection. This allows the software to compute only the measurements that are needed. The name of this catalog parameter file is traditionally suffixed with :file:`.param`, and must be specified using the :param:`PARAMETERS_NAME` config parameter. The full set of parameters can be queried with the command
...
@@ -12,7 +12,7 @@ In addition to the configuration file detailed above, |SExtractor| requires a fi
...
@@ -12,7 +12,7 @@ In addition to the configuration file detailed above, |SExtractor| requires a fi
$ sex -dp
$ sex -dp
Format
Format
------
~~~~~~
The format of the catalog parameter list is ASCII, and there must be
The format of the catalog parameter list is ASCII, and there must be
*a single keyword per line*. Presently two kinds of keywords are
*a single keyword per line*. Presently two kinds of keywords are
...
@@ -23,7 +23,7 @@ in the output catalog is identical to that of the keywords in the parameter
...
@@ -23,7 +23,7 @@ in the output catalog is identical to that of the keywords in the parameter
list. Comments are allowed, they must begin with a :param:`#`.
list. Comments are allowed, they must begin with a :param:`#`.
Variants
Variants
--------
~~~~~~~~
For many catalog parameters, especially those related to flux,
For many catalog parameters, especially those related to flux,
position, or shape, several variants of the same measurement are
position, or shape, several variants of the same measurement are
...
@@ -32,7 +32,7 @@ available:
...
@@ -32,7 +32,7 @@ available:
.. _fluxes_and_magnitudes:
.. _fluxes_and_magnitudes:
Fluxes and magnitudes
Fluxes and magnitudes
~~~~~~~~~~~~~~~~~~~~~
"""""""""""""""""""""
Fluxes may be expressed in counts (|ADU|\ s) or as Pogson :cite:`1856MNRAS_17_12P` magnitudes.
Fluxes may be expressed in counts (|ADU|\ s) or as Pogson :cite:`1856MNRAS_17_12P` magnitudes.
Flux measurements in |ADU|\ s are prefixed with :param:`FLUX_`, for example: :param:`FLUX_AUTO`, :param:`FLUX_ISO`, etc.
Flux measurements in |ADU|\ s are prefixed with :param:`FLUX_`, for example: :param:`FLUX_AUTO`, :param:`FLUX_ISO`, etc.
...
@@ -48,7 +48,7 @@ The ``MAG_ZEROPOINT`` configuration parameter sets the magnitude zero-point of m
...
@@ -48,7 +48,7 @@ The ``MAG_ZEROPOINT`` configuration parameter sets the magnitude zero-point of m
\end{array}\right.
\end{array}\right.
Flux and magnitude uncertainties
Flux and magnitude uncertainties
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
""""""""""""""""""""""""""""""""
Flux uncertainties (error estimates) follow a scheme similar to that of fluxes.
Flux uncertainties (error estimates) follow a scheme similar to that of fluxes.
They are prefixed with :param:`FLUXERR_`, as in :param:`FLUXERR_AUTO` or :param:`FLUXERR_ISO`.
They are prefixed with :param:`FLUXERR_`, as in :param:`FLUXERR_AUTO` or :param:`FLUXERR_ISO`.
...
@@ -64,7 +64,7 @@ They are computed using
...
@@ -64,7 +64,7 @@ They are computed using
\end{array}\right.
\end{array}\right.
Pixel values and Surface brightnesses
Pixel values and Surface brightnesses
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
"""""""""""""""""""""""""""""""""""""
Pixel values (averaged or not) :math:`p` are expressed in counts (|ADU|\ s).
Pixel values (averaged or not) :math:`p` are expressed in counts (|ADU|\ s).
There is no specific prefix (:param:`THRESHOLD`, :param:`BACKGROUND`, :param:`FLUX_MAX`, etc.).
There is no specific prefix (:param:`THRESHOLD`, :param:`BACKGROUND`, :param:`FLUX_MAX`, etc.).
...
@@ -84,7 +84,7 @@ Setting ``PIXEL_SCALE`` to 0 instructs |SExtractor| to compute the pixel scale f
...
@@ -84,7 +84,7 @@ Setting ``PIXEL_SCALE`` to 0 instructs |SExtractor| to compute the pixel scale f
.. _coord_suffix:
.. _coord_suffix:
Positions and shapes
Positions and shapes
~~~~~~~~~~~~~~~~~~~~
""""""""""""""""""""
Positions, distances and position angles are computed in pixel coordinates. They may be expressed in image pixels, world coordinates, or in celestial coordinates, depending on the suffix:
Positions, distances and position angles are computed in pixel coordinates. They may be expressed in image pixels, world coordinates, or in celestial coordinates, depending on the suffix:
...
@@ -96,7 +96,7 @@ Positions, distances and position angles are computed in pixel coordinates. They
...
@@ -96,7 +96,7 @@ Positions, distances and position angles are computed in pixel coordinates. They
.. _world_coords:
.. _world_coords:
:param:`_WORLD`
:param:`_WORLD`
Measurements are given in so-called “world coordinates”, converted from pixel coordinates using the local Jacobian of the transformation between both systems. This requires |WCS| metadata :cite:`2002AA_395_1061G` to be present in the FITS image header(s). Position angles are counted from the first world axis, positive towards the second world axis.
Measurements are given in so-called “world coordinates”, converted from pixel coordinates using the local Jacobian of the transformation between both systems. This requires |WCS|_ metadata :cite:`2002AA_395_1061G` to be present in the FITS image header(s). Position angles are counted from the first world axis, positive towards the second world axis.
.. _sky_coords:
.. _sky_coords:
...
@@ -111,8 +111,12 @@ Positions, distances and position angles are computed in pixel coordinates. They
...
@@ -111,8 +111,12 @@ Positions, distances and position angles are computed in pixel coordinates. They
.. note::
.. note::
Conversion to :param:`_FOCAL` coordinates is available only for a limited subset of measurements.
Conversion to :param:`_FOCAL` coordinates is available only for a limited subset of measurements.
.. important::
The |WCS| library currently implemented in |SExtractor| is a customized version of an early implementation (v1.1.1) by Calabretta.
Several projections from later versions and alternative astrometric descriptions such as `AST <https://starlink.eao.hawaii.edu/starlink/AST>`_ or `that of original DSS plates <https://archive.stsci.edu/dss/booklet_n.pdf>`_ are not supported at this time.
Measurement parameter list
Measurement parameter list
--------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~
Below is an exhaustive list of all the measurement parameters known to
Below is an exhaustive list of all the measurement parameters known to
|SExtractor|. Please refer to the next sections for a detailed description
|SExtractor|. Please refer to the next sections for a detailed description
Any `-Parameter Value` statement in the command-line overrides the corresponding definition in the configuration-file or any default value (see below).
Any `-Parameter Value` statement in the command-line overrides the corresponding definition in the configuration file or any default value (see :ref:`configuration section<config_file>`).
Output files
------------
Diagnostic files
~~~~~~~~~~~~~~~~
Two types of files can be generated by |SExtractor|, providing diagnostics
about the source extraction process:
* "Check-images" are FITS files containing raster images such as maps of the
background model, apertures, etc.. The configuration parameters
``CHECKIMAGE_TYPE`` and ``CHECKIMAGE_NAME`` allow the user to provide a list
of check-image types and file names, respectively, to be produced by
|SExtractor|. A complete list of available check-image types is given in
§[chap:paramlist].
* An |XML|_ file providing a processing summary and various statistics in
|VOTable|_ format is written if the ``WRITE_XML`` switch is set to ``Y``
(the default). The ``XML_NAME`` parameter can be used to change the default
file name :file:`sex.xml`. The |XML| file can be displayed with any recent
web browser; the |XSLT| stylesheet installed together with |SExtractor| will
automatically translate it into a dynamic, user-friendly web-page.
For more advanced usages (e.g., access from a
remote web server), alternative |XSLT| translation URLs may be specified
