|
CR2RE Pipeline Reference Manual 1.6.7
|
Algorithms to detect bad-pixels on a sequence of images like e.g. domeflats. More...
Functions | |
| hdrl_parameter * | hdrl_bpm_fit_parameter_create_pval (int degree, double pval) |
| create bpm_fit parameter with p-value bpm treshold | |
| hdrl_parameter * | hdrl_bpm_fit_parameter_create_rel_chi (int degree, double rel_chi_low, double rel_chi_high) |
| create bpm_fit parameter with relative chi bpm treshold | |
| hdrl_parameter * | hdrl_bpm_fit_parameter_create_rel_coef (int degree, double rel_coef_low, double rel_coef_high) |
| create bpm_fit parameter with relative coefficient bpm treshold | |
| cpl_boolean | hdrl_bpm_fit_parameter_check (const hdrl_parameter *self) |
| Check that the parameter is a bpm_fit parameter. | |
| cpl_error_code | hdrl_bpm_fit_parameter_verify (const hdrl_parameter *p) |
| verify that the parameter is a valid bpm_fit_parameter | |
| int | hdrl_bpm_fit_parameter_get_degree (const hdrl_parameter *p) |
| get degree of polynomial fit of parameter | |
| double | hdrl_bpm_fit_parameter_get_pval (const hdrl_parameter *p) |
| get p-value bpm treshold | |
| double | hdrl_bpm_fit_parameter_get_rel_chi_low (const hdrl_parameter *p) |
| get relative chi distribution lower threshold | |
| double | hdrl_bpm_fit_parameter_get_rel_chi_high (const hdrl_parameter *p) |
| get relative chi distribution upper threshold | |
| double | hdrl_bpm_fit_parameter_get_rel_coef_low (const hdrl_parameter *p) |
| get relative fit coefficient distribution lower threshold | |
| double | hdrl_bpm_fit_parameter_get_rel_coef_high (const hdrl_parameter *p) |
| get relative fit coefficient distribution upper threshold | |
| cpl_parameterlist * | hdrl_bpm_fit_parameter_create_parlist (const char *base_context, const char *prefix, const hdrl_parameter *defaults) |
| Create a parameter list for the BPM_FIT computation. | |
| hdrl_parameter * | hdrl_bpm_fit_parameter_parse_parlist (const cpl_parameterlist *parlist, const char *prefix) |
| Parse a parameterlist to create input parameters for the BPM_FIT. | |
| cpl_error_code | hdrl_bpm_fit_compute (const hdrl_parameter *par, const hdrl_imagelist *data, const cpl_vector *sample_pos, cpl_image **out_mask) |
| compute bad pixel map based on fitting a stack of images | |
Algorithms to detect bad-pixels on a sequence of images like e.g. domeflats.
The routine in this module derives bad pixels on a sequence of images (e.g. domeflats with differend exposure time). The algorithm fits a polynomial to each pixel-sequence and determinates bad pixels based on this fit and various thresholding methods.
The calculation is performed by calling the top-level function hdrl_bpm_fit_compute() and the parameters passed to this function can be created by calling hdrl_bpm_fit_parameter_create_rel_chi(), or hdrl_bpm_fit_parameter_create_rel_coef(), or hdrl_bpm_fit_parameter_create_pval(), depending on the method one would like to use.
| cpl_error_code hdrl_bpm_fit_compute | ( | const hdrl_parameter * | par, |
| const hdrl_imagelist * | data, | ||
| const cpl_vector * | sample_pos, | ||
| cpl_image ** | out_mask | ||
| ) |
compute bad pixel map based on fitting a stack of images
| par | input bpm_fit_parameter |
| data | hdrl_imagelist to fit |
| sample_pos | cpl_vector of sampling position of the images in data, e.g. exposure time |
| out_mask | output bad pixel mask as integer image |
The function fits a polynomial of degree degree to the imagelist at the sampling positions defined in sample_pos.
Three methods are available to convert the information from the fit into a bad pixel map:
Relative cutoff on the chi distribution of all fits. Pixels with chi values strictly outside the interval 

Relative cutoff on the distribution of the fit coefficients. Pixels with fit coefficients strictly outside the interval 

Pixels with low p-value. When the errors of the pixels are correct the p-value can be interpreted as the probability with which the pixel response fits the chosen model. The corresponding hdrl parameter is created by hdrl_bpm_fit_parameter_create_pval() Definition at line 587 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_get_degree(), hdrl_bpm_fit_parameter_get_pval(), hdrl_bpm_fit_parameter_get_rel_chi_high(), hdrl_bpm_fit_parameter_get_rel_chi_low(), hdrl_bpm_fit_parameter_get_rel_coef_high(), hdrl_bpm_fit_parameter_get_rel_coef_low(), hdrl_bpm_fit_parameter_verify(), hdrl_fit_polynomial_imagelist(), hdrl_image_get_image(), hdrl_imagelist_delete(), hdrl_imagelist_get(), and hdrl_imagelist_get_size().
| cpl_boolean hdrl_bpm_fit_parameter_check | ( | const hdrl_parameter * | self | ) |
Check that the parameter is a bpm_fit parameter.
| self | The parameter to check |
Definition at line 190 of file hdrl_bpm_fit.c.
Referenced by hdrl_bpm_fit_parameter_create_parlist(), hdrl_bpm_fit_parameter_get_degree(), hdrl_bpm_fit_parameter_get_pval(), hdrl_bpm_fit_parameter_get_rel_chi_high(), hdrl_bpm_fit_parameter_get_rel_chi_low(), hdrl_bpm_fit_parameter_get_rel_coef_high(), hdrl_bpm_fit_parameter_get_rel_coef_low(), and hdrl_bpm_fit_parameter_verify().
| cpl_parameterlist * hdrl_bpm_fit_parameter_create_parlist | ( | const char * | base_context, |
| const char * | prefix, | ||
| const hdrl_parameter * | defaults | ||
| ) |
Create a parameter list for the BPM_FIT computation.
| base_context | base context of parameter (e.g. recipe name) |
| prefix | prefix of parameter, may be empty string |
| defaults | default values |
Creates a parameterlist with the BPM_FIT parameters:
Definition at line 363 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_check(), hdrl_bpm_fit_parameter_get_degree(), hdrl_bpm_fit_parameter_get_pval(), hdrl_bpm_fit_parameter_get_rel_chi_high(), hdrl_bpm_fit_parameter_get_rel_chi_low(), hdrl_bpm_fit_parameter_get_rel_coef_high(), and hdrl_bpm_fit_parameter_get_rel_coef_low().
| hdrl_parameter * hdrl_bpm_fit_parameter_create_pval | ( | int | degree, |
| double | pval | ||
| ) |
create bpm_fit parameter with p-value bpm treshold
| degree | degree of fit |
| pval | p-value of bpm threshold |
Definition at line 142 of file hdrl_bpm_fit.c.
| hdrl_parameter * hdrl_bpm_fit_parameter_create_rel_chi | ( | int | degree, |
| double | rel_chi_low, | ||
| double | rel_chi_high | ||
| ) |
create bpm_fit parameter with relative chi bpm treshold
| degree | degree of fit |
| rel_chi_low | relative chi distribution bpm lower threshold |
| rel_chi_high | relative chi distribution bpm upper threshold |
Definition at line 158 of file hdrl_bpm_fit.c.
| hdrl_parameter * hdrl_bpm_fit_parameter_create_rel_coef | ( | int | degree, |
| double | rel_coef_low, | ||
| double | rel_coef_high | ||
| ) |
create bpm_fit parameter with relative coefficient bpm treshold
| degree | degree of fit |
| rel_coef_low | relative fit coefficient distribution bpm lower threshold |
| rel_coef_high | relative fit coefficient distribution bpm upper threshold |
Definition at line 176 of file hdrl_bpm_fit.c.
| int hdrl_bpm_fit_parameter_get_degree | ( | const hdrl_parameter * | p | ) |
get degree of polynomial fit of parameter
| p | parameter |
Definition at line 263 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_check().
Referenced by hdrl_bpm_fit_compute(), and hdrl_bpm_fit_parameter_create_parlist().
| double hdrl_bpm_fit_parameter_get_pval | ( | const hdrl_parameter * | p | ) |
get p-value bpm treshold
| p | parameter |
Definition at line 278 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_check().
Referenced by hdrl_bpm_fit_compute(), and hdrl_bpm_fit_parameter_create_parlist().
| double hdrl_bpm_fit_parameter_get_rel_chi_high | ( | const hdrl_parameter * | p | ) |
get relative chi distribution upper threshold
| p | parameter |
Definition at line 308 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_check().
Referenced by hdrl_bpm_fit_compute(), and hdrl_bpm_fit_parameter_create_parlist().
| double hdrl_bpm_fit_parameter_get_rel_chi_low | ( | const hdrl_parameter * | p | ) |
get relative chi distribution lower threshold
| p | parameter |
Definition at line 293 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_check().
Referenced by hdrl_bpm_fit_compute(), and hdrl_bpm_fit_parameter_create_parlist().
| double hdrl_bpm_fit_parameter_get_rel_coef_high | ( | const hdrl_parameter * | p | ) |
get relative fit coefficient distribution upper threshold
| p | parameter |
Definition at line 338 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_check().
Referenced by hdrl_bpm_fit_compute(), and hdrl_bpm_fit_parameter_create_parlist().
| double hdrl_bpm_fit_parameter_get_rel_coef_low | ( | const hdrl_parameter * | p | ) |
get relative fit coefficient distribution lower threshold
| p | parameter |
Definition at line 323 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_check().
Referenced by hdrl_bpm_fit_compute(), and hdrl_bpm_fit_parameter_create_parlist().
| hdrl_parameter * hdrl_bpm_fit_parameter_parse_parlist | ( | const cpl_parameterlist * | parlist, |
| const char * | prefix | ||
| ) |
Parse a parameterlist to create input parameters for the BPM_FIT.
| parlist | parameter list to parse |
| prefix | prefix of parameter name |
Reads a parameterlist in order to create BPM image parameters. Expects a parameterlist containing:
Definition at line 442 of file hdrl_bpm_fit.c.
References hdrl_join_string().
| cpl_error_code hdrl_bpm_fit_parameter_verify | ( | const hdrl_parameter * | p | ) |
verify that the parameter is a valid bpm_fit_parameter
| p | parameter |
Definition at line 202 of file hdrl_bpm_fit.c.
References hdrl_bpm_fit_parameter_check().
Referenced by hdrl_bpm_fit_compute().