Struct Qh 

pub struct Qh<'a> { /* private fields */ }

A Qhull instance

This struct is the main interface to the qhull library. It provides a way to compute the convex hull of a set of points and to access the results.

See the main crate documentation and the examples module/folder for some examples.

Implementations

impl<'a> Qh<'a>

pub fn builder() -> QhBuilder

Create a new builder

pub fn compute(&mut self) -> Result<(), QhError<'_>>

Compute the convex hull

Wraps qhull_sys::qh_qhull,

pub fn prepare_output(&mut self) -> Result<(), QhError<'_>>

Prepare the output of the qhull instance

Wraps qhull_sys::qh_prepare_output,

pub fn check_output(&mut self) -> Result<(), QhError<'_>>

Check the output of the qhull instance

Wraps qhull_sys::qh_check_output,

pub fn check_points(&mut self) -> Result<(), QhError<'_>>

pub fn new_delaunay<I>( points: impl IntoIterator<Item = I>, ) -> Result<Self, QhError<'static>>

where I: IntoIterator<Item = f64>,

Creates a new Delaunay triangulation

See the examples directory for an example.

pub fn all_facets(&self) -> impl Iterator<Item = Facet<'_>>

Get all the facets in the hull

Remarks

• this function will also return the sentinel face, which is the last face in the list of facets. To avoid it, use the Qh::facets function or just filter the iterator checking for Facet::is_sentinel.

pub fn all_facets_rev(&self) -> impl Iterator<Item = Facet<'_>>

Get all the facets in the hull in reverse order

See Qh::all_facets for more information.

pub fn facets(&self) -> impl Iterator<Item = Facet<'_>>

Get the facets in the hull

Remarks

• this function will not return the sentinel face, which is the last face in the list of facets. To get it, use the Qh::all_facets function.

pub fn all_vertices(&self) -> impl Iterator<Item = Vertex<'_>>

pub fn all_vertices_rev(&self) -> impl Iterator<Item = Vertex<'_>>

pub fn vertices(&self) -> impl Iterator<Item = Vertex<'_>>

pub fn num_facets(&self) -> usize

Number of facets in the hull (sentinel excluded)

Example

assert_eq!(qh.num_facets(), qh.facets().count());

pub fn num_vertices(&self) -> usize

Number of vertices in the hull (sentinel excluded)

Example

assert_eq!(qh.num_vertices(), qh.vertices().count());

pub fn simplices(&self) -> impl Iterator<Item = Facet<'_>>

pub unsafe fn raw_ptr(qh: &Qh<'_>) -> *mut qhT

Get the pointer to the raw qhT instance

Warning

Always use a try function (e.g. QhError::try_1) when calling a fallible qhull function, but not on non-fallible functions such as qhull_sys::qh_init_A since it would be invalid.

pub fn buffers(&self) -> &RefCell<IOBuffers>

Trait Implementations

impl<'a> Drop for Qh<'a>

fn drop(&mut self)

Executes the destructor for this type.