# NAME

get_interior_distance_to_hull - Determines the distance of an interior point to hull
# SYNOPSIS

#include "h/h_misc.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 get_interior_distance_to_hull
(
const Hull *hp,
const Vector *test_vp,
double *distance_ptr
);

# DESCRIPTION

This function computes the distance of a point to a hull boundary on the
assumption that the point is inside the hull. If the point is in fact outside
the hull, then the distance will be set to a negative value, which has no
meaning other than the point is outside the hull. If the distance of an
exterior point to the hull is needed, then use the function
get_distance_to_hull which computes both.
The first argument "hp" is the address of the convex hull
The second argument "test_vp" contains the address of a the query location.
The argument distance_ptr is a pointer to the distance to be computed.
# RETURNS

NO_ERROR on success, and ERROR on failure with an error message being set.
Note that it is not an error to query about a point that is outside the
hull. The negative distance is a valid indicator of this, and is useful
for some calling routines.
# NOTE

If the point is outside the hull, then the distance will be negative, but
the magnitude of the negative distance has no meaning. The distance from
an exterior point to the hull is NOT computed--use get_distance_to_hull()
for that.
# NOTE

The point of using this routine instead of get_distance_to_hull() is that
this one is faster and generalizes to all dimensions. Hence if the extra
flexibility of get_distance_to_hull() is not required, then use this
routined.
# NOTE

The sense (sign) of the distance is the opposite of that computed by
get_distance_to_hull().
# RELATED

Hull, get_distance_to_hull
# DISCLAIMER

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

Kobus Barnard
# DOCUMENTER

Kobus Barnard
# SEE ALSO

get_distance_to_hull
,
expand_hull
,
get_approximate_error_hull_data
,
trim_2D_hull