Commit c8aa6063 authored by Chiara Marmo's avatar Chiara Marmo
Browse files

Weighting section translated into sphinx. Some ref to other sections are still missing.

parent 8cf0449a
.. File Using.rst .. File Using.rst
.. _using-sextractor:
Using SExtractor Using SExtractor
================ ================
......
...@@ -27,6 +27,8 @@ and constant over the image. In that case one can apply a simple *fudge factor* ...@@ -27,6 +27,8 @@ and constant over the image. In that case one can apply a simple *fudge factor*
correlations on small scales. This proves to be a good approximation in general, although it certainly leads to correlations on small scales. This proves to be a good approximation in general, although it certainly leads to
underestimations for the smallest patterns. underestimations for the smallest patterns.
.. _weigth-map-format:
Weight-map formats Weight-map formats
------------------ ------------------
...@@ -36,27 +38,32 @@ Those weight-maps can either be read from a FITS file, whose name is specified b ...@@ -36,27 +38,32 @@ Those weight-maps can either be read from a FITS file, whose name is specified b
or computed internally. or computed internally.
Valid ``WEIGHT_TYPE`` values are: Valid ``WEIGHT_TYPE`` values are:
* ``NONE`` : No weighting is applied. The related ``WEIGHT_IMAGE`` and ``WEIGHT_THRESH`` (see below) parameters are ignored. * ``NONE`` :
No weighting is applied. The related ``WEIGHT_IMAGE`` and ``WEIGHT_THRESH`` (see below) parameters are ignored.
* ``BACKGROUND`` : the science image itself is used to compute internally a variance map (the related ``WEIGHT_IMAGE`` * ``BACKGROUND`` :
the science image itself is used to compute internally a variance map (the related ``WEIGHT_IMAGE``
parameter is ignored). Robust (:math:`3\sigma`-clipped) variance estimates are first computed within the same parameter is ignored). Robust (:math:`3\sigma`-clipped) variance estimates are first computed within the same
background meshes as those described in ?? [12] (The mesh-filtering procedures act on the variance map, too.). background meshes as those described in ?? [#f1].
The resulting low-resolution variance map is then bicubic-spline-interpolated on the fly to produce The resulting low-resolution variance map is then bicubic-spline-interpolated on the fly to produce
the actual full-size variance map. the actual full-size variance map.
A check-image with ``CHECKIMAGE_TYPE`` ``MINIBACK_RMS`` can be requested to examine the low-resolution variance map. A check-image with ``CHECKIMAGE_TYPE`` ``MINIBACK_RMS`` can be requested to examine the low-resolution variance map.
* ``MAP_RMS`` : the FITS image specified by the ``WEIGHT_IMAGE`` file name must contain a weight-map in units of * ``MAP_RMS`` :
the FITS image specified by the ``WEIGHT_IMAGE`` file name must contain a weight-map in units of
absolute standard deviations (in ADUs per pixel). absolute standard deviations (in ADUs per pixel).
* ``MAP_VAR`` : the FITS image specified by the ``WEIGHT_IMAGE`` file name must contain a weight-map in units of * ``MAP_VAR`` :
the FITS image specified by the ``WEIGHT_IMAGE`` file name must contain a weight-map in units of
relative variance. A robust scaling to the appropriate absolute level is then performed by comparing this relative variance. A robust scaling to the appropriate absolute level is then performed by comparing this
variance map to an internal, low-resolution, absolute variance map built from the science image itself. variance map to an internal, low-resolution, absolute variance map built from the science image itself.
* ``MAP_WEIGHT`` : the FITS image specified by the ``WEIGHT_IMAGE`` file name must contain a weight-map in units of * ``MAP_WEIGHT`` :
the FITS image specified by the ``WEIGHT_IMAGE`` file name must contain a weight-map in units of
relative weights. relative weights.
The data are converted to variance units (by definition variance :math:`\propto\frac{1}{weight}`), The data are converted to variance units (by definition variance :math:`\propto\frac{1}{weight}`),
and scaled as for ``MAP_VAR``. and scaled as for ``MAP_VAR``.
...@@ -100,8 +107,8 @@ Weight-maps modify the working of |SExtractor| in the following respects: ...@@ -100,8 +107,8 @@ Weight-maps modify the working of |SExtractor| in the following respects:
Combining weight maps Combining weight maps
--------------------- ---------------------
All the weighting options listed in ?? can be applied separately to detection and measurement images (??), All the weighting options listed in :ref:`weigth-map-format` can be applied separately to detection and measurement images
even if some combinations may not always make sense. (:ref:`using-sextractor`), even if some combinations may not always make sense.
For instance, the following set of configuration lines: For instance, the following set of configuration lines:
``WEIGHT_IMAGE`` *rms.fits*, *weight.fits* ``WEIGHT_IMAGE`` *rms.fits*, *weight.fits*
...@@ -110,7 +117,7 @@ For instance, the following set of configuration lines: ...@@ -110,7 +117,7 @@ For instance, the following set of configuration lines:
will load the FITS file *rms.fits* and use it as an RMS map for adjusting the detection threshold and cleaning, will load the FITS file *rms.fits* and use it as an RMS map for adjusting the detection threshold and cleaning,
while the *weight.fits* weight map will only be used for scaling the error estimates on measurements. while the *weight.fits* weight map will only be used for scaling the error estimates on measurements.
This can be done in single- as well as in dual-image mode (??). This can be done in single- as well as in dual-image mode (:ref:`using-sextractor`).
``WEIGHT_IMAGE`` can be ignored for ``BACKGROUND`` ``WEIGHT_TYPE``. ``WEIGHT_IMAGE`` can be ignored for ``BACKGROUND`` ``WEIGHT_TYPE``.
It is of course possible to use weight-maps for detection or for measurement only. It is of course possible to use weight-maps for detection or for measurement only.
The following configuration: The following configuration:
...@@ -121,5 +128,9 @@ The following configuration: ...@@ -121,5 +128,9 @@ The following configuration:
will apply weighting only for measurements; detection and cleaning operations will remain unaffected. will apply weighting only for measurements; detection and cleaning operations will remain unaffected.
.. rubric:: Footnotes
.. [#f1] The mesh-filtering procedures act on the variance map, too.
.. include:: keys.rst .. include:: keys.rst
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment