Up: Home page for Qhull
Up: Qhull manual: Table of Contents
Up: Programs • Options • Output • Formats • Geomview • Print • Qhull • Precision • Trace • Functions
Up: Qhull code: Table of Contents
To: Qhull functions, macros, and data structures
To: Geom • Global • Io • Mem • Merge • Poly • Qhull • Set • Stat • User

user.c -- user-definable operations

This section contains functions and constants that the user may want to change.

Copyright © 1995-2018 C.B. Barber

» Geom • Global • Io • Mem • Merge • Poly • Qhull • Set • Stat • User

Index to user.c, usermem.c, userprintf.c, userprintf_rbox.c and user.h

• qhull library constants
• user.h data types and configuration macros
• joggle constants
• performance related constants
• memory constants
• conditional compilation
• merge constants
• user.c functions
• usermem.c functions
• userprintf.c functions

»Qhull library constants

• FILENAMElen -- max length of TI or TO filename
• msgcode -- unique message codes for qh_fprintf
• qh_OPTIONline -- max length of option line ('FO')

»user.h data types and configuration macros

• realT, qh_REAL... size of floating point numbers
• countT, COUNTmax size of counts and identifiers, typically 'int' or 'long long'
• qh_CPUclock clock() function for reporting the total time spent by Qhull
• qh_RANDOM... random number generator

»definition constants

• qh_DEFAULTbox define default box size for rbox, 'Qbb', and 'QbB' (Geomview expects 0.5)
• qh_INFINITE on output, indicates Voronoi center at infinity
• qh_ORIENTclock define convention for orienting facets
• qh_ZEROdelaunay define facets that are ignored in Delaunay triangulations

»joggle constants

• qh_JOGGLEagain how often to retry before using qh_JOGGLEmaxincrease again
• qh_JOGGLEdefault default value for qh.JOGGLEmax for 'QP'
• qh_JOGGLEincrease factor to increase qh.JOGGLEmax on retrys for 'QPn'
• qh_JOGGLEmaxincrease max for increasing qh.JOGGLEmax relative to qh.MAXwidth
• qh_JOGGLEmaxretry report error if this many retries
• qh_JOGGLEretry how often to retry before using qh_JOGGLEmax

»performance related constants

• qh_HASHfactor total/used hash slots
• qh_INITIALmax if dim >= qh_INITIALmax, use min/max coordinate points for initial simplex
• qh_INITIALsearch if qh.INITIALmax, search points up to this dimension
• qh_NOtrace disallow tracing
• qh_VERIFYdirect 'Tv' verifies all points X facets if op count is smaller

»memory constants

• qh_MEMalign memory alignment for qh_meminitbuffers() in global.c
• qh_MEMbufsize size of additional memory buffers
• qh_MEMinitbuf size of initial memory buffer

»conditional compilation

• compiler defined symbols, e.g., _STDC_ and _cplusplus
• qh_COMPUTEfurthest compute furthest distance to an outside point instead of storing it with the facet
• qh_KEEPstatistics enable statistic gathering and reporting with option 'Ts'
• qh_MAXoutside record outer plane for each facet
• qh_NOmerge disable facet merging
• qh_NOtrace disable tracing with option 'T4'
• qh_QHpointer access global data with pointer or static structure
• qh_QUICKhelp use abbreviated help messages, e.g., for degenerate inputs

»merge constants

• qh_BESTcentrum when does qh_findbestneighbor() test centrums?
• qh_BESTnonconvex when does qh_findbestneighbor() test nonconvex ridges only?
• qh_COPLANARratio what is qh.MINvisible?
• qh_DIMreduceBuild max dimension for vertex reduction
• qh_DIMmergeVertex max dimension for vertex merging
• qh_DISToutside when is a point clearly outside of a facet for qh_findbestnew and qh_partitionall
• qh_MAXnarrow max. cosine for qh.NARROWhull
• qh_MAXnewcentrum when does qh_reducevertices_centrum() reset the centrum?
• qh_MAXnewmerges when does qh_merge_nonconvex() call qh_reducevertices_centrums?
• qh_RATIOnearinside ratio for retaining inside points for qh_check_maxout()
• qh_SEARCHdist when is facet coplanar with the best facet for qh_findbesthorizon
• qh_USEfindbestnew when to use qh_findbestnew for qh_partitionpoint()
• qh_WARNnarrow max. cosine to warn about qh.NARROWhull
• qh_WIDEcoplanar what is a wide facet?
• qh_WIDEduplicate what is a wide ratio on merging duplicate ridges?

»user.c functions

• Qhull template for calling qh_new_qhull from your program
• qh_errexit report error and exit qhull()
• qh_errprint print information about facets and ridges
• qh_new_qhull call qhull on an array of points
• qh_printfacetlist print all fields of all facets

»usermem.c functions

• qh_exit exit program, same as exit(). May be redefined as throw "QH10003.." by libqhullcpp/usermem_r-cpp.cpp
• qh_fprintf_stderr print to stderr when qh.ferr is not defined.
• qh_free free memory, same as free().
• qh_malloc allocate memory, same as malloc()

»userprintf.c and userprintf_rbox,c functions

• qh_fprintf print information from Qhull, sames as fprintf().
• qh_fprintf_rbox print information from Rbox, sames as fprintf().

Up: Home page for Qhull
Up: Qhull manual: Table of Contents
Up: Programs • Options • Output • Formats • Geomview • Print • Qhull • Precision • Trace • Functions
Up: Qhull code: Table of Contents
To: Qhull functions, macros, and data structures
To: Geom • Global • Io • Mem • Merge • Poly • Qhull • Set • Stat • User

The Geometry Center Home Page

Comments to: qhull@qhull.org
Created: May 2, 1997 --- Last modified: see top