vmimobsstare7
Reduce an imaging science exposure.
Usage
esorex vmimobsstare [OPTIONS] FILE.sof
Overview
This recipe is used to apply basic reduction steps to one exposure made in direct imaging mode. SExtractor v2.1.6 is run on the reduced image, producing a table of detected objects with their instrumental magnitudes, their celestial and image coordinates, and their stellarity index. The image WCS, together with the component describing the instrument optical distortions, is converted into the convention followed by VMMPS (the VIMOS mask preparation software). This set of coefficients, the CO-matrix used in the SAO WCSTools package, is written to the header of the reduced image.
Input files:
DO category: Type: Explanation: Required:
IMG_SCIENCE Raw Science exposure Y
MASTER_BIAS Calib Master bias Y
MASTER_DARK Calib Master dark .
IMG_MASTER_SKY_FLAT Calib Master sky flat Y
PHOT_COEFF_TABLE Calib Photometric table .
CCD_TABLE Calib Bad pixel table .
Output files:
DO category: Data type: Explanation:
IMG_SCIENCE_REDUCED FITS image Reduced scientific exposure
IMG_GALAXY_TABLE FITS table List of detected objects
If a photometric table is specified, the magnitude zeropoint, the atmospheric extinction coefficient, and the colour term are copied from the photometric table to the header of the reduced image. A CCD table must be specified in input only if a bad pixel cleaning is requested. The galaxy table is the output of SExtractor converted into FITS format. The content of this table is defined within the VIMOS pipeline DRS, with the only intent of serving the purpose of the involved pipeline recipes. For a customised output SExtractor table, it is always possible to run SExtractor separately, after configuring the native SExtractor parameter files. For a complete explanation of the output parameters please refer to the SExtractor documentation - see for instance:
http://terapix.iap.fr/rubrique.php?id_rubrique=91/index.html).
For more details, please refer to the VIMOS Pipeline User´s Guide.
Options
-
--BiasMethod <str> -
Bias removal method. (str; default: ´Zmaster´). The full name of this option for the EsoRex configuration file is
vimos.Parameters.bias.removing.method[default = Zmaster].
-
--CleanBadPixel <bool> -
Bad pixel correction on reduced science image. (bool; default: False). The full name of this option for the EsoRex configuration file is
vimos.Parameters.badpixel.clean[default = False].
-
--CleanCosmic <bool> -
Cosmic ray removal from input science image. (bool; default: True). The full name of this option for the EsoRex configuration file is
vimos.Parameters.cosmics.clean[default = True].
-
--CosmicsThreshold <float> -
Threshold for cosmic ray candidate selection. (float; default: 4.0). The full name of this option for the EsoRex configuration file is
vimos.Parameters.cosmics.threshold[default = 4.0].
-
--CosmicsRatio <float> -
Ratio for discrimination of objects and cosmics. (float; default: 2.0). The full name of this option for the EsoRex configuration file is
vimos.Parameters.cosmics.ratio[default = 2.0].
-
--StarIndex <float> -
Stellarity index used to select stars in the image. (float; default: 0.5). The full name of this option for the EsoRex configuration file is
vimos.Parameters.matching.stellarity[default = 0.5].
-
--SearchRadius <float> -
Aperture used for object identification. (float; default: 2.0). The full name of this option for the EsoRex configuration file is
vimos.Parameters.matching.radius[default = 2.0].
-
--TemperatureCheck <bool> -
Check beam temperature when updating the world coordinate system. (bool; default: True). The full name of this option for the EsoRex configuration file is
vimos.Parameters.temperature.check[default = True].
-
--TemperatureTolerance <float> -
Maximum allowed difference between beam and ambient temperature. (float; default: 3.0). The full name of this option for the EsoRex configuration file is
vimos.Parameters.temperature.tolerance[default = 3.0].
-
--ComputeQC <bool> -
Compute QC1 parameters (bool; default: True). The full name of this option for the EsoRex configuration file is
vimos.Parameters.quality.enable[default = True].
-
--SExtractor.AnalysisThresh <float> -
Surface brightness threshold for FWHM computation. (float; default: 2.5). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.AnalysisThresh[default = 2.5].
-
--SExtractor.AssocData <str> -
Column indices for columns to copy to the catalog output. (str; default: ´2,3,4´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.AssocData[default = 2,3,4].
-
--SExtractor.AssocName <str> -
Name of the ASSOC file. (str; default: ´sky.list´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.AssocName[default = sky.list].
-
--SExtractor.AssocParams <str> -
Column indices in the ASSOC file to use as coordinates and weight for cross-matching. (str; default: ´2,3,4´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.AssocParams[default = 2,3,4].
-
--SExtractor.AssocRadius <float> -
Search radius for ASSOC. (float; default: 2.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.AssocRadius[default = 2.0].
-
--SExtractor.AssocSelecType <str> -
Output selector for detected sources. (str; default: ´MATCHED´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.AssocSelecType[default = MATCHED].
-
--SExtractor.AssocType <str> -
Method for cross-matching. (str; default: ´MAG_SUM´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.AssocType[default = MAG_SUM].
-
--SExtractor.BackFilterSize <int> -
Size (in background meshes) of the background filtering mask. (int; default: 3). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.BackFilterSize[default = 3].
-
--SExtractor.BackPhotoThick <int> -
Thickness of the background LOCAL annulus. (int; default: 24). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.BackPhotoThick[default = 24].
-
--SExtractor.BackPhotoType <str> -
Select background for magnitude computation. (str; default: ´GLOBAL´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.BackPhotoType[default = GLOBAL].
-
--SExtractor.BackSize <int> -
Size of a background mesh. (int; default: 64). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.BackSize[default = 64].
-
--SExtractor.BackValue <float> -
Constant to subtract from the images for MANUAL background subtraction. (float; default: 0.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.BackValue[default = 0.0].
-
--SExtractor.CatalogType <str> -
Select output catalog format (only ASCII_HEAD is supported). (str; default: ´ASCII_HEAD´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.CatalogType[default = ASCII_HEAD].
-
--SExtractor.CheckImageName <str> -
Check image file name. (str; default: ´check.fits´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.CheckImageName[default = check.fits].
-
--SExtractor.CheckImageType <str> -
Select information to put in the `check image´. (str; default: ´NONE´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.CheckImageType[default = NONE].
-
--SExtractor.Clean <str> -
If `Y´, clean catalog before writing. (str; default: ´Y´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.Clean[default = Y].
-
--SExtractor.CleanParam <float> -
Cleaning efficiency. (float; default: 1.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.CleanParam[default = 1.0].
-
--SExtractor.DeblendMinCont <float> -
Minimum contrast for deblending. (float; default: 0.005). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.DeblendMinCont[default = 0.005].
-
--SExtractor.DeblendNthresh <int> -
Number of deblending sub-thresholds. (int; default: 32). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.DeblendNthresh[default = 32].
-
--SExtractor.DetectMinArea <int> -
Minimum number of pixels above threshold triggering detection. (int; default: 5). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.DetectMinArea[default = 5].
-
--SExtractor.DetectThresh <float> -
Detection threshold (relative to background RMS). (float; default: 2.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.DetectThresh[default = 2.0].
-
--SExtractor.DetectType <str> -
Device type the image originates from. (str; default: ´CCD´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.DetectType[default = CCD].
-
--SExtractor.Filter <str> -
If `Y´, filter data before extraction. (str; default: ´N´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.Filter[default = N].
-
--SExtractor.FilterName <str> -
Name of the file containing the filter definition. (str; default: ´/usr/share/esopipes/vimos-3.2.3/config/vimos.conv´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.FilterName[default = /usr/share/esopipes/vimos-3.2.3/config/vimos.conv].
-
--SExtractor.FilterThresh <str> -
Lower, upper threshold (in background sigmas) for filtering (retina- filtering only). (str; default: ´´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.FilterThresh[default = ].
-
--SExtractor.FlagImage <str> -
Flag image file name. (str; default: ´flag.fits´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.FlagImage[default = flag.fits].
-
--SExtractor.FlagType <str> -
Flag combination method. (str; default: ´OR´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.FlagType[default = OR].
-
--SExtractor.InterpMaxXlag <int> -
Maximum X gap allowed in interpolation. (int; default: 16). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.InterpMaxXlag[default = 16].
-
--SExtractor.InterpMaxYlag <int> -
Maximum Y gap allowed in interpolation. (int; default: 16). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.InterpMaxYlag[default = 16].
-
--SExtractor.InterpType <str> -
Interpolation method. (str; default: ´ALL´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.InterpType[default = ALL].
-
--SExtractor.MagGamma <float> -
Gamma of emulsion (only used in PHOTO mode). (float; default: 4.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.MagGamma[default = 4.0].
-
--SExtractor.MagZeropoint <float> -
Zero-point offset to apply to magnitudes. (float; default: 0.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.MagZeropoint[default = 0.0].
-
--SExtractor.MaskType <str> -
Masking of neighbours for photometry. (str; default: ´CORRECT´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.MaskType[default = CORRECT].
-
--SExtractor.MemoryBufSize <int> -
Number of scan-lines in the image buffer. (int; default: 1024). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.MemoryBufSize[default = 1024].
-
--SExtractor.MemoryObjStack <int> -
Maximum number of objects the object stack can contain. (int; default: 2000). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.MemoryObjStack[default = 2000].
-
--SExtractor.MemoryPixStack <int> -
Maximum number of pixels the pixel stack can contain. (int; default: 100000). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.MemoryPixStack[default = 100000].
-
--SExtractor.PhotApertures <float> -
Aperture diameters used for MAG_APER. (float; default: 5.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.PhotApertures[default = 5.0].
-
--SExtractor.PhotAutoParams <str> -
MAG_AUTO controls: 1st order moment scaling parameter, minimum Rmin. (str; default: ´2.5,3.5´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.PhotAutoParams[default = 2.5,3.5].
-
--SExtractor.SExtractor <str> -
Path to the sextractor executable. (str; default: ´/usr/bin/sex´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.SExtractor[default = /usr/bin/sex].
-
--SExtractor.SaturLevel <float> -
Pixel values above are considered saturated. (float; default: 60000.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.SaturLevel[default = 60000.0].
-
--SExtractor.StarNnwName <str> -
Name of the neuronal network weights file. (str; default: ´/usr/share/esopipes/vimos-3.2.3/config/vimos.nnw´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.StarNnwName[default = /usr/share/esopipes/vimos-3.2.3/config/vimos.nnw].
-
--SExtractor.Timeout <float> -
Time after which sextractor will be aborted. (float; default: 300.0). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.Timeout[default = 300.0].
-
--SExtractor.VerboseType <str> -
Selects verbosity level. (str; default: ´QUIET´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.VerboseType[default = QUIET].
-
--SExtractor.WeightType <str> -
Selects the weighting scheme. (str; default: ´NONE´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.WeightType[default = NONE].
-
--SExtractor.Window <str> -
Frame window used in SExtractor detection. (str; default: ´100,100,1948,2340´). The full name of this option for the EsoRex configuration file is
vimos.SExtractor.Window[default = 100,100,1948,2340].
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.
Version
vmimobsstare 3.2.3
Releases
3 releases since Debian 8 (Jessie); the text changed 2 times.