Standard star with the LCB IFU

Mode:

Standard star with the LCB IFU

Usage:

Offline, Online

Key:

MegaraLcbStdStar

Recipe:

LCBStandardRecipe

Recipe input:

LCBStandardRecipeInput

Recipe result:

LCBStandardRecipeResult

This observing mode includes the required actions to obtain those calibration images needed to correct for the variation in the response of the system along the spectral direction. This signature is manifested by a change in the conversion factor between the energy surface density hitting the telescope primary mirror and the DUs per CCD pixel with wavelength. Its effect is already present in the original data but it could get modified during the reduction process, e.g. after the fiber-flat correction is applied.

The flux calibration is performed by observing one or several spectrophotometric stars with the same instrument configuration that for the scientific observations. Depending on the number of standard stars observed and on the weather conditions (mainly transparency) two different types of calibration could be achieved:

  • Absolute-flux calibration: The weather conditions during the night should be photometric and a number of spectrophotometric standard stars at different airmasses should be observed. This allows to fully correct from DUs per CCD pixel to energy surface density (typically in erg s-1 cm-2 Å-1) incident at the top of the atmosphere. If only one single standard star is observed (at the airmass of the science object) this correction allows deriving the energy surface density hitting the telescope primary mirror exclusively, unless an atmospheric extinction curve for the observatory and that particular night is assumed. In order to properly flux-calibrate scientific observations at all airmasses several stars should be observed during the night.

  • Relative-flux calibration: If the weather conditions are not photometric this correction only allows normalizing the DUs per CCD pixel along the spectral direction so the conversion to incident energy at the top of the atmosphere is the same at all wavelengths. In order for this calibration to be valid the assumption that the effect of the atmosphere (including atmospheric cirrus and possibly thick clouds) on the wavelength dependence of this correction is that given by the atmospheric extinction curve adopted.

Since the observing sequence needed for both types of flux calibration is identical only one observing mode (standard star) needs to be defined.

We will use this same observing mode also for the observation of either telluric standards or radial-velocity standards. The former are needed to correct for the presence of telluric absorptions mainly in the red part of the spectrum and are achieved by means of observing A-type stars at the same airmass and very close in time to the corresponding scientific observation. The latter can used to determine a precise zero point velocity for the instrument at a specific night and to verify its stability from night to night and season to season.

Requirements

This mode requires the entire flux of the spectrophotometric standard star to be recovered (even if the star is a telluric or radial-velocity standard), especially when an absolute-flux calibration is needed, so the LCB IFU bundle must be used. The FOV of the LCB IFU is large enough for these observations to be carried out with one of the sides of the focal-plane cover closed. When this calibration is aimed for a set of Fiber-MOS scientific observations, complementary observations of standard stars through the Fiber-MOS minibundles might be also required. This allows verifying the quality and stability of the calibration when two different pseudo-slits are used. Such observing mode is described later.

This mode requires having the focal-plane cover configured (at least one of the sides should be open), the instrument shutter open, to configure the VPH mechanism to select the grating to be used, to set the instrument mode to LCB IFU, to move the focusing mechanism to the position pre-defined for the specific VPH of choice, and to expose a certain time and to readout the detector in a series of exposures, being this series the image set containing the spectral energy distribution of the spectrophotometric standard star.

In order to distribute the flux from the star across multiple spaxels in the LCB IFU bundle (particularly important in the case of very bright spectrophotometric standard stars) we might also need to apply a small drift motion (typically of a few arcsec per second) to one of the telescope axes at the start of the observation or, more likely, slightly defocus the telescope.

Products

Standard star image sets are to be obtained only as part of the routine calibration activities performed by the observer and that are needed for processing data for scientific exploitation.

Recipe, inputs and results

class megaradrp.recipes.calibration.lcbstdstar.LCBStandardRecipe(*args, **kwargs)

Process LCB Standard Star Recipe.

This recipe processes a set of images obtained in LCB Stardard Star image mode and returns the total flux of the star.

Notes

Images provided by obresult are trimmed and corrected from overscan, bad pixel mask (if master_bpm is not None), bias, dark current (if master_dark is not None) and slit-flat (if master_slitflat is not None).

Images thus corrected are then stacked using the median. The result of the combination is saved as an intermediate result, named ‘reduced_image.fits’. This combined image is also returned in the field reduced_image of the recipe result.

The apertures in the 2D image are extracted, using the information in master_apertures and resampled according to the wavelength calibration in master_wlcalib. Then is divided by the master_fiberflat. The resulting RSS is saved as an intermediate result named ‘reduced_rss.fits’. This RSS is also returned in the field reduced_rss of the recipe result.

The sky is subtracted by combining the the fibers marked as SKY in the fibers configuration. The RSS with sky subtracted is returned ini the field final_rss of the recipe result.

The flux of the star is computed by adding summing the fibers in nrings around the central spaxel containing the star and returned as star_spectrum.

class LCBStandardRecipeInput(*args, **kwds)

LCBStandardRecipeInput documentation.

Attributes:
degrade_resolution_methodstr, requirement, optional, default=fixed

Method to degrade the resolution

degrade_resolution_targetstr, requirement, optional, default=object

Spectrum with higher resolution

diffuse_light_imageDiffuseLightCorrection, requirement, optional

Diffuse light correction image

extraction_offsetListOfType, requirement, optional, default=[0.0]

Offset traces for extraction

ignored_sky_bundlesListOfType, requirement, optional

Ignore these sky bundles

master_aperturesMultiType, requirement

Apertures information for extraction

master_biasMasterBias, requirement

Master BIAS image

master_bpmMasterBPM, requirement, optional

Master Bad Pixel Mask

master_darkMasterDark, requirement, optional

Master DARK image

master_fiberflatMasterFiberFlat, requirement

Master fiber flat calibration

master_sensitivityMasterSensitivity, requirement, optional

Master sensitivity for flux calibration

master_slitflatMasterSlitFlat, requirement, optional

Master slit flat calibration

master_twilightMasterTwilightFlat, requirement, optional

Master twlight flat calibration

master_wlcalibWavelengthCalibration, requirement

Wavelength calibration table

methodstr, requirement, optional, default=median

Combination method

method_kwargsdict, requirement, optional

Arguments for combination method

nringsint, requirement, optional, default=3

Number of rings to extract the star

obresultObservationResultType, requirement

Observation Result

positionPoint2D, requirement, optional

Position of the reference object

reference_extinctionReferenceExtinctionTable, requirement

Reference extinction

reference_spectrumReferenceSpectrumTable, requirement

Spectrum of reference star

reference_spectrum_velocityfloat, requirement, optional

Radial velocity (km/s) of reference spectrum

relative_thresholdfloat, requirement, optional, default=0.3

Threshold for peak detection

sigma_resolutionfloat, requirement, optional, default=20.0

sigma Gaussian filter to degrade resolution

sky_rssSkyRSS, requirement, optional

Row Stacked Spectra of the sky

smoothing_knotsMultiType, requirement, optional, default=3

List of nodes or number of nodes for sensitivity smoothing

class LCBStandardRecipeResult(*args, **kwds)

LCBStandardRecipeResult documentation.

Attributes:
fiber_idsArrayType, product
final_rssProcessedRSS, product
master_sensitivityMasterSensitivity, product
reduced_imageProcessedFrame, product
reduced_rssProcessedRSS, product
sensitivity_rawProcessedSpectrum, product
sigmafloat, product
sky_rssProcessedRSS, product
star_spectrumProcessedSpectrum, product
RecipeInput

alias of LCBStandardRecipeInput

RecipeResult

alias of LCBStandardRecipeResult

set_base_headers(hdr)

Set metadata in FITS headers.