PHIGURE C REFERENCE MANUAL - SET OF POINTS WITH DOUBLE ERROR MARGINS

SET OF POINTS WITH DOUBLE ERROR MARGINS

tbierr_point_field

CALL SEQUENCE

void tbierr_point_field (strid, num_points, points, low_x,low_y, high_x,high_y, xy_type, shape_flag, skeleton_flag)

INPUT PARAMETERS

Pint	strid;
Pint	num_points;
Ppoint	*points;
Pfloat	*low_x,*low_y, *high_x,*high_y;
Tvariation_type	xy_type;
Tvisibility_flag	shape_flag;
Tvisibility_flag	skeleton_flag;

ARGUMENTS

strid: Structure identifier
num_points: Number of points
points: List of points
low_x,low_y: List of low abscissas and ordinates
high_x,high_y: List of high abscissas and ordinates
xy_type: Type of interpretation for values low_x,low_y and high_x,high_y relating to the points
shape_flag: Visibility flag for shapes
skeleton_flag: Visibility flag for skeletons

TYPES

typedef enum {
	TVARIATION_ABSOLUTE,
	TVARIATION_RELATIVE,
	TVARIATION_PERCENT_ABSOLUTE,
	TVARIATION_PERCENT_RELATIVE
} Tvariation_type;

typedef enum {
	TVISIBILITY_ON,
	TVISIBILITY_OFF,
} Tvisibility_flag;

EFFECT

This function takes a set of points with a double margin, where each point is defined in point[i] and its x high and low margins (low_x and high_x) and its y high and low margins (low_y and high_y). A rectangle (the shape) is drawn around each point point[i] : it limits the x and y margins. Two lines (the skeleton) link x margins to y margins.

The low abscissa xl of the i-th point depend on xy_type

with TVARIATION_ABSOLUTE, xl = low_x[i]

with TVARIATION_RELATIVE, xl = points[i]->x - low_x[i]

with TVARIATION_PERCENT_ABSOLUTE, xl = points[i]->x * low_x[i]

with TVARIATION_PERCENT_RELATIVE, xl = points[i]->x -(low_x[i]*points[i]->x)

Same thing for high abscissas xh, low ordinates yl and high ordinates yh. The names low and high are generic and no absolute value is applied to values low_x,low_y and high_x,high_y : low_x may be greater than high_x, and low_y may be greater than high_y.

Organization of the structure :

LABEL -1

fill area set to draw shapes

LABEL -2

polyline set to draw skeletons

Example