Recipe: Response

Functions

cpl_error_code uves_response_efficiency (const cpl_image *raw_image, const uves_propertylist *raw_header, const uves_propertylist *rotated_header, const cpl_image *master_bias, const cpl_image *master_dark, const uves_propertylist *mdark_header, const cpl_table *ordertable, const polynomial *order_locations, const cpl_table *linetable[3], const uves_propertylist *linetable_header[3], const polynomial *dispersion_relation[3], const cpl_table *flux_table, const cpl_table *atm_extinction, enum uves_chip chip, bool DEBUG, const cpl_parameterlist *parameters, double PACCURACY, cpl_table **efficiency, cpl_table **blaze_efficiency)
 Calculate quantum detection efficiency.
cpl_image * uves_calculate_response (const cpl_image *spectrum, const uves_propertylist *spectrum_header, const cpl_table *flux_table, const uves_propertylist *raw_header, double PACCURACY, bool inverse, char **ref_obj_id)
 Calculate response.
cpl_table * uves_align (const uves_propertylist *object_header, const cpl_table *flux_table, double accuracy, char **ref_name_dynamic)
 Match a star against a catalogue of stars.

Detailed Description

This recipe calculates the response function and the quantum detection efficiency. See man-page for details.


Function Documentation

cpl_error_code uves_response_efficiency ( const cpl_image *  raw_image,
const uves_propertylist raw_header,
const uves_propertylist rotated_header,
const cpl_image *  master_bias,
const cpl_image *  master_dark,
const uves_propertylist mdark_header,
const cpl_table *  ordertable,
const polynomial order_locations,
const cpl_table *  linetable[3],
const uves_propertylist linetable_header[3],
const polynomial dispersion_relation[3],
const cpl_table *  flux_table,
const cpl_table *  atm_extinction,
enum uves_chip  chip,
bool  DEBUG,
const cpl_parameterlist *  parameters,
double  PACCURACY,
cpl_table **  efficiency,
cpl_table **  blaze_efficiency 
)

Calculate quantum detection efficiency.

Parameters:
raw_image The raw image
raw_header FITS header of raw image
rotated_header Header describing the geometry of the raw image after rotation and removal of pre- and overscan areas
master_bias The master bias image for this chip, or NULL
master_dark The master dark image for this chip, or NULL
mdark_header FITS header of master dark frame
ordertable Order table describing the order locations on the raw image
order_locations The polynomial describing the order positions
linetable Length 3 array of linetable for sky, object, sky.
linetable_header Length 3 array of linetable headers for sky, object, sky.
dispersion_relation Length 3 array of dispersion relations for sky, object, sky.
flux_table Catalogue standard star fluxes
atm_extinction Atmospheric extinction coefficients
chip CCD chip
DEBUG If set to true, intermediate results are saved to the current directory
parameters The recipe parameter list containing parameters for background subtraction, flat-fielding, extraction, rebinning
PACCURACY Pointing accuracy (in arcseconds) used to identify object
efficiency (out) The quantum detection efficiency table
blaze_efficiency (out) Efficiency at blaze function maximum, for each order
Returns:
The reduced spectrum

Definition at line 100 of file uves_response_efficiency.c.

References check, uves_absolute_order(), uves_calculate_response(), uves_filter_image_median(), uves_msg, uves_msg_debug, uves_normalize_spectrum(), uves_pfits_get_cdelt1(), uves_pfits_get_firstabsorder(), uves_pfits_get_lastabsorder(), uves_pfits_get_wend(), uves_pfits_get_wstart(), uves_polynomial_collapse(), uves_polynomial_delete(), uves_polynomial_derivative_2d(), uves_polynomial_solve_1d(), and uves_reduce().

cpl_image* uves_calculate_response ( const cpl_image *  spectrum,
const uves_propertylist spectrum_header,
const cpl_table *  flux_table,
const uves_propertylist raw_header,
double  PACCURACY,
bool  inverse,
char **  ref_obj_id 
)

Calculate response.

Parameters:
spectrum The 1d (merged) or 2d (non-merged) spectrum
spectrum_header Header describing the geometry of the input spectrum
flux_table Table of standard star fluxes
raw_header Header of the raw frame
PACCURACY Pointing accuracy (in arcseconds) used to find a unique matching object in the flux_table
inverse If false, flux/std_flux is calculated, if true std_flux/flux is computed.
ref_obj_id (output) reference object ID. Must be deallocated by the caller
Returns:
Response curve

Undefined values (division by zero) are set to zero.

Definition at line 143 of file uves_response_utils.c.

References check, uves_align(), uves_pfits_get_cdelt1(), uves_pfits_get_crval1(), uves_pfits_get_wstart(), and uves_spline_hermite_table().

Referenced by uves_response_efficiency().

cpl_table* uves_align ( const uves_propertylist object_header,
const cpl_table *  flux_table,
double  accuracy,
char **  ref_name_dynamic 
)

Match a star against a catalogue of stars.

Parameters:
object_header Header containing the object coordinates
flux_table The catalogue of standard star coordinates and fluxes
accuracy The pointing accuracy in arcseconds
ref_name_dynamic (output) reference object ID. Must be deallocated by the caller
Returns:
Table containing the catalogue flux of the identified star.

The input object coordinates are matched against the list of standard star coordinates.

Exactly one reference star must match the object within the specified accuracy, or an error is set.

The spectrum of the uniquely identified star is read from the catalogue and returned as a (2D) table.

Definition at line 260 of file uves_response_utils.c.

References assure_nomsg, check, uves_max_double(), uves_min_double(), uves_msg, uves_msg_debug, uves_pfits_get_dec(), and uves_pfits_get_ra().

Referenced by test_3dtable(), and uves_calculate_response().


Generated on 9 Mar 2012 for UVES Pipeline Reference Manual by  doxygen 1.6.1