Libpiv API documentation

 Search for 

/home/gerber/gpiv_all/libgpiv-0.4.0/include/gpiv/eval_speed.h File Reference

module for advanced image evaluation More...

Defines
#define	CMPR_FACT   2
#define	GPIV_SHIFT_FACTOR   3
Functions
char *	gpiv_piv_shift_grid (GpivPivData piv_data_src, GpivPivData *piv_data_dest)
char *	gpiv_piv_dxdy_at_new_grid (GpivPivData piv_data_src, GpivPivData *piv_data_dest)
char *	gpiv_piv_gridgen (GpivPivData *piv_data, GpivImagePar image_par, GpivEvalPar piv_eval_par)
void	gpiv_piv_gridadapt (GpivImagePar *image_par, GpivEvalPar piv_eval_par_src, GpivEvalPar *piv_eval_par_dest, GpivPivData *piv_data, int sweep, gboolean *grid_last)

---

Detailed Description

module for advanced image evaluation

SOURCE: lib/piv_eval_speed.c

LAST MODIFICATION DATE:

Id

eval_speed.h,v 1.12 2007-01-29 11:53:54 gerber Exp

---

Define Documentation

#define CMPR_FACT   2

Image compression factor for speeding up the evaluation

#define GPIV_SHIFT_FACTOR   3

For initial grid, apply int_shift = int_size_2 / GPIV_SHIFT_FACTOR

---

Function Documentation

char* gpiv_piv_dxdy_at_new_grid	(	GpivPivData	piv_data_src,
		GpivPivData *	piv_data_dest
	)

calculates dx, dy of piv_data_dest from piv_data_src by bi-linear interpolation of inner points with shifted knots or extrapolation of outer lying points

dist_: distance _n: NORTH _s: SOUTH _e: EAST _w: WEST _nn: at NORTH of NORTH, etc.

Parameters:

[in]	piv_data_src	input piv data
[out]	piv_data_dest	output piv data

Returns:

NULL on success or *err_msg on failure

void gpiv_piv_gridadapt	(	GpivImagePar *	image_par,
		GpivEvalPar	piv_eval_par_src,
		GpivEvalPar *	piv_eval_par_dest,
		GpivPivData *	piv_data,
		int	sweep,
		gboolean *	grid_last
	)

Adjust grid nodes if zero_off or adaptive interrogation area has been used. This is performed by modifying int_shift equal to int_shift / GPIV_SHIFT_FACTOR , until it reaches (src) int_shift. Then, grid_last is set TRUE, which will avoid changing the interrogation shift in next calls and signal the (while loop in) the calling function.

Parameters:

[in]	image_par	image parameters
[in]	piv_eval_par_src	piv evaluation parameters
[in]	piv_data	input PIV data
[in]	sweep	interrogation sweep step
[out]	image_par	image parameters
[out]	piv_eval_par_dest	modified piv evaluation parameters
[out]	grid_last	flag if final grid refinement has been reached
[out]	piv_data	modified PIV data

Returns:

void

char* gpiv_piv_gridgen	(	GpivPivData *	piv_data,
		GpivImagePar	image_par,
		GpivEvalPar	piv_eval_par
	)

Generates grid by Calculating the positions of interrogation areas

Parameters:

[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

Returns:

NULL on success or *err_msg on failure

char* gpiv_piv_shift_grid	(	GpivPivData	piv_data_src,
		GpivPivData *	piv_data_dest
	)

shifts the knots of a 2-dimensional grid containing PIV data for improved (bi-linear) interpolation

See: T. Blu, P. Thevenaz, "Linear Interpolation Revitalized", IEEE Trans. in Image Processing, vol13, no 5, May 2004

Parameters:

[in]	piv_data_src	input piv data
[out]	piv_data_dest	output piv data

Returns:

NULL on success or *err_msg on failure

---