00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022
00023
00024
00025
00026
00027
00028
00029
00030
00031
00032
00033
00034
00035
00036
00037
00038
00039
00040
00041
00042
00043
00044
00045
00046
00047
00048
00049
00050
00051
00052
00053
00054
00055
00056
00057
00058
00059
00060
00061
00062
00063
00064
00065
00066
00067
00068
00069
00070
00071
00072
00073
00074
00075
00076
00077
00078
00079
00080
00081
00082
00083
00084
00085
00086
00087
00088
00089
00090
00091
00092
00093
00094
00095
00096
00097
00098
00099
00100
00101
00102
00103
00104
00105
00106
00107
00108
00109
00110
00111
00112
00113
00114
00115
00116
00117
00118
00119
00120
00121
00122
00123
00124
00125
00126
00127
00128
00129
00130
00131
00132
00133
00134
00135
00136
00137
00138
00139
00140
00141
00142
00143
00144
00145
00146
00147
00148
00149
00150
00151
00152
00153
00154
00155
00156
00157
00158
00159
00160
00161
00162
00163
00164
00165
00166
00167
00168
00169
00170
00171
00172
00173
00174
00175
00176
00177
00178
00179
00180
00181
00182
00183
00184
00185
00186
00187
00188
00189
00190
00191
00192
00193
00194
00195
00196
00197
00198
00199
00200
00201
00202
00203
00204
00205
00206
00207
00208
00209
00210
00211
00212
00213
00214
00215
00216 #ifndef UVES_UTILS_H
00217 #define UVES_UTILS_H
00218
00219
00220 #ifdef HAVE_CONFIG_H
00221 # include <config.h>
00222 #endif
00223 #include <uves_cpl_size.h>
00224
00225
00226
00227
00228 #include <uves_utils_polynomial.h>
00229 #include <uves_extract_iterate.h>
00230 #include <uves_extract_profile.h>
00231 #include <uves_chip.h>
00232
00233 #include <cpl.h>
00234 #include <math.h>
00235
00236
00237
00238
00239
00240
00241 #if defined HAVE_DECL___FUNC__ && !HAVE_DECL___FUNC__
00242
00243 #ifndef __func__
00244 #define __func__ "<fct.id>"
00245 #endif
00246 #endif
00247
00248 #ifndef inline
00249 #define inline
00250 #endif
00251
00252
00253
00254
00255
00256
00257
00258
00259
00260
00261
00262 #ifndef WANT_BIG_LOGFILE
00263 #define WANT_BIG_LOGFILE 0
00264 #endif
00265
00266
00267
00268
00269
00270 #ifndef WANT_TIME_MEASURE
00271 #define WANT_TIME_MEASURE 0
00272 #endif
00273
00274
00275 #if WANT_TIME_MEASURE
00276 #define UVES_TIME_START(what) uves_msg("Timing (%s, l%d) %s start", \
00277 __FILE__, __LINE__, what)
00278 #define UVES_TIME_END uves_msg("Timing (%s, l%d) end", \
00279 __FILE__, __LINE__)
00280 #else
00281 #define UVES_TIME_START(what) uves_msg_debug("Timing (%s, l%d) %s start", \
00282 __FILE__, __LINE__, what)
00283 #define UVES_TIME_END uves_msg_debug("Timing (%s, l%d) end", \
00284 __FILE__, __LINE__)
00285 #endif
00286
00287
00288 #ifndef stringify
00289 #ifndef make_str
00290 #define stringify(X) #X
00291 #define make_str(X) stringify(X)
00292 #endif
00293 #endif
00294
00295 #define TWOSQRT2LN2 2.35482004503095
00296
00297 #ifndef M_PI
00298 #define M_PI 3.1415926535897932384626433832795
00299 #endif
00300
00301 #define SPEED_OF_LIGHT 299792458
00302
00303 #define COS_DEG(x) cos(((x)/180)*M_PI)
00304 #define SIN_DEG(x) sin(((x)/180)*M_PI)
00305 #define ACOS_DEG(x) (acos(x)*180/M_PI)
00306
00307
00308
00309
00310
00311 cpl_image *
00312 uves_create_image(uves_iterate_position *pos, enum uves_chip chip,
00313 const cpl_image *spectrum, const cpl_image *sky,
00314 const cpl_image *cosmic_image,
00315 const uves_extract_profile *profile,
00316 cpl_image **image_noise, uves_propertylist **image_header);
00317 cpl_frameset *
00318 uves_frameset_extract(const cpl_frameset *frames,const char *tag);
00319
00320 const char*
00321 uves_string_tolower(char* s);
00322 const char*
00323 uves_string_toupper(char* s);
00324
00325 double uves_gaussrand(void);
00326 double uves_pow_int(double x, int y);
00327 long uves_round_double(double x);
00328 double uves_max_double(double x, double y);
00329 int uves_max_int(int x, int y);
00330 double uves_min_double(double x, double y);
00331 int uves_min_int(int x, int y);
00332 double uves_error_fraction(double x, double y, double dx, double dy);
00333 const char *uves_get_license(void);
00334 cpl_error_code uves_get_version(int *major, int *minor, int *micro);
00335 int uves_get_version_binary(void);
00336
00337 char * uves_initialize(cpl_frameset *frames, const cpl_parameterlist *parlist,
00338 const char *recipe_id, const char *short_descr);
00339 cpl_error_code uves_end(const char *recipe_id, const cpl_frameset *frames);
00340
00341 uves_propertylist *uves_initialize_image_header(const char *ctype1, const char *ctype2,
00342 const char *bunit,
00343 double crval1 , double crval2,
00344 double crpix1 , double crpix2,
00345 double crdelt1, double crdelt2);
00346
00347 cpl_parameterlist*
00348 uves_parameterlist_duplicate(const cpl_parameterlist* pin);
00349
00350 cpl_image *uves_define_noise(const cpl_image *image, const uves_propertylist *image_header,
00351 int ncom, enum uves_chip);
00352 cpl_image *uves_average_images(const cpl_image *image1, const cpl_image *noise1,
00353 const cpl_image *image2, const cpl_image *noise2,
00354 cpl_image **noise);
00355
00356
00357 cpl_error_code uves_subtract_bias(cpl_image *image, const cpl_image *master_bias);
00358 cpl_error_code uves_subtract_dark(cpl_image *image, const uves_propertylist *image_header,
00359 const cpl_image *master_dark,
00360 const uves_propertylist *mdark_header);
00361
00362 polynomial *
00363 uves_polynomial_regression_2d_autodegree(cpl_table *t,
00364 const char *X1, const char *X2, const char *Y,
00365 const char *sigmaY,
00366 const char *polynomial_fit,
00367 const char *residual_square,
00368 const char *variance_fit,
00369 double *mean_squared_error, double *red_chisq,
00370 polynomial **variance, double kappa,
00371 int maxdeg1, int maxdeg2, double min_rms,
00372 double min_reject,
00373 bool verbose,
00374 const double *min_val,
00375 const double *max_val,
00376 int npos, double positions[][2]);
00377
00378 polynomial *
00379 uves_polynomial_regression_2d(cpl_table *t,
00380 const char *X1, const char *X2, const char *Y,
00381 const char *sigmaY,
00382 int degree1, int degree2,
00383 const char *polynomial_fit, const char *residual_square,
00384 const char *variance_fit,
00385 double *mse, double *red_chisq,
00386 polynomial **variance, double kappa,
00387 double min_reject);
00388
00389 polynomial *uves_polynomial_regression_1d(cpl_table *t,
00390 const char *X, const char *Y, const char *sigmaY,
00391 int degree,
00392 const char *polynomial_fit, const char *residual_square,
00393 double *mean_squared_error, const double kappa);
00394
00395 const char *uves_remove_string_prefix(const char *s, const char *prefix);
00396
00397 double uves_spline_hermite_table( double xp, const cpl_table *t, const char *column_x,
00398 const char *column_y, int *istart );
00399
00400 double uves_spline_hermite( double xp, const double *x, const double *y, int n, int *istart );
00401
00402 double uves_spline_cubic(double xp, double *x, float *y, float *y2, int n, int *kstart );
00403
00404 int uves_absolute_order(int first_abs_order, int last_abs_order, int relative_order);
00405
00406 double uves_average_reject(cpl_table *t,
00407 const char *column,
00408 const char *residual2,
00409 double kappa);
00410
00411
00412 cpl_table *uves_ordertable_traces_new(void);
00413 cpl_error_code uves_ordertable_traces_add(cpl_table *traces,
00414 int fibre_ID, double fibre_offset, int fibre_mask);
00415 bool uves_table_is_sorted_double(const cpl_table *t, const char *column, const bool reverse);
00416
00417 int uves_moffat(const double x[], const double a[], double *result);
00418 int uves_moffat_derivative(const double x[], const double a[], double result[]);
00419 int uves_gauss(const double x[], const double a[], double *result);
00420 int uves_gauss_derivative(const double x[], const double a[], double result[]);
00421 int uves_gauss_linear(const double x[], const double a[], double *result);
00422 int uves_gauss_linear_derivative(const double x[], const double a[], double result[]);
00423 void uves_check_version(void);
00424 void uves_frameset_dump(cpl_frameset* set);
00425 cpl_error_code
00426 uves_rcosmic(cpl_image* ima,
00427 cpl_image** flt,
00428 cpl_image** out,
00429 cpl_image** msk,
00430 const double sky,
00431 const double ron,
00432 const double gain,
00433 const int ns,
00434 const double rc);
00435
00436 cpl_image *
00437 uves_image_smooth_x(cpl_image * inp, const int r);
00438 cpl_image *
00439 uves_image_smooth_y(cpl_image * inp, const int r);
00440
00441 cpl_image *
00442 uves_image_smooth_mean_x(cpl_image * inp, const int r);
00443
00444 cpl_image *
00445 uves_image_smooth_median_x(cpl_image * inp, const int r);
00446 cpl_image *
00447 uves_image_smooth_fft(cpl_image * inp, const int fx);
00448
00449 cpl_image *
00450 uves_ksigma_stack(const cpl_imagelist *imlist, double klow, double khigh, int kiter);
00451
00452
00453 cpl_image *
00454 uves_flat_create_normalized_master(cpl_imagelist * flats,
00455 const cpl_table *ordertable,
00456 const polynomial* order_locations,
00457 const cpl_vector* gain_vals,
00458 double* fnoise);
00459
00460 cpl_image *
00461 uves_flat_create_normalized_master2(cpl_imagelist * flats,
00462 const cpl_table *ordertable,
00463 const polynomial* order_locations,
00464 const cpl_image* mflat);
00465
00466 cpl_vector *
00467 uves_imagelist_get_clean_mean_levels(cpl_imagelist* iml, double kappa);
00468 cpl_error_code
00469 uves_imagelist_subtract_values(cpl_imagelist** iml, cpl_vector* values);
00470 cpl_image *
00471 uves_get_wave_map(cpl_image * ima_sci,
00472 const char *context,
00473 const cpl_parameterlist *parameters,
00474 const cpl_table *ordertable,
00475 const cpl_table *linetable,
00476 const polynomial* order_locations,
00477 const polynomial *dispersion_relation,
00478 const int first_abs_order,
00479 const int last_abs_order,
00480 const int slit_size);
00481
00482 cpl_image*
00483 uves_image_mflat_detect_blemishes(const cpl_image* flat,
00484 const uves_propertylist* head);
00485
00486
00487 cpl_error_code
00488 uves_table_remove_units(cpl_table **table);
00489 cpl_error_code
00490 uves_table_unify_units(cpl_table **table2, cpl_table **table1);
00491 cpl_error_code
00492 uves_tablenames_unify_units(const char* tname2, const char* tname1);
00493 cpl_error_code
00494 uves_tablename_remove_units(const char* tname);
00495
00496 #endif