NAME

approximate_hull_average - Finds the hull average.

SYNOPSIS

#include "h/h_ave.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 approximate_hull_average
(
	const Hull *hp,
	Vector **average_vpp,
	double *vol_ptr
);

DESCRIPTION

This routine finds and approximation of the average (center of mass) of the input hull. The first argument "hp" is the address of the convex hull to compute the average of. Only 2-D or 3-D hulls are currently supported. The second argument "average_vpp" contains the address of a vector describing the computed hull average. Currently hulls averages are computed using a discrete approximation. The resolution of the descrete space is user settable with the "hull-average-resolution" option, provided that the KJB library options are made available to the user (recommended!).

RETURNS

NO_ERROR on success: ERROR on failure.

NOTE

This routine is essentially OBSOLETE. It is kept for testing purposes, and as a template for routines to estimate more complex quantities. For most purposes, use get_hull_CM_and_volume().

Hull, get_hull_CM_and_volume

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER

Lindsay Martin and Kobus Barnard