SOURCES: lib/eval.c, lib/eval_par.c
LAST MODIFICATION DATE:
#define GPIV_CUM_RESIDU_MIN 0.25 |
minimum cumulative residu for convergence
#define GPIV_DEFORMED_IMG_NAME "gpiv_defimg" |
Deformed image to be stored in TMP_DIR
#define GPIV_DIFF_ISI 0 |
difference between interrogation sizes of first and second image if zero offset has been used
#define GPIV_EVALPAR_DEFAULT__AD_INT 0 |
Default parameter for ad_int of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__AUTOKEY 1 |
Default parameter for autokey of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__COL_END 255 |
Default parameter for col_end of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__COL_START 0 |
Default parameter for col_start of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__GAUSS_WEIGHT_IA 1 |
Default parameter for gauss_weight_ia of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__IFIT 1 |
Default parameter for ifit of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_GEO 0 |
Default parameter for int_geo of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_LINE_COL 64 |
Default parameter for int_line_col of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_LINE_COL_END 127 |
Default parameter for int_line_col_end of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_LINE_COL_START 0 |
Default parameter for int_line_col_start of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_LINE_ROW 64 |
Default parameter for int_line_row of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_LINE_ROW_END 127 |
Default parameter for int_line_row_end of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_LINE_ROW_START 0 |
Default parameter for int_line_row_start of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_POINT_COL 64 |
Default parameter for int_line_col_end of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_POINT_ROW 64 |
Default parameter for int_point_row of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_SCHEME 4 |
Default parameter for int_scheme of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_SHIFT 16 |
Default parameter for int_shift of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_SIZE_1 64 |
Default parameter for int_size_1 of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__INT_SIZE_2 32 |
Default parameter for int_size_2
#define GPIV_EVALPAR_DEFAULT__OLD_PIV 0 |
Default parameter for old_piv
#define GPIV_EVALPAR_DEFAULT__PEAK 1 |
Default parameter for peak of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__PRE_SHIFT_COL 0 |
Default parameter for pre_shift_col of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__PRE_SHIFT_ROW 0 |
Default parameter for pre_shift_row of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__ROW_END 255 |
Default parameter for row_end of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__ROW_START 0 |
Default parameter for row_start of __GpivEvalPar
#define GPIV_EVALPAR_DEFAULT__SPOF_FILTER 0 |
Default parameter for spof_filter of __GpivEvalPar
#define GPIV_MAX_EVAL_SWEEP 10 |
maximum number of evaluation sweeps, starting from zero
#define GPIV_SNR_DISABLE 88.0 |
snr value for manually disabled estimator
#define GPIV_ZEROPAD_FACT 2 |
magnification factor of zero-padded int. area
typedef struct __GpivCovariance Covariance |
Covariance and derived data to fold into an array
typedef struct __GpivEvalPar GpivEvalPar |
PIV evaluation parameters needed for interrogation
enum GpivIFit |
enum GpivIntGeo |
enum GpivIntScheme |
char* gpiv_eval_write_deformed_image | ( | guint16 ** | img1, | |
guint16 ** | img2, | |||
GpivImagePar | image_par | |||
) |
Stores deformed image to file system with pre defined name to TMPDIR and prints message to stdout
[in] | img1 | first image of PIV image pair |
[in] | img2 | second image of PIV image pair |
[in] | image_par | pointer to image parameter structure for header |
void gpiv_fread_fftw_wisdom | ( | int | dir | ) |
Reads fftw wisdoms from file and stores into a (public) string
[in] | dir | direction of fft; forward (+1) or inverse (-1) |
void gpiv_fwrite_fftw_wisdom | ( | int | dir | ) |
Writes fftw wisdoms to a file
[in] | dir | direction of fft; forward (+1) or inverse (-1) |
void gpiv_piv_bounds_cov | ( | Covariance * | cov, | |
int | int_size_0, | |||
GpivImagePar | image_par | |||
) |
Calculate boundaries of covariance data array
[in] | int_size_0 | zero-padded interrogation size |
[in] | image_par | structure of image parameters |
[out] | cov | Structure containing covariance data and boundaries |
char* gpiv_piv_check_parameters_read | ( | GpivEvalPar * | piv_eval_par, | |
GpivEvalPar | piv_eval_par_default | |||
) |
Checks out if all parameters have been read. If a parameter has not been read, it will set to the default value.
[in] | piv_eval_par_default | default parameters |
[out] | piv_eval_par | PIV evaluation parameters |
char* gpiv_piv_count_pivdata_fromimage | ( | GpivPivData * | out_data, | |
GpivImagePar | image_par, | |||
GpivEvalPar | piv_eval_par | |||
) |
Calculates the number of interrogation areas from the image sizes, pre-shift and area of interest
[in] | image_par | structure of image parameters |
[in] | piv_eval_par | structure of piv evaluation parameters |
[out] | out_data | output piv data from image analysis |
void gpiv_piv_cp_parameters | ( | GpivEvalPar | piv_eval_par_src, | |
GpivEvalPar * | piv_eval_par_dest, | |||
gboolean | force, | |||
gboolean | print_par | |||
) |
Copies piv parameters from src to dest
[in] | piv_eval_par_src | source piv parameters |
[in] | force | flag to force the copying, even if destination already exists |
[in] | print_par | verbose output. Not implemented, yet. |
[out] | piv_eval_par_dest | destination piv parameters |
void gpiv_piv_default_parameters | ( | GpivEvalPar * | piv_eval_par_default, | |
gboolean | flag | |||
) |
Sets default parameter values
[in] | flag | flag to enforce parameters set to defaults |
[out] | piv_eval_par_default | structure of piv evaluation parameters |
void gpiv_piv_fprint_parameters | ( | FILE * | fp_par_out, | |
GpivEvalPar | piv_eval_par | |||
) |
Prints parameters to fp_par_out
[in] | fp_par_out | |
[in] | piv_eval_par | PIV evaluation parameters |
char* gpiv_piv_fread_hdf5_parameters | ( | char * | fname, | |
GpivEvalPar * | piv_eval_par | |||
) |
Reads piv parameters from hdf5 data file
[in] | fname | input filename |
[out] | piv_eval_par |
char* gpiv_piv_fwrite_hdf5_parameters | ( | char * | fname, | |
GpivEvalPar * | piv_eval_par | |||
) |
Writes piv parameters from hdf5 data file
[in] | fname | output filename |
[out] | piv_eval_par | parameters |
char* gpiv_piv_interr_reg | ( | int | index_y, | |
int | index_x, | |||
guint16 ** | img_1, | |||
guint16 ** | img_2, | |||
float ** | int_area_1, | |||
float ** | int_area_2, | |||
Covariance * | cov, | |||
Covariance * | w_k, | |||
GpivPivData * | piv_data, | |||
int | sweep, | |||
int | last_sweep, | |||
GpivImagePar | image_par, | |||
GpivEvalPar | piv_eval_par | |||
) |
Interrogates an individual region
[in] | index_y | y-index of interrogation area position |
[in] | index_x | x-index of interrogation area position |
[in] | img_1 | (binary) image data of first piv image |
[in] | img_2 | (binary) image data of second piv image |
[in] | int_area_1 | first interrogation area |
[in] | int_area_2 | second interrogation area |
[in] | cov | structure containing covariance data |
[in] | w_k | structure containing weight kerel data |
[in] | sweep | sweep number of iterative process |
[in] | last_sweep | flag for last sweep |
[in] | image_par | structure of image parameters |
[in] | piv_eval_par | structure of piv evaluation parameters |
[out] | piv_data | output piv data from image analysis |
void gpiv_piv_isizadapt | ( | GpivEvalPar | piv_eval_par_src, | |
GpivEvalPar * | piv_eval_par_dest, | |||
gboolean * | isiz_last | |||
) |
Adjusts interrogation area sizes. For each interrogation sweep, (dest) int_size2 is halved, until it reaches (src) int_size_1. Then, isiz_last is set TRUE, which will avoid changing the interrogation sizes in next calls.
[in] | piv_eval_par_src | original parameters |
[out] | piv_eval_par_dest | actual parameters, to be modified during sweeps |
[out] | isiz_last | flag for last interrogation sweep |
void gpiv_piv_parameters_logic | ( | GpivEvalPar * | piv_eval_par, | |
gboolean | flag | |||
) |
Sets flags for all piv_eval_par_logic
[in] | flag | true (1) or false (0) |
[out] | piv_eval_par | PIV evaluation parameters |
void gpiv_piv_print_parameters | ( | GpivEvalPar | piv_eval_par | ) |
Prints parameters to stdout
[in] | piv_eval_par | PIV evaluation parameters |
void gpiv_piv_read_parameters | ( | FILE * | fp_par, | |
GpivEvalPar * | piv_eval_par, | |||
int | print_par | |||
) |
Reads all parameters for PIV evaluation
[in] | fp_par | file pointer to parameter file |
[in] | print_par | flag to print parametrs to stdout |
[out] | piv_eval_par |
char* gpiv_piv_select_int_point | ( | GpivPivData * | out_data, | |
GpivImagePar | image_par, | |||
GpivEvalPar | piv_eval_par | |||
) |
Calculates the positions of interrogation areas to be analysed
[in] | image_par | structure of image parameters |
[in] | piv_eval_par | structure of piv evaluation parameters |
[out] | out_data | output piv data from image analysis |
char* gpiv_piv_test_parameters | ( | GpivImagePar * | image_par, | |
GpivEvalPar * | piv_eval_par | |||
) |
Tests parameters on valid values and initializing derived variables
[in] | image_par | image parameters |
[in] | piv_eval_par | PIV evaluation parameters |
[out] | piv_eval_par |
void gpiv_piv_weight_kernel_1 | ( | Covariance * | w_k | ) |
Sets weight values for covariance data to one
[in] | w_k | zero-padded interrogation size |
void gpiv_piv_weight_kernel_lin | ( | Covariance * | w_k, | |
int | int_size_0 | |||
) |
Calculates linear weight kernel values for covariance data
[out] | w_k | Structure containing weighting data |
[out] | int_size_0 | zero-padded interrogation size |