NAME

find_hull_bounds - Finds the bounds in each coord of a hull.

SYNOPSIS

#include "h/h_hull.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int find_hull_bounds
(
	const Hull *hp,
	Vector **min_vpp,
	Vector **max_vpp
);

DESCRIPTION

This routine finds the bounds in each coord of a hull. Thus if the hull has 2-dimensions, this routine can be used to find (min_x, min_y) and (max_x, max_y). The first argument is a pointer to the hull. The second argument is a pointer to a pointer to a vector for the min coords, and the third argument is a pointer to a pointer to a vector for the max coords. If these vector pointers are null (e.g, *min_vpp is NULL), then the vector is created. If they are the wrong size, then they are resized, and if they are the right size, then the storage is recycled. If either of these arguments are NULL (e.g. min_vpp is NULL), then that request is ignored. Thus this routine can be used to find either min's or max's without dummy arguments.

RETURNS

NO_ERROR on success and ERROR on failure.

NOTE

Hull bounds for 2 and 3 dimensional hulls are already available in the hull structure, so this routine is of use only when it is most convenient if the results are put into vectors, and/or the hull dimension is greater than 3.

create_hull, find_convex_hull, Hull, Queue_element

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER