MUSE Pipeline Reference Manual
1.0.2
|
Enumerations | |
enum | muse_xcombine_types { MUSE_XCOMBINE_EXPTIME = 0, MUSE_XCOMBINE_FWHM = 1, MUSE_XCOMBINE_NONE } |
Xposure combination types. More... | |
Functions | |
cpl_error_code | muse_xcombine_weights (muse_pixtable **aPixtables, muse_xcombine_types aWeighting) |
compute the weights for combination of two or more exposures More... | |
muse_pixtable * | muse_xcombine_tables (muse_pixtable **aPixtables) |
combine the pixel tables of several exposures into one More... | |
enum muse_xcombine_types |
Xposure combination types.
Enumerator | |
---|---|
MUSE_XCOMBINE_EXPTIME |
weight exposures by exposure time |
MUSE_XCOMBINE_FWHM |
weight exposures by fwhm (and exposure time) |
MUSE_XCOMBINE_NONE |
do not weight exposures at all |
Definition at line 44 of file muse_xcombine.h.
muse_pixtable* muse_xcombine_tables | ( | muse_pixtable ** | aPixtables | ) |
combine the pixel tables of several exposures into one
aPixtables | the NULL-terminated array of pixel tables to combine |
Determine offsets from input FITS headers, loop through all pixel tables, position them to the RA,DEC in their headers using muse_wcs_position_celestial(), and append the small pixel tables to the end of the output pixel table. All used input pixel tables are deleted in this function, only the input pointer remains.
The behavior of this function can be tweaked using the environment variables MUSE_XCOMBINE_RA_OFFSETS and MUSE_XCOMBINE_DEC_OFFSETS, so that one can align exposures with different relative offsets not reflected in the RA and DEC headers. If this is done, the header keywords MUSE_HDR_OFFSETi_DATEOBS, MUSE_HDR_OFFSETi_DRA, and MUSE_HDR_OFFSETi_DDEC are written to the header of the output pixel table, to show which RA and DEC offsets were applied to the exposure of which DATE-OBS.
set CPL_ERROR_NULL_INPUT, return NULL | aPixtables is NULL |
set CPL_ERROR_ILLEGAL_INPUT, return NULL | there are less than 2 input pixel tables |
set CPL_ERROR_INCOMPATIBLE_INPUT, return NULL | first pixel table was not projected to native spherical coordinates |
output warning | first pixel table was not radial-velocity corrected |
skip this pixel table | other pixel tables were not projected to native spherical coordinates |
output warning | another pixel table was not radial-velocity corrected |
Definition at line 192 of file muse_xcombine.c.
References muse_pixtable::header, muse_cplarray_new_from_delimited_string(), MUSE_HDR_PT_COMBINED, MUSE_HDR_PT_EXP_FST, MUSE_HDR_PT_EXP_LST, muse_pfits_get_dateobs(), muse_pfits_get_dec(), muse_pfits_get_ra(), muse_pixtable_compute_limits(), muse_pixtable_delete(), muse_pixtable_get_nrow(), muse_pixtable_is_rvcorr(), muse_pixtable_origin_copy_offsets(), muse_pixtable_wcs_check(), MUSE_PIXTABLE_WCS_NATSPH, muse_utils_memory_dump(), muse_wcs_position_celestial(), and muse_pixtable::table.
cpl_error_code muse_xcombine_weights | ( | muse_pixtable ** | aPixtables, |
muse_xcombine_types | aWeighting | ||
) |
compute the weights for combination of two or more exposures
aPixtables | the NULL-terminated array of pixel tables to weight |
aWeighting | the weighting scheme to use |
For exposure time weighting (aWeighting == MUSE_XCOMBINE_EXPTIME), compute the ratio of the exposure time of the current exposure with the one from the first exposure, and store this ratio as weight in a new table column. For FWHM-based weighting (aWeighting == MUSE_XCOMBINE_FWHM), use the DIMM seeing information, and multiply the FWHM ratio by the exposure-weight to form the final weight.
If aWeighting is MUSE_XCOMBINE_NONE, this function only checks for valid inputs, but then returns without doing anything.
return CPL_ERROR_NULL_INPUT | aPixtables is NULL |
return CPL_ERROR_ILLEGAL_INPUT | there are less than 2 input pixel tables |
output warning and return CPL_ERROR_UNSUPPORTED_MODE | an unknown weighting scheme was given |
return CPL_ERROR_INCOMPATIBLE_INPUT | EXPTIME is not set in the header of the first pixel table |
weights for these tables are set to zero | the exposure time header is missing from one or more input pixel tables |
FWHM-weights for these tables are set to 1., propagate errors, output warning, but return CPL_ERROR_NONE | the FWHM header entries are missing from one or more input pixel tables although MUSE_XCOMBINE_FWHM is requrested |
Definition at line 81 of file muse_xcombine.c.
References MUSE_HDR_PT_WEIGHTED, muse_pfits_get_exptime(), muse_pfits_get_fwhm_end(), muse_pfits_get_fwhm_start(), muse_pixtable_get_nrow(), MUSE_XCOMBINE_EXPTIME, MUSE_XCOMBINE_FWHM, and MUSE_XCOMBINE_NONE.