vmimobsstare(7)
NAME
vmimobsstare - Reduce an imaging science exposure.
SYNOPSIS
esorex vmimobsstare [OPTIONS] FILE.sof
DESCRIPTION
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 Users 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 <long>
Size (in background meshes) of the background filtering mask.
(long; default: 3). The full name of this option for the EsoRex
configuration file is vimos.SExtractor.BackFilterSize [default =
3].
--SExtractor.BackPhotoThick <long>
Thickness of the background LOCAL annulus. (long; 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 <long>
Size of a background mesh. (long; 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 <long>
Number of deblending sub-thresholds. (long; default: 32). The
full name of this option for the EsoRex configuration file is
vimos.SExtractor.DeblendNthresh [default = 32].
--SExtractor.DetectMinArea <long>
Minimum number of pixels above threshold triggering detection.
(long; 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.1.7/config/vimos.conv).
The full name of this option for the EsoRex configuration file
is vimos.SExtractor.FilterName [default =
/usr/share/esopipes/vimos-3.1.7/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 <long>
Maximum X gap allowed in interpolation. (long; default: 16). The
full name of this option for the EsoRex configuration file is
vimos.SExtractor.InterpMaxXlag [default = 16].
--SExtractor.InterpMaxYlag <long>
Maximum Y gap allowed in interpolation. (long; 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 <long>
Number of scan-lines in the image buffer. (long; default: 1024).
The full name of this option for the EsoRex configuration file
is vimos.SExtractor.MemoryBufSize [default = 1024].
--SExtractor.MemoryObjStack <long>
Maximum number of objects the object stack can contain. (long;
default: 2000). The full name of this option for the EsoRex
configuration file is vimos.SExtractor.MemoryObjStack [default =
2000].
--SExtractor.MemoryPixStack <long>
Maximum number of pixels the pixel stack can contain. (long;
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.1.7/config/vimos.nnw). The full
name of this option for the EsoRex configuration file is
vimos.SExtractor.StarNnwName [default =
/usr/share/esopipes/vimos-3.1.7/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.
SEE ALSO
The full documentation for the vimos pipeline can be downloaded as a
PDF file using the following URL:
ftp://ftp.eso.org/pub/dfs/pipelines/vimos/vimos-pipeline-manual-6.9.pdf
An overview over the existing ESO pipelines can be found on the web
page http://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 http://packages.python.org/python-cpl/index.html for
further information.
The other recipes of the vimos pipeline are vmbias(7), vmdark(7),
vmdet(7), vmifucalib(7), vmifucombine(7), vmifucombinecube(7),
vmifuscience(7), vmifustandard(7), vmimcalphot(7), vmimflatscreen(7),
vmimflatsky(7), vmimobsjitter(7), vmimpreimaging(7), vmimstandard(7),
vmmoscalib(7), vmmoscombine(7), vmmosobsjitter(7), vmmosobsstare(7),
vmmosscience(7), vmmosstandard(7), vmspcaldisp(7), vmspflat(7),
vmspphot(7)
VERSION
vmimobsstare 3.1.7
AUTHOR
ESO VIMOS Pipeline Team and VIMOS Consortium <usd-help@eso.org>
BUG REPORTS
Please report any problems to usd-help@eso.org. Alternatively, you may send a report to the ESO User Support Department <usd-help@eso.org>.
LICENSE
This file is part of the VIMOS Instrument Pipeline Copyright (C) 2002-2005 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
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
