.. _DpdVisCalibratedFrameCatalog:
================================
Vis Calibrated Catalogue Product
================================
Data product name
=================
.. DataProductNameStart
DpdVisCalibratedFrameCatalog
.. DataProductNameEnd
Data product custodian
======================
.. DataProductCustodianStart
VIS
.. DataProductCustodianEnd
Name of the Schema file
=======================
.. NameSchemaStart
.. raw:: html
euc-vis-CalibratedFrameCatalog.xsd
.. NameSchemaEnd
Last Edited for DPDD Version
============================
.. NameSchemaStart
2.0
.. NameSchemaEnd
Processing Element(s) creating/using the data product
=====================================================
.. PECreatorStart
VIS_science_xml_out
.. PECreatorEnd
Processing function using the data product
==========================================
.. PFUsingStart
SHE processing functions.
.. PFUsingEnd
Proposed for inclusion in EAS/SAS
==================================
.. PFUsingStart
Yes
.. PFUsingEnd
Data product elements
=====================
.. DataProductElementsStart
:Header: object of type sys:genericHeader
:Data: object of type vis:visCalibratedFrameCatalogData
:QualityFlags: object of type dqc:sqfPlaceHolder
:Parameters: object of type ppr:genericKeyValueParameters
.. DataProductElementsEnd
Detailed description of the data product
========================================
.. DetailedDescStart
The VIS processing function provides a series of catalogues delivered in FITS “LDAC” format. These catalogues are produced using SExtractor (Bertin & Arnouts 1996).
The :ref:`VisPSFModel` is given in entry of the VIS pipeline for fitting a spread model.
The spread model is then used to calculate a zero point by comparing to Gaia data.
This calibrated catalogue contains 2 types of tables :
- The LDAC_IMHEAD table, a 1-column catalogue containing the header and some information (like SE parameters) of the original image.
- The LDAC_OBJECTS table, a 84-colum catalogue. These columns are described below.
We calculate the magnitude in 4 apertures : 7, 13, 26 and 50 pixels.
An aperture correction is calculated with the differences between magAper 13 and magAper 50.
Then the relevant aperture to use is mag_aper 13 with this aperture correction (APERCORR).
Changes introduced by the PF version
------------------------------------
PF 17.0
*******
* MAG_AUTO is now a calibrated magnitude, and the raw value is stored in the new column MAG_AUTO_RAW
* MAG_APER[0] (7-pixel aperture), MAG_APER[2] (26-pixel aperture), MAG_APER[3] (50-pixel aperture) are now calibrated magnitudes
* raw values of 7, 13, 26, 50-pixel aperture magnitudes are stored in new columns MAG_APER_RAW[0-3]
* calibrated fluxes and associated errors are stored in new columns FLUX_AUTO_CAL / FLUX_APER_CAL and FLUXERR_AUTO_CAL / FLUXERR_APER_CAL
Column descriptions
-------------------
======================= ======================== ==============================================================================================================================================================================================
Name Units Description
======================= ======================== ==============================================================================================================================================================================================
FLAGS NA SExtractor extraction flags, basic warnings about the source extraction process, in order of increasing concern.
FLAGS_WIN NA SExtractor flag for various issues which may happen with `windowed measurements `_.
FLAGS_MODEL NA SExtractor flag for various issues which may happen during the `fitting process `_.
IMAFLAGS_ISO NA Flags from the flag map maid during the processing. See :ref:`VisFlagMap` for flags details.
NIMAFLAGS_ISO NA Number(s) of relevant flag map pixels.
SPREAD_MODEL NA Spread parameter from model-fitting. Stars are object with: abs(SPREAD_MODEL) :math:`< 0.003`.
FLUX_AUTO Count Flux within a Kron-like elliptical aperture. This flux is not calibrated.
FLUX_APER Count Flux in an aperture. This flux is not calibrated.
FLUXERR_AUTO Count RMS error for AUTO flux.
MAG_AUTO mag Kron-like elliptical aperture magnitude. This magnitude is calibrated.
MAGERR_AUTO mag RMS error for AUTO magnitude.
FLUX_RADIUS Count Fraction-of-light radii (pixels).
MAG_APER mag Magnitude calibrated in a defined aperture.
MAGERR_APER mag Error of the calibrated magnitude in aperture.
MAG_APER_RAW mag Raw values of mag aper, i.e without the zero point. It is the instrumental magnitude.
MAG_AUTO_RAW mag Raw values of MAG_AUTO.
FLUX_AUTO_CAL uJy Flux calibrated by applying the zero-point.
FLUXERR_AUTO_CAL uJy Error in calibrated flux auto.
FLUX_APER_CAL uJy Flux in aperture calibrated.
FLUXERR_APER_CAL uJy Errors in flux aperture calibrated.
NUMBER NA Running object number
X_IMAGE pixel Object position along x
Y_IMAGE pixel Object position along y
XPSF_IMAGE pixel X coordinate from PSF-fitting
YPSF_IMAGE pixel Y coordinate from PSF-fitting
X_WORLD deg Barycenter position along world x axis
Y_WORLD deg Barycenter position along world y axis
ERRA_WORLD deg Major axis of the isophotal image centroid error ellipse
ERRB_WORLD deg Minor axis of the isophotal image centroid error ellipse
ERRTHETA_WORLD deg Position angle of the isophotal image centroid ellipse
XPSF_WORLD deg PSF position along world x axis
YPSF_WORLD deg PSF position along world y axis
ERRAPSF_WORLD pixel Major axis of the PSF
ERRBPSF_WORLD pixel Minor axis of the PSF
ERRTHETAPSF_WORLD deg Position angle of the PSF
A_WORLD deg Profile RMS along major axis (world units)
B_WORLD deg Profile RMS along minor axis (world units)
THETA_WORLD deg Position angle (CCW/world-x)
ERRX2_WORLD deg**2 Estimated variance of isophotal image centroid x coordinate
ERRY2_WORLD deg**2 Estimated variance of isophotal image centroid y coordinate
ALPHA_J2000 deg J2000 right ascension of the isophotal image centroid
DELTA_J2000 deg J2000 declination of the isophotal image centroid
ERRTHETA_J2000 deg J2000 Position angle of the isophotal image centroid ellipse
THETA_J2000 deg Isophotal image position angle
XWIN_WORLD deg x coordinate of windowed image centroid
YWIN_WORLD deg y coordinate of windowed image centroid
ALPHAPSF_J2000 deg Right ascension of the fitted PSF (J2000)
DELTAPSF_J2000 deg Declination of the fitted PSF (J2000)
ERRTHETAPSF_J2000 deg Position angle of the fitted PSF (J2000)
ALPHAWIN_J2000 deg Right ascension of the windowed image
DELTAWIN_J2000 deg Declinaison of of the windowed image
ERRAWIN_WORLD deg Major axis of the windowed image centroid error ellipse
ERRBWIN_WORLD deg Minor axis of the windowed image centroid error ellipse
ERRTHETAWIN_WORLD deg Position angle of the windowed image centroid ellipse
AWIN_WORLD deg Windowed image major axis
BWIN_WORLD deg Windowed image minor axis
THETAWIN_WORLD deg Windowed image position angle
ERRX2WIN_WORLD deg**2 Estimated variance of windowed image centroid x coordinate
ERRY2WIN_WORLD deg**2 Estimated variance of windowed image centroid y coordinate
MU_THRESHOLD :math:`mag*arcsec^{-2}` The surface brightness corresponding to the threshold
MU_MAX :math:`mag*arcsec^{-2}` The surface brightness of the brightest pixel
MU_MAX_MODEL :math:`mag*arcsec^{-2}` Peak model surface brightness above the background
MU_EFF_MODEL :math:`mag*arcsec^{-2}` Effective model surface brightness above the background
MU_MEAN_MODEL :math:`mag*arcsec^{-2}` Mean effective model surface brightness above the background
MU_MAX_SPHEROID :math:`mag*arcsec^{-2}` Peak model surface brightness above the background using Sérsic (:math:`R^{1/n}`) spheroid model
MU_EFF_SPHEROID :math:`mag*arcsec^{-2}` Effective model surface brightness above the background using Sérsic (:math:`R^{1/n}`) spheroid model
MU_MEAN_SPHEROID :math:`mag*arcsec^{-2}` Mean effective model surface brightness above the background using Sérsic (:math:`R^{1/n}`) spheroid model
MU_MAX_DISK :math:`mag*arcsec^{-2}` Peak model surface brightness above the background using exponential disk model
MU_EFF_DISK :math:`mag*arcsec^{-2}` Effective model surface brightness above the background using exponential disk model
MU_MEAN_DISK :math:`mag*arcsec^{-2}` Mean effective model surface brightness above the background using exponential disk model
BACKGROUND count Background at centroid position
MAG_PSF mag Magnitude from PSF-fitting
MAGERR_PSF mag RMS magnitude error from PSF-fitting
ELLIPTICITY NA 1 - B IMAGE/A IMAGE
ELONGATION NA A IMAGE/B IMAGE
FWHM_IMAGE pixel FWHM assuming a Gaussian core
SNR_WIN NA Signal to noise ratio of the windowed image
ERRAWIN_IMAGE pixel Major axis of the windowed image centroid error ellipse
ERRBWIN_IMAGE pixel Minor axis of the windowed image centroid error ellipse
ERRTHETAWIN_IMAGE pixel Position angle of the windowed image centroid ellipse
XWIN_IMAGE pixel x coordinate of windowed image centroid
YWIN_IMAGE pixel y coordinate of windowed image centroid
SNR NA Signal to noise ratio
======================= ======================== ==============================================================================================================================================================================================
User case
---------
**Selection of Stars:** You can use the spread model to select all the stars of the catalogue (i.e. abs(SPREAD_MODEL) :math:`< 0.003`).
However this can also select cosmic rays that are not correctly detected. We recommend to also use a selection in magnitude and FLUX_RADIUS for better results.
If you want no saturated star, you need also to select object with Flags=0.
| **Selection of valid pixels:** To select an object with only valid pixels, you must use:
| *IMAFLAGS_ISO != VIS_FLAG[INVALID]*
| which is equivalent to *IMAFLAGS_ISO%2 == 0*.
Header
------
+----------+----------------------------------------------+
| Primary Header |
+==========+==============================================+
| SIMPLE | This is a FITS file |
+----------+----------------------------------------------+
| BITPIX | |
+----------+----------------------------------------------+
| NAXIS | |
+----------+----------------------------------------------+
| EXTEND | This file may contain FITS extensions |
+----------+----------------------------------------------+
+----------+----------------------------------------------+
| LDAC_IMHEAD header |
+==========+==============================================+
| XTENSION | THIS IS A BINARY TABLE (FROM THE LDACTOOLS) |
+----------+----------------------------------------------+
| BITPIX | |
+----------+----------------------------------------------+
| NAXIS | |
+----------+----------------------------------------------+
| NAXIS1 | BYTES PER ROW |
+----------+----------------------------------------------+
| NAXIS2 | NUMBER OF ROWS |
+----------+----------------------------------------------+
| PCOUNT | RANDOM PARAMETER COUNT |
+----------+----------------------------------------------+
| GCOUNT | GROUP COUNT |
+----------+----------------------------------------------+
| TFIELDS | FIELDS PER ROWS |
+----------+----------------------------------------------+
| EXTNAME | TABLE NAME |
+----------+----------------------------------------------+
| TTYPE1 | |
+----------+----------------------------------------------+
| TFORM1 | |
+----------+----------------------------------------------+
| TDIM1 | |
+----------+----------------------------------------------+
======================== ===========================================================
LDAC_OBJECTS header
======================== ===========================================================
XTENSION binary table extension
BITPIX array data type
NAXIS number of array dimensions
NAXIS1 length of dimension 1
NAXIS2 length of dimension 2
PCOUNT number of group parameters
GCOUNT number of groups
TFIELDS number of table fields
EXTNAME 'TABLE NAME
TTYPE1 'NUMBER '
TFORM1 '1J '
TDISP1 'I10 '
TTYPE2 'X_IMAGE '
TFORM2 '1E '
TUNIT2 'pixel '
TDISP2 'F11.4 '
TTYPE3 'Y_IMAGE '
TFORM3 '1E '
TUNIT3 'pixel '
TDISP3 'F11.4 '
TTYPE4 'XPSF_IMAGE'
TFORM4 '1D '
TUNIT4 'pixel '
TDISP4 'F11.4 '
TTYPE5 'YPSF_IMAGE'
TFORM5 '1D '
TUNIT5 'pixel '
TDISP5 'F11.4 '
TTYPE6 'X_WORLD '
TFORM6 '1D '
TUNIT6 'deg '
TDISP6 'E18.10 '
TTYPE7 'Y_WORLD '
TFORM7 '1D '
TUNIT7 'deg '
TDISP7 'E18.10 '
TTYPE8 'ERRA_WORLD'
TFORM8 '1E '
TUNIT8 'deg '
TDISP8 'G12.7 '
TTYPE9 'ERRB_WORLD'
TFORM9 '1E '
TUNIT9 'deg '
TDISP9 'G12.7 '
TTYPE10 'ERRTHETA_WORLD'
TFORM10 '1E '
TUNIT10 'deg '
TDISP10 'F6.2 '
TTYPE11 'XPSF_WORLD'
TFORM11 '1D '
TUNIT11 'deg '
TDISP11 'E18.10 '
TTYPE12 'YPSF_WORLD'
TFORM12 '1D '
TUNIT12 'deg '
TDISP12 'E18.10 '
TTYPE13 'ERRAPSF_WORLD'
TFORM13 '1E '
TUNIT13 'pixel '
TDISP13 'G12.7 '
TTYPE14 'ERRBPSF_WORLD'
TFORM14 '1E '
TUNIT14 'pixel '
TDISP14 'G12.7 '
TTYPE15 'ERRTHETAPSF_WORLD'
TFORM15 '1E '
TUNIT15 'deg '
TDISP15 'F6.2 '
TTYPE16 'A_WORLD '
TFORM16 '1E '
TUNIT16 'deg '
TDISP16 'G12.7 '
TTYPE17 'B_WORLD '
TFORM17 '1E '
TUNIT17 'deg '
TDISP17 'G12.7 '
TTYPE18 'THETA_WORLD'
TFORM18 '1E '
TUNIT18 'deg '
TDISP18 'F6.2 '
TTYPE19 'ERRX2_WORLD'
TFORM19 '1D '
TUNIT19 'deg**2 '
TDISP19 'E18.10 '
TTYPE20 'ERRY2_WORLD'
TFORM20 '1D '
TUNIT20 'deg**2 '
TDISP20 'E18.10 '
TTYPE21 'ALPHA_J2000'
TFORM21 '1D '
TUNIT21 'deg '
TDISP21 'F11.7 '
TTYPE22 'DELTA_J2000'
TFORM22 '1D '
TUNIT22 'deg '
TDISP22 'F11.7 '
TTYPE23 'ERRTHETA_J2000'
TFORM23 '1E '
TUNIT23 'deg '
TDISP23 'F6.2 '
TTYPE24 'THETA_J2000'
TFORM24 '1E '
TUNIT24 'deg '
TDISP24 'F6.2 '
TTYPE25 'XWIN_WORLD'
TFORM25 '1D '
TUNIT25 'deg '
TDISP25 'E18.10 '
TTYPE26 'YWIN_WORLD'
TFORM26 '1D '
TUNIT26 'deg '
TDISP26 'E18.10 '
TTYPE27 'ALPHAPSF_J2000'
TFORM27 '1D '
TUNIT27 'deg '
TDISP27 'F11.7 '
TTYPE28 'DELTAPSF_J2000'
TFORM28 '1D '
TUNIT28 'deg '
TDISP28 'F11.7 '
TTYPE29 'ERRTHETAPSF_J2000'
TFORM29 '1E '
TUNIT29 'deg '
TDISP29 'F6.2 '
TTYPE30 'ALPHAWIN_J2000'
TFORM30 '1D '
TUNIT30 'deg '
TDISP30 'F11.7 '
TTYPE31 'DELTAWIN_J2000'
TFORM31 '1D '
TUNIT31 'deg '
TDISP31 'F11.7 '
TTYPE32 'ERRAWIN_WORLD'
TFORM32 '1E '
TUNIT32 'deg '
TDISP32 'G12.7 '
TTYPE33 'ERRBWIN_WORLD'
TFORM33 '1E '
TUNIT33 'deg '
TDISP33 'G12.7 '
TTYPE34 'ERRTHETAWIN_WORLD'
TFORM34 '1E '
TUNIT34 'deg '
TDISP34 'F6.2 '
TTYPE35 'AWIN_WORLD'
TFORM35 '1E '
TUNIT35 'deg '
TDISP35 'G12.7 '
TTYPE36 'BWIN_WORLD'
TFORM36 '1E '
TUNIT36 'deg '
TDISP36 'G12.7 '
TTYPE37 'THETAWIN_WORLD'
TFORM37 '1E '
TUNIT37 'deg '
TDISP37 'F6.2 '
TTYPE38 'ERRX2WIN_WORLD'
TFORM38 '1D '
TUNIT38 'deg**2 '
TDISP38 'E18.10 '
TTYPE39 'ERRY2WIN_WORLD'
TFORM39 '1D '
TUNIT39 'deg**2 '
TDISP39 'E18.10 '
TTYPE40 'MU_THRESHOLD'
TFORM40 '1E '
TUNIT40 'mag * arcsec**(-2)'
TDISP40 'F8.4 '
TTYPE41 'MU_MAX '
TFORM41 '1E '
TUNIT41 'mag * arcsec**(-2)'
TDISP41 'F8.4 '
TTYPE42 'MU_MAX_MODEL'
TFORM42 '1E '
TUNIT42 'mag * arcsec**(-2)'
TDISP42 'F8.4 '
TTYPE43 'MU_EFF_MODEL'
TFORM43 '1E '
TUNIT43 'mag * arcsec**(-2)'
TDISP43 'F8.4 '
TTYPE44 'MU_MEAN_MODEL'
TFORM44 '1E '
TUNIT44 'mag * arcsec**(-2)'
TDISP44 'F8.4 '
TTYPE45 'MU_MAX_SPHEROID'
TFORM45 '1E '
TUNIT45 'mag * arcsec**(-2)'
TDISP45 'F8.4 '
TTYPE46 'MU_EFF_SPHEROID'
TFORM46 '1E '
TUNIT46 'mag * arcsec**(-2)'
TDISP46 'F8.4 '
TTYPE47 'MU_MEAN_SPHEROID'
TFORM47 '1E '
TUNIT47 'mag * arcsec**(-2)'
TDISP47 'F8.4 '
TTYPE48 'MU_MAX_DISK'
TFORM48 '1E '
TUNIT48 'mag * arcsec**(-2)'
TDISP48 'F8.4 '
TTYPE49 'MU_EFF_DISK'
TFORM49 '1E '
TUNIT49 'mag * arcsec**(-2)'
TDISP49 'F8.4 '
TTYPE50 'MU_MEAN_DISK'
TFORM50 '1E '
TUNIT50 'mag * arcsec**(-2)'
TDISP50 'F8.4 '
TTYPE51 'ELLIPTICITY'
TFORM51 '1E '
TDISP51 'F8.3 '
TTYPE52 'FLUX_AUTO'
TFORM52 '1E '
TUNIT52 'count '
TDISP52 'G12.7 '
TTYPE53 'FLUXERR_AUTO'
TFORM53 '1E '
TUNIT53 'count '
TDISP53 'G12.7 '
TTYPE54 'MAG_AUTO'
TFORM54 '1E '
TUNIT54 'mag '
TDISP54 'F8.4 '
TTYPE55 'MAGERR_AUTO'
TFORM55 '1E '
TUNIT55 'mag '
TDISP55 'F8.4 '
TTYPE56 'BACKGROUND'
TFORM56 '1E '
TUNIT56 'count '
TDISP56 'G12.7 '
TTYPE57 'MAG_APER'
TFORM57 '4E '
TUNIT57 'mag '
TDISP57 'F8.4 '
TTYPE58 'MAGERR_APER'
TFORM58 '4E '
TUNIT58 'mag '
TDISP58 'F8.4 '
TTYPE59 'FLUX_APER'
TFORM59 '4E '
TUNIT59 'count '
TDISP59 'G12.7 '
TTYPE60 'FLUXERR_APER'
TFORM60 '4E '
TUNIT60 'count '
TDISP60 'G12.7 '
TTYPE61 'MAG_PSF '
TFORM61 '1E '
TUNIT61 'mag '
TDISP61 'F8.4 '
TTYPE62 'MAGERR_PSF'
TFORM62 '1E '
TUNIT62 'mag '
TDISP62 'F8.4 '
TTYPE63 'FLUX_RADIUS'
TFORM63 '1E '
TUNIT63 'pixel '
TDISP63 'F10.3 '
TTYPE64 'ELONGATION'
TFORM64 '1E '
TDISP64 'F8.3 '
TTYPE65 'FWHM_IMAGE'
TFORM65 '1E '
TUNIT65 'pixel '
TDISP65 'F8.2 '
TTYPE66 'SNR_WIN '
TFORM66 '1E '
TDISP66 'G10.4 '
TTYPE67 'SPREAD_MODEL'
TFORM67 '1E '
TDISP67 'G11.5 '
TTYPE68 'FLAGS '
TFORM68 '1I '
TDISP68 'I3 '
TTYPE69 'FLAGS_WIN'
TFORM69 '1I '
TDISP69 'I3 '
TTYPE70 'FLAGS_MODEL'
TFORM70 '1B '
TDISP70 'I3 '
TTYPE71 'ERRAWIN_IMAGE'
TFORM71 '1E '
TUNIT71 'pixel '
TDISP71 'F9.5 '
TTYPE72 'ERRBWIN_IMAGE'
TFORM72 '1E '
TUNIT72 'pixel '
TDISP72 'F9.5 '
TTYPE73 'ERRTHETAWIN_IMAGE'
TFORM73 '1E '
TUNIT73 'deg '
TDISP73 'F6.2 '
TTYPE74 'IMAFLAGS_ISO'
TFORM74 '1J '
TDISP74 'I9 '
TTYPE75 'NIMAFLAGS_ISO'
TFORM75 '1J '
TDISP75 'I9 '
TTYPE76 'XWIN_IMAGE'
TFORM76 '1D '
TUNIT76 'pixel '
TDISP76 'F11.4 '
TTYPE77 'YWIN_IMAGE'
TFORM77 '1D '
TUNIT77 'pixel '
TDISP77 'F11.4 '
TTYPE78 'MAG_APER_RAW'
TFORM78 '4E '
TUNIT78 'mag '
TTYPE79 'MAG_AUTO_RAW'
TFORM79 '1E '
TUNIT79 'mag '
TTYPE80 'FLUX_APER_CAL'
TFORM80 '4E '
TUNIT80 'uJy '
TTYPE81 'FLUXERR_APER_CAL'
TFORM81 '4E '
TUNIT81 'uJy '
TTYPE82 'FLUX_AUTO_CAL'
TFORM82 '1E '
TUNIT82 'uJy '
TTYPE83 'FLUXERR_AUTO_CAL'
TFORM83 '1E '
TUNIT83 'uJy '
TTYPE84 'SNR '
TFORM84 'E '
CCDID
QUADID
WCSAXES
CTYPE1
CTYPE2
CUNIT1
CUNIT2
A_ORDER
B_ORDER
CRPIX1
CRPIX2
CD1_1
CD1_2
CD2_1
CD2_2
A_0_2
A_0_3
A_1_1
A_1_2
A_2_0
A_2_1
A_3_0
B_0_2
B_0_3
B_1_1
B_1_2
B_2_0
B_2_1
B_3_0
CRVAL1
CRVAL2
STDCRMS
NUMBRMS
AVGRESID
======================== ===========================================================
.. DetailedDescEnd