GIRAFFE Pipeline Reference Manual

Flux calibration

Functions

cxint giraffe_calibrate_flux (GiResponse *result, const GiRebinning *spectra, const GiTable *fibers, const GiImage *flat, const GiTable *flux, const GiTable *extinction, const GiFxCalibrationConfig *config)
 Compute the response and efficiency curves.
 
void giraffe_fxcalibration_config_destroy (GiFxCalibrationConfig *self)
 Destroy a flux calibration setup structure.
 
void giraffe_fxcalibration_config_add (cpl_parameterlist *parameters)
 Add flux calibration parameters to a parameter list.
 

Detailed Description

TBD

Function Documentation

cxint giraffe_calibrate_flux ( GiResponse *  result,
const GiRebinning *  spectra,
const GiTable *  fibers,
const GiImage *  flat,
const GiTable *  flux,
const GiTable *  extinction,
const GiFxCalibrationConfig *  config 
)

Compute the response and efficiency curves.

Parameters
resultThe object where the results are stored.
spectraThe rebinned spectra of a flux standard.
fibersThe list of used fibers.
flatThe extracted flat field.
fluxTable with the reference flux of the observed standard.
extinctionTable with the wavelength dependent atmospheric extinction coefficients.
configThe configuration options.
Returns
The function returns 0 on success, or a non-zero value if an error occurred.

The function computes the wavelength dependent instrument response and efficiency curves from the observed and rebinned spectrum of a flux standard, and stores them in the result object result. The response is defined as the function by which the incident spectrum at the top of the atmosphere has to be multiplied, in order to obtain the spectrum recorded with the detector. The efficiency is the ratio of detected photons (corrected for the atmospheric extinction) over the number of incident photons.

The function expects as input an observation of a single flux standard, i.e. no other target is visible with in the Argus field of view, or, in case of an IFU observation, all buttons are either used to observe the target, or point to blank sky. As additional constraint, the individual fiber spectra of the flux standard have to be rebinned to a common wavelength grid, i.e. the wavelength range for all fibers has to be the same.

The total observed flux of the flux standard is computed by adding up the spectra of all fibers. No background subtraction, and, in the case of Argus, no source detection is performed. The response and the efficiency curves are computed for the wavelength range given by the rebinned flux standard observation.

Definition at line 1511 of file gifxcalibration.c.

References gi_warning(), giraffe_image_get(), giraffe_image_get_properties(), giraffe_image_new(), giraffe_image_set(), giraffe_image_set_properties(), giraffe_table_get(), giraffe_table_new(), giraffe_table_set(), and giraffe_table_set_properties().

void giraffe_fxcalibration_config_add ( cpl_parameterlist *  parameters)

Add flux calibration parameters to a parameter list.

Parameters
parametersThe list of parameters to update.
Returns
Nothing

The function updates the list of parameters parameters with the configuration parameters of the flux calibration task.

Definition at line 1877 of file gifxcalibration.c.

void giraffe_fxcalibration_config_destroy ( GiFxCalibrationConfig *  self)

Destroy a flux calibration setup structure.

Parameters
selfThe setup structure to destroy.
Returns
Nothing.

The function deallocates the memory used by the setup structure self, and the setup structure itself.

Definition at line 1851 of file gifxcalibration.c.


This file is part of the GIRAFFE Pipeline Reference Manual 2.12.
Documentation copyright © 2002-2006 European Southern Observatory.
Generated on Mon Mar 24 2014 11:43:53 by doxygen 1.8.2 written by Dimitri van Heesch, © 1997-2004