[ ESO ]
VIMOS pipeline:
science recipes

CAL | HC | refs | QC
QUALITY CONTROL
    HOME
VIMOS QC
Trending & QC1
Pipeline
Data Package
Data Management
QC links:
Science data and recipes

Contents: IMG | MOS | IFU

Typical observation and reduction problems are listed here.

attention

VIMOS SCIENCE data have been processed by the pipeline with the best available calibration data. Please note that ESO does not assume any responsibility with respect to the usefulness of reduced data. The adopted reduction strategy may not be suitable for the scientific purpose of the observations.

 

Imaging

DPR CATG = SCIENCE
DPR TYPE = OBJECT
DPR TECH = IMAGE or IMAGE,PRE (for pre-imaging)

[imgsci.gif  11K] reduced image of NGC5128 in quadrant 3 taken with filter B in stare mode. Vignetted regions at borders are visible

Recipe

The pipeline recipes vmimobsstare and vmimobsjitter do bias subtraction with overscan removal, flat-fielding and removal of cosmic raysl. Images taken in UBVRI filters are also photometrically calibrated. Combination of images taken in jittered mode is pipeline-supported but not applied for data reduction that is used for producing data packages. Photometric calibration consists of writing in the header of the reduced image the zeropoint keyword (in ADU/sec): "HIERARCH ESO PRO MAG ZERO", with its RMS: "HIERARCH ESO PRO MAGZERO RMS". The zeropoints are in general obtained every night, but when the night determination is not available the closest in time zeropoint is used. For the zeropoints determination see the zeropoint page . The pipeline recipe also converts the header keywords "HIERARCH ESO PRO SKY CCD" containing the sky to CCD transformation into the "WCS" (World-Coordinate-System) format readable by the "Mask-preparation Software" and by Skycat. (The converted keywords are called "COi_j"). The pipeline recipe also computes qc parameters (see below) and writes them in the reduced image header.

Recipe for pre-imaging

The recipe vmimpreimaging is only used for quick-delivery data, and for this purpose standard (not the latest) master calibrations are used. Pre-imaging is taken in stare mode only. The pipeline recipe vmimpreimaging does bias subtraction with overscan removal, flat-fielding and converts the header keywords "HIERARCH ESO PRO SKY CCD" into the "COi_j" keywords readable by the "Mask-preparation Software". Photometric calibration is not performed and QC parameters are not computed.

Products

product category (PRO CATG)* product index** product code*** delivered? format comments
IMG_SCIENCE_REDUCED 0000 SREI yes 2D reduced science image
IMG_GALAXY_TABLE n/a n/a no table list of detected objects

* coded as HIERARCH.ESO.PRO.CATG in the fits header
** index of the PIPEFILE name, coded as PIPEFILE in the fits header
*** used in the delivered name

QC checks

As part of the quality control the following parameters are computed by the pipeline imaging recipe and their value are stored in the header of the reduced image. More information on the qc parameters can be found on the QC pages.

header keyword name qc parameter
QC IMAGE QUALITY image quality (arcsec)
QC IMAGE QUALITY ERROR error on image quality (arcsec)
QC SKYBACK sky background level (ADU/sec/px)
QC SKYBACK ERROR sky background level error (ADU/sec/px)
QC MAGLIM Limiting magnitude
QC MAGLIM ERROR error on limiting magnitude

Image quality is computed as the mode of FWHM of all the objects in frame classified as stars by SExtractor, when at least 10 stars are found.

Error on image quality is the sigma of FWHM of the objects classified as stars. It is computed iteractively, excluding from the distribution outliers at more than 3 sigma.

Sky background level is estimated by computing the median pixel value in 100 regions of the frame each of 160x180 pixels, the mean of the 10 lowest values, divided by the exposure time is the estimate of the sky background in (ADU/px/sec).

Error on sky background level is the rms of the 10 lower values selected for the background level estimation.

Limiting magnitude in frame is computed as the position of the most populated bin of the star magnitudes histogram. Binsizes from 0.1 up to 1 magnitudes are tried until the most populated bin contains at least 20 stars. If the 20 stars level for the highest bin is never reached, the limiting magnitude is set to 0.

Error on limiting magnitude is the value of the binsize of the histogram used to determine the limiting magnitude.

MOS

DPR CATG = SCIENCE,
DPR TYPE = OBJECT,
DPR TECH = MOS

[mosscirawLR_blue.gif 14K] Raw MOS science frame of quadrant 1 obtained with the LR_blue grism. There are 137 science slits and 3 reference slits (two of them are visible at the left side and one at the right). Cleary visible are zero and -1 (minus one) order contaminations

Recipe vmmosscience

The pipeline recipe vmmosscience is available since pipeline version 2.3.9. It expects as input calibration products the output of the recipe vmmoscalib. It is used for data reduction since August 2010.

The recipe vmmosscience applies bias subtraction with overscan removal and flat-fielding. Slit spectra are remapped in order to eliminate optical distortion, wavelength-calibrated using the input wavelength calibration and sky lines, and subtracted from sky background. Objects are extracted using an optimal extraction algorithm (K. Horne1986, PASP 98, 609). If more than one scientific exposure is specified as input then each frame is processed as indicated above but all frames are aligned to the first one and stacked before object extraction.

MOS masks can be constructed so that they contain multiple layers of slits along the dispersion direction (so called multiplexing). This feature can be used for LR and MR grisms. The recipe vmmosscience detects the number of multiplex layers present in the input and creates output files which are multi-extension fits files (MEFs). The number of extensions is equal to the number of multiplex layers (up to 4 for LR grisms and 2 for MR). If multiplexing is not used then fits files without extensions are created. This strategy is necessary because spectra from two multiplex layers can overlap; MEFs allow to clearly distinguish them.

Products

product category (PRO CATG)* product code** delivered? format MEF? comments
MOS_SCIENCE_REDUCED SREM yes 2D yes image containing 1-dimensional spectra of extracted objects (one per row)
MOS_SCI_ERROR_REDUCED SERM yes 2D yes image containing 1-dimensional error spectra (one-per-row)
MOS_SCIENCE_EXTRACTED SEXM yes 2D yes image containing 2-dimensional sky-subtracted slit spectra
MOS_SCIENCE_SKY SSKM yes 2D yes image containing 2-dimensional sky spectra (per slit)
MOS_SCIENCE_SKY_EXTRACTED SSEM yes 2D yes image containing 2-dimensional slit spectra of sky and objects
MOS_SCI_SKY_REDUCED SSRM yes 2D yes image containing 1-dimensional extracted sky spectra (one per row)
OBJECT_SCI_TABLE SOTM yes table yes positions of slits and objects
MOS_SCI_FRINGES SFRM yes 2D yes fringe map
MOS_SCIENCE_FLUX_REDUCED SRFM yes 2D yes flux-calibrated object spectra
MOS_SCI_ERROR_FLUX_REDUCED SEFM yes 2D yes errors for flux-calibrated spectra

* coded as HIERARCH.ESO.PRO.CATG in the fits header
** used in the delivered name

The product OBJECT_SCI_TABLE contains slit and object positions:

column name description
slit_id slit identification number
xtop x CCD position of central wavelength of left end of slit
ytop y CCD position of central wavelength of left end of slit
xbottom x CCD position of central wavelength of right end of slit
ybottom y CCD position of central wavelength of right end of slit
position first row of a rectified image (e.g. MOS_SCIENCE_EXTRACTED) containing the slit spectrum, counted from bottom to top, starting with 0
length number of rows of the slit spectrum in a rectified image
object_1, object_2, ... position of detected objects in rectified image
start_1, start_2, ... start position of extraction interval
lend_1, end_2, ... end position of extraction interval
row_1, row_2, ... row number of object spectrum in MOS_SCIENCE_REDUCED, counted from bottom to top, starting with 0

Example product images

OBJ_LR_blue SKY_LR_blue Pipeline products obtained from the above MOS science frame. On the left, the product MOS_SCIENCE_EXTRACTED is shown. It contains the 2-dimensional reduced spectra of the objects found in each slit, the 1-dimensional extracted spectra are contained in the product MOS_SCIENCE_REDUCED (not shown). The right image shows the product MOS_SCIENCE_SKY that contains the 2-dimensional reduced sky spectra that have been subtracted from the object spectra. Both images are resampled to a constant wavelength interval of 5.27 A/pix and the starting wavelength is 3700 A. Clearly visible again in the sky spectra are second and zero order contaminations.

 

bla

An enlargement of the MOS_SCIENCE_EXTRACTED frame is shown here. Eight slits are visible (separated by the black lines) containing objects. The slits have been extracted from the raw frame following the curvature model and have been resampled to a constant wavelength step (for the LR_blue grism it is 5.27A/pix). The right image shows the 1-dimensional spectrum of one of the objects obtained by plotting the corresponding row of the product MOS_SCIENCE_REDUCED. The zero order contamination, when saturated, cannot be removed; therefore the apparent emission line at 4900A in the extracted spectrum is caused by that, while the emission at 5450A is real.

 

blabla

Some part of the 2-dimensional sky product MOS_SCIENCE_SKY is shown here; corresponding to the object spectra above. The third and the seventh slits (from the bottom to the top) show zero order contamination, while the second slit shows -1 (minus one) order contamination. The bright sky on the blue end of the seventh spectrum is caused by the next multiplexed slit. The 2-dimensional extracted sky image also indicates the quality of the wavelength calibration applied to the science frame. This is done by checking the alignment of the skylines in all slits, and by comparing the wavelengths of some of them with their known value. The wavelength range of blue grisms does not have many strong skylines, and they are all in the redder part of the spectrum. Here, the OI lines at 5577.4 and 6299.7, 6363.6A and a NaI blend at 5891.6A are visible.

 


Recipes vmmosobsstare and vmmosobsjitter

These recipes have been used for data reduction of MOS science until May 2010. They are still available in the pipeline delivery.

The pipeline recipe vmmosobsstare and vmmosobsjitter apply bias subtraction with overscan removal. Flat-field correction is available but not executed during standard reduction for PI data packages. Observations in the red part of the spectrum show strong fringing whereas in the blue reflections are present. Both effects can cause artificial features in science frames during flat-fielding.

The shift in the wavelength direction with respect to skylines is computed and applied to correct for flexures (the skylines used are listed in the header of the input wavelength dispersion solution table under the keywords "HIERARCH ESO PRO SKY WLENi"). The objects in slits are detected, the 2-dimensional slit extraction is done using the distortion models and the inverse dispersion solution read in the wavelength solution table. The median sky level is subtracted and two images containing 2-dimensional object spectra and sky spectra are produced. These images are resampled to a constant wavelength interval as listed in the header keyword CDELT1 (5.27 A/pix for the LR_blue grism), and the wavelength corresponding to the first pixel is listed in the header keyword CRVAL1 (3700 A for LR_blue). Then, in case of jittered data, the 2-dimensional products are stacked. Finally the 1-dimensional optimal extraction is applied (K. Horne1986, PASP 98, 609) and the result for each slit is stored in one row of the product image.

Products

product category (PRO CATG)* product index** product code*** delivered? format comments
MOS_SCIENCE_REDUCED 0000 SREM yes 2D image containing 1-dimensional extracted object spectra (one-per-row)
MOS_SCIENCE_EXTRACTED 0001 SEXM yes 2D image containing 2-dimensional extracted object spectra
MOS_SCIENCE_SKY 0002 SSKM yes 2D image containing 2-dimensional extracted sky spectra
MOS_SKY_REDUCED 0003 SSRM yes 2D image containing 1-dimensional extracted sky spectra (one-per-row)
OBJECT_TABLE 0004 SOTM yes table positions of objects in 1-dim image
WINDOW_TABLE 0005 SWTM yes table positions of objects on slit
MOS_SCIENCE_FLUX_REDUCED 0006 SRFM yes 2D flux-calibrated object spectra
MOS_FRINGES 0007 SFRM yes 2D fringe map (only for recipe vmmosobsjitter)

* coded as HIERARCH.ESO.PRO.CATG in the fits header
** index of the PIPEFILE name, coded as PIPEFILE in the fits header
*** used in the delivered name

The product WINDOW_TABLE refers to the 2-dimensional extracted spectra (MOS_SCIENCE_EXTRACTED and MOS_SCIENCE_SKY) and contains the following columns:

column name description
SLIT slit number
SPEC_START pixel position (Y) of the first row of the slit in MOS_SCIENCE_EXTRACTED and MOS_SCIENCE_SKY
SPEC_END pixel position (Y) of the last row of the slit in MOS_SCIENCE_EXTRACTED and MOS_SCIENCE_SKY
OBJ_NO sequential number of object in slit (there may be more than one)
OBJ_START pixel position (Y) of the first row of object relative to SPEC_START
OBJ_END pixel position (Y) of the last row of object relative to SPEC_STAR
OBJ_POS pixel position (Y) of object relative to SPEC_STAR
OBJ_X mask X coordinate of object (mm) (0,0 is the coordinate of the mask center)
OBJ_Y mask Y coordinate of object (mm)

The product OBJECT_TABLE refers to the 1-dimensional extracted spectra MOS_SCIENCE_REDUCED and contains the following columns:

column name description
SLIT slit number
Y pixel position (Y) of spectrum in MOS_SCIENCE_REDUCED
OBJ_NO sequential number of object in slit (there may be more than one)
OBJ_X mask X coordinate of object (mm) (0,0 is the coordinate of the mask center)
OBJ_Y mask Y coordinate of object (mm)

 

IFU

DPR CATG = SCIENCE,
DPR TYPE = OBJECT,
DPR TECH = IFU

[ifusciraw.gif 14K] Raw IFU science frame of quadrant 2 obtained with the HR_red grism. Redder wavelengths are toward the top. In this image and in all the data obtained with High/Medium Resolution grisms, only the central pseudo-slit is used (i.e. 400 exposed fiber). In Low Resolution, instead, all four pseudo-slits are used (i.e. 1600 exposed fibers).

Recipe IFU

The pipeline recipe vmifuscience is used to reduce a single IFU science exposure. In addition to a raw science exposure the recipe requires a master bias, an inverse dispersion solution file, a fiber relative transmission file, and a file containing information on the tracing of the fibers. The last three files are obtained with the recipe vmifucalib using arc-lamps and flat-field frames which belong to the night-time calibrations associated to the science exposure. The recipe starts with bias subtraction. Then, it refines the input tracing file using the brightest fiber of the science exposure and refines the input inverse dispersion solution file using the position of some identified sky-lines. The spectra are then extracted, wavelength calibrated and resampled to a constant wavelength step (written in the keyword CDELT1). The extracted spectra are also corrected for the relative differences in fiber transmission (using the input relative transmission file) and finally stored in the output image in the usual order: sucessively from pseudo-slit1 to pseudo-slit4 counting fibers from left to right. Flat-fielding and fringing correction are not executed.

The extracted fiber spectra image is then used together with the appropriate IFU table to reconstruct the image of the field of view. The extracted spectra are integrated in a predefined wavelength range, chosen where the spectra are brighter and excluding zero order contaminations, and the value obtained are stored in the corresponding positions on the IFU head.

Products

product category (PRO CATG)* product index** product code*** delivered? format comments
IFU_FOV 0000 SSVF yes 2D reconstructed field of view
IFU_SCIENCE_REDUCED 0001 SREF yes 2D image containing extracted fibre spectra
IFU_SCIENCE_FLUX_REDUCED 0002 SRFF yes 2D image containing flux-calibrated extracted fibre spectra

* coded as HIERARCH.ESO.PRO.CATG in the fits header
** index of the PIPEFILE name, coded as PIPEFILE in the fits header
*** used in the delivered name

A product image IFU_SCIENCE_REDUCED is shown below, obtained with the raw image shown above. The extracted fibre spectra are 400 and the spectrum of the fiber 352 is plotted on the top. The spectra are resampled to the constant wavelength interval listed in the header keyword CDELT1. CDELT1 is 0.58 A/pix in this image taken with the HR_red grism. The spectral signal is given in ADU per wavelength interval, then, to have the signal per Angstrom one should divide the spectrum by CDELT1. Clearly visible are sky emission and absorption lines. The position of some sky emission lines are also used during the QC checks to control the wavelength calibration.

IFU_extracted
Product image (PRO CATG: IFU_FOV) of the reconstructed field of view of quadrant 2. The reconstructed image of each single quadrant has the dimension of the 4-quadrant field of view (here 40x40) and is filled with zeros in the regions corresponding to the other quadrants (black regions in figure). Here, in High Resolution, only the 400 fibers of the central pseudo-slit are used that correspond to a 20x20 region of the IFU head. In low resolution all 4 pseudo-slits with 1600 fibers are used corresponding to a region 40x40 of the IFUhead. The mapping between the spectra position in the extracted spectra image and the corresponding points of the reconstructed field-of view image is given in the IFU tables.
Reconstructed image of the 4 quadrants field of view. The 4 quadrant image is the product of the vmifucombine recipe, that simply sums the four single quadrant images. The black regions correspond to dead fibres. In high/medium resolution, the 4-quadrants reconstructed image has size 40x40. In low resolution, the size of the 4-quadrant image is 80x80.

 

 

 
[ESO][Index][Search][Help][News]