Woolz Image Processing  Version 1.7.0
WlzFeatures

Files

file  WlzArea.c
 Computes the area of an object.
 
file  WlzBoundingBox.c
 Functions for computing the axis aligned bounding box of objects.
 
file  WlzCCor.c
 Computes the cross correlation of two objects.
 
file  WlzCentrality.c
 Functions for computing the centrality of a feature domain with respect to a boundary domain. See WlzCentrality().
 
file  WlzCentreOfMass.c
 Computes the centre of mass of objects.
 
file  WlzDistMetric.c
 Functions to compute the Hausdorff distance, mean nearest neighbour and the median nearest neighbour distances between two datasets.
 
file  WlzGreyStats.c
 Calculates simple statistics about an object's grey values.
 
file  WlzGreyValueMixing_s.c
 Functions to mix the grey values of two woolz object and produce a new object using

\[ o = (1 - x) o_1 + x o_2 \]

.

 
file  WlzInteriority.c
 Functions to compute an interiority scores.
 
file  WlzLineArea.c
 Computes the line area of an object.
 
file  WlzNMSuppress.c
 A non-maximal supression filter, which constructs a new domain object using a Canny-like non-maximal suppression algorithm. The domain is the non-maximally suppressed domain and the values are the encoded gradient direction.
 
file  WlzNObjGreyStats.c
 Calculates statistics for grey values across the objects of the given compound object.
 
file  WlzOccupancy.c
 Functions for computing the occupancy of domains.
 
file  WlzOffsetDist.c
 Functions to compute offset distance objects.
 
file  WlzPoints.c
 Functions for handling point domains.
 
file  WlzRGBAGreyStats.c
 Calculates simple quick statistics for a domain object with RGBA values.
 
file  WlzSampleValuesAndCoords.c
 Extracts values and coordinates from a Woolz object with grey values using a sampoling function.
 
file  WlzScalarFeatures.c
 Functions for extracting scalar features from objects.
 
file  WlzTensor.c
 Functions which derive and manipulate tensor quantities.
 
file  WlzThinToPoints.c
 Functions for extracting point locations by thinnning.
 
file  WlzVerticies.c
 Functions for extracting vertices from objects represented by vertices, eg polylines, boundlists and contours.
 

Data Structures

struct  _WlzPoints
 An array of either 2D or 3D points which may have either integral of floating point values. Possible types are: WLZ_POINTS_2I, WLZ_POINTS_2D, WLZ_POINTS_3I and WLZ_POINTS_3D. Typedef: WlzPoints. More...
 
struct  _WlzRect
 An integer rectangle domain. Side from (l[0],k[0]) to (l[1],k[1]) is a long side. The vertices are cyclic. Typedef: WlzIRect. More...
 
struct  _WlzFRect
 A single precision floating point rectangle domain. Side from (l[0],k[0]) to (l[1],k[1]) is a long side. The vertices are cyclic. Typedef: WlzFRect. More...
 

Macros

#define WLZ_DGTENSOR_FEATURE_MASK(F)   (((F)>0)?(1<<((F)-1)):(0))
 Bit mask generator for features of Jacobian deformation gradient tensors. More...
 

Enumerations

enum  _WlzScalarFeatureType {
  WLZ_SCALARFEATURE_VALUE,
  WLZ_SCALARFEATURE_GRADIENT
}
 Scalar features of objects. More...
 
enum  _WlzDGTensorFeatureType {
  WLZ_DGTENSOR_FEATURE_NONE = 0,
  WLZ_DGTENSOR_FEATURE_DETJAC = 1,
  WLZ_DGTENSOR_FEATURE_EIGENVEC = 2,
  WLZ_DGTENSOR_FEATURE_EIGENVAL = 3,
  WLZ_DGTENSOR_FEATURE_LIMIT = 4
}
 Features of Jacobian deformation gradient tensors. More...
 

Functions

WlzLong WlzArea (WlzObject *obj, WlzErrorNum *dstErr)
 Computes the area of an object. More...
 
WlzIBox2 WlzBoundingBox2I (WlzObject *inObj, WlzErrorNum *dstErr)
 Computes the 2D integer axis aligned bounding box of the given object. More...
 
WlzDBox2 WlzBoundingBox2D (WlzObject *inObj, WlzErrorNum *dstErr)
 Computes the 2D double precision axis aligned bounding box of the given object. More...
 
WlzIBox3 WlzBoundingBox3I (WlzObject *inObj, WlzErrorNum *dstErr)
 Computes the integer 3D axis aligned bounding box of the given object. More...
 
WlzDBox3 WlzBoundingBox3D (WlzObject *inObj, WlzErrorNum *dstErr)
 Computes the double precision 3D axis aligned bounding box of the given object. More...
 
WlzDBox3 WlzBoundingBoxGModel3D (WlzGMModel *model, WlzErrorNum *dstErr)
 Computes the 3D axis aligned bounding box of the 3D geometric model. It is an error if the model is not a 3D model. More...
 
WlzDBox2 WlzBoundingBoxGModel2D (WlzGMModel *model, WlzErrorNum *dstErr)
 Computes the 2D axis aligned bounding box of the 2D geometric model. It is an error if the model is not a 2D model. More...
 
WlzIBox2 WlzBoundingBox2DTo2I (WlzDBox2 bBox2D)
 Converts a 2D double precision bounding box to an integer bounding box. There is no checking done for underflows or overflows. More...
 
WlzDBox2 WlzBoundingBox2ITo2D (WlzIBox2 bBox2I)
 Converts a 2D integer bounding box to an double precision bounding box. More...
 
WlzIBox3 WlzBoundingBox3DTo3I (WlzDBox3 bBox3D)
 Converts a 3D double precision bounding box to an integer bounding box. There is no checking done for underflows or overflows. More...
 
WlzDBox3 WlzBoundingBox3ITo3D (WlzIBox3 bBox3I)
 Converts a 3D integer bounding box to an double precision bounding box. More...
 
WlzFBox3 WlzBoundingBox3DTo3F (WlzDBox3 bBox3D)
 Converts a 3D double bounding box to a single precision bounding box. More...
 
WlzDBox3 WlzBoundingBox3FTo3D (WlzFBox3 bBox3F)
 Converts a 3D single bounding box to a double precision bounding box. More...
 
WlzIBox2 WlzBoundingBoxUnion2I (WlzIBox2 box0, WlzIBox2 box1)
 Computes the 2D integer bounding box which encloses the given pair of bounding boxes. More...
 
WlzFBox2 WlzBoundingBoxUnion2F (WlzFBox2 box0, WlzFBox2 box1)
 Computes the 2D single precision bounding box which encloses the given pair of bounding boxes. More...
 
WlzDBox2 WlzBoundingBoxUnion2D (WlzDBox2 box0, WlzDBox2 box1)
 Computes the 2D double precision bounding box which encloses the given pair of bounding boxes. More...
 
WlzIBox3 WlzBoundingBoxUnion3I (WlzIBox3 box0, WlzIBox3 box1)
 Computes the 3D integer bounding box which encloses the given pair of bounding boxes. More...
 
WlzFBox3 WlzBoundingBoxUnion3F (WlzFBox3 box0, WlzFBox3 box1)
 Computes the 3D single precision bounding box which encloses the given pair of bounding boxes. More...
 
WlzDBox3 WlzBoundingBoxUnion3D (WlzDBox3 box0, WlzDBox3 box1)
 Computes the 3D double precision bounding box which encloses the given pair of bounding boxes. More...
 
double WlzCCorS2D (WlzObject *obj0, WlzObject *obj1, int unionFlg, int normFlg, WlzErrorNum *dstErr)
 Computes the cross correlation of the two given 2D spatial domain objects in the spatial domain. The algorithm used by this function is not an efficient unless a single cross correlation value is required. More...
 
double WlzCentrality (WlzObject *fObj, WlzObject *bObj, int nRay, int binFlg, double *dstMaxR, WlzErrorNum *dstErr)
 Computes the centrality of a feature domain with respect to a boundary domain. The boundary domain must enclose the feature domain. More...
 
WlzDVertex2 WlzCentreOfMass2D (WlzObject *srcObj, int binObjFlag, double *dstMass, WlzErrorNum *dstErr)
 Calculates the centre of mass of a Woolz object. If the given object does not have grey values or the binary object flag is set (ie non zero) then every pixel or vertex within the object's domain has the same mass. More...
 
WlzDVertex3 WlzCentreOfMass3D (WlzObject *srcObj, int binObjFlag, double *dstMass, WlzErrorNum *dstErr)
 Calculates the centre of mass of a Woolz object. If the given object does not have grey values or the binary object flag is set (ie non zero) then every pixel or vertex within the objects domain has the same mass. More...
 
WlzDVertex2 WlzCentreOfMassVtx2D (int nVtx, WlzDVertex2 *vtx)
 Computes the centre of mass of a vector of 2D vertices. More...
 
WlzDVertex3 WlzCentreOfMassVtx3D (int nVtx, WlzDVertex3 *vtx)
 Computes the centre of mass of a vector of 3D vertices. More...
 
WlzErrorNum WlzDistMetricGM (WlzGMModel *model0, WlzGMModel *model1, double *dstDistH, double *dstDistM, double *dstDistN, double *dstDistI)
 Computes any combination of the Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the vertices of the given geometric models. See WlzDistMetricVertex2D() for details of the metrics. More...
 
WlzErrorNum WlzDistMetricDirGM (WlzGMModel *model0, WlzGMModel *model1, double *dstDistH, double *dstDistM, double *dstDistN, double *dstDistI)
 Computes any combination of the directed Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the vertices of the given geometric models. See WlzDistMetricDirVertex2D() for details of the metrics. More...
 
WlzErrorNum WlzDistMetricVertex2D (int n0, WlzDVertex2 *vx0, int n1, WlzDVertex2 *vx1, double *dstDistH, double *dstDistM, double *dstDistN, double *dstDistI)
 Computes any combination of the Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the given sets of vertices. Each of these distance measures is the maximum of the two possible directed measures:

\[ D = \max{(d(A,B), d(B,A))} \]

Where \(D\) is a non-directed distance metric and \(d\) is the associated directed distance metric. \(A\) and \(B\) are the two datasets. More...

 
WlzErrorNum WlzDistMetricVertex3D (int n0, WlzDVertex3 *vx0, int n1, WlzDVertex3 *vx1, double *dstDistH, double *dstDistM, double *dstDistN, double *dstDistI)
 Computes any combination of the Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the given sets of vertices. See WlzDistMetricVertex2D() for an explaination of the distance metrics. More...
 
WlzErrorNum WlzDistMetricDirVertex2D (int n0, WlzDVertex2 *vx0, int n1, WlzDVertex2 *vx1, double *dstDistH, double *dstDistM, double *dstDistN, double *dstDistI)
 Computes any combination of the directed Hausdorff, mean nearest neighbour, median nearest neighbour and minimum mean neighbour distances between the given sets of vertices. The directed Hausdorff distance metric is:

\[ \max_{a \in A}{\min_{b \in B}{\|a - b\|}} \]

The directed mean nearest neighbour distance metric is:

\[ \frac{1}{n_a} \sum_{a \in A}{\min_{b \in B}{\|a - b\|}} \]

Likewise the directed median nearest neighbour distance metric is:

\[ \mathrm{median}_{a \in A}{\min_{b \in B}{\|a - b\|}} \]

Where \(A\) and \(B\) are the two datasets. More...

 
WlzErrorNum WlzDistMetricDirVertex3D (int n0, WlzDVertex3 *vx0, int n1, WlzDVertex3 *vx1, double *dstDistH, double *dstDistM, double *dstDistN, double *dstDistI)
 Computes any combination of the directed Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the given sets of vertices. See WlzDistMetricDirVertex2D() for an explaination of the distance metrics. More...
 
WlzDVertex3WlzGeometryTrackUpAndDown_s (int numberOfPixelsZ, int startTrackingFile, int numberOfFilesDownOrUp, double disForInAndOutGuid, double disForInAndOut, unsigned char **TwoDImageFilesNameList, int numOf2DWlzFiles, int downOrUp, int sectionLength_N, int subSubSectionLength_L, int numberOfSampleP_k, char *surfacePointFileName, char *surfaceInPointFileName, char *surfaceOutPointFileName, int startShell, int endShell, int startSection, int endSection, double minDis, WlzErrorNum *dstErr)
 Track a curved path through a set of geometric model shells. More...
 
size_t WlzGreySize (WlzGreyType gType)
 Given a grey type, computes the number of bytes required to to store a single grey value of that type. Note the grey type WLZ_GREY_BIT is able to store multiple values in a single byte but one byte is required to store a single bit. More...
 
int WlzGreyStats (WlzObject *srcObj, WlzGreyType *dstGType, double *dstMin, double *dstMax, double *dstSum, double *dstSumSq, double *dstMean, double *dstStdDev, WlzErrorNum *dstErr)
 Calculates simple quick statistics for given 2D or 3D domain object with grey values. Pointers provided for results may be NULL without causing an error. More...
 
WlzObjectWlzGreyValueMixing_s (WlzObject *sObj, WlzObject *tObj, double xmiddle, WlzErrorNum *dstErr)
 calculate the distance map of a woolz obj More...
 
double * WlzInteriorityN (WlzObject *refObj, int nTstObj, WlzObject **tstObjs, WlzErrorNum *dstErr)
 Computes an interiority score for each test object with respect to the reference object. See WlzInteriority(). This function computes the distance transform for the reference domain once and then uses this for each of the test domains. If not NULL the returned array of scores should be freed using AlcFree(). More...
 
double WlzInteriority (WlzObject *refObj, WlzObject *tstObj, WlzErrorNum *dstErr)
 Computes an interiority score for the test object with respect to the reference object. The interiority score is the mean distance of those elements of the intersection of the reference and test object from the boundary of the reference object, ie:

\[ s = t \cap r b = t \neg t^- i = \frac{1}{|s|} \sum_{s}{D(b, s)} \]

where \(t\) is a test object, \(t^-\) is the eroded test object, \(|x|\) is the cardinality of \(x\) and \(D\) is the distance operator. More...

 
int WlzLineArea (WlzObject *obj, WlzErrorNum *dstErr)
 Calculate the line-area of an object defined as the sum of the line segments bounded by the left hand end of the first interval in a line and the right hand end of the last interval in that line. More...
 
WlzObjectWlzMakeMarkers (WlzVertexType vType, int nVtx, WlzVertexP vtx, WlzMarkerType mType, int mSz, WlzErrorNum *dstErr)
 Constructs a domain from the union of marker domains with a marker domain at each of the given vertex positions. More...
 
WlzObjectWlzMarkerLattice (WlzObject *gObj, WlzMarkerType mType, int mSz, int mSep, WlzErrorNum *dstErr)
 Creates a new domain object that is a formed from a lattice of markers covering the given domain. More...
 
WlzPointsWlzMakePoints (WlzObjectType type, int nVtx, WlzVertexP vtxP, int maxVtx, WlzErrorNum *dstErr)
 Creates a new point domain. A point domain consists of an array of vertices which are treated as seperate points. More...
 
WlzErrorNum WlzNObjGreyStats (WlzObject *gObj, int mean, int stddev, int *dstN, WlzObject **dstMinObj, WlzObject **dstMaxObj, WlzObject **dstSumObj, WlzObject **dstSSqObj)
 Computes a collection of objects from the object (which should be a compound array object). The computed objects all have the intersection of the given object domains as their domain and WLZ_GREY_DOUBLE values for the minimum, maximum, sum and sum of squares of the given grey values at each pixel/voxel within the intersection domain. Returned objects will have name properties set to: min, max, sum, ssq, mean and stddev as appropriate. More...
 
WlzErrorNum Wlz3DSectionOcc (WlzObject *obj, WlzThreeDViewStruct *vs, double sep, double *dstFirst, double *dstLast, int *dstArraySizeOcc, int **dstArrayOcc)
 Computes an array of integers which correspond to a line through the given object's domain perpendicular to the plane defined by the given view structure. At each point along the line the occupancy area or number of domains intersecting the plane is computed. When the given object is a 3D spatial domain object then areas are computed and when it is a compound array then the occupancy (number of domains) is computed. More...
 
WlzObjectWlzDomainOccupancy (WlzObject *gObj, WlzErrorNum *dstErr)
 Computes a new Woolz domain object which has the domain of the given object (union of domains if the object is a compound array) and a value table with integer values representing the number of domains present. More...
 
WlzObjectWlzOffsetDist (WlzObject *obj0, WlzObject *obj1, int maxDist, WlzErrorNum *dstErr)
 Computes an object with domain and values that are the set of minimum distances between the two given objects. An equidistant boundary is computed between the domains of the two given objects, within maxDist of each object's domain and within the convex hull of the union of the two given object's domains. This function will probably only be useful where one of the objects tends to track the other. More...
 
WlzObjectWlzPointsToDomObj (WlzPoints *pnt, double scale, WlzErrorNum *dstErr)
 Creates a domain object which coresponds to the union of the given points. More...
 
WlzPointsWlzPointsFromDomObj (WlzObject *gvnObj, double dMin, int useFloatingPoint, int voxelScaling, int useGrey, double gMin, double gMax, double gGam, WlzErrorNum *dstErr)
 Finds points which are within the given opjects domain and are seperated by at least the given minimum distance. If the given object's grey values are used, then the probability of a point being placed is proportional to:

\[ \left\{ \begin{array}{ll} 0.0 & g_i < g_{min} \\ frac{(g_i - g_{min})^\gamma}{g_{max} - g_{min}} & g_i > g_{min} \end{array} \right. \]

. More...

 
WlzPointValuesWlzPointValuesFromDomObj (WlzPoints *pdm, WlzObject *domObj, WlzErrorNum *dstErr)
 Creates a new point values using the given points domain and domain object with values. Values are sampled from the domain object using the locations of the points in the points domain. More...
 
WlzObjectWlzPointsToMarkers (WlzPoints *pts, WlzMarkerType mType, int mSz, WlzErrorNum *dstErr)
 Constructs a domain from the union of marker domains with a marker domain at each of the given point positions. More...
 
WlzPointsWlzPointsDither (WlzPoints *gPts, WlzDVertex3 dSz, WlzObject *resObj, WlzErrorNum *dstErr)
 Dithers the vertices of the given points by adding a random displacement within the range -d to +d, where d is the given dither size. More...
 
int WlzRGBAGreyStats (WlzObject *srcObj, WlzRGBAColorSpace colSpc, WlzGreyType *dstGType, double *dstMin, double *dstMax, double *dstSum, double *dstSumSq, double *dstMean, double *dstStdDev, WlzErrorNum *dstErr)
 Calculates simple quick statistics for the domain object with RGBA values. Each component has its statictics computed and entered into the four double[4] arrays. More...
 
WlzErrorNum WlzSampleValuesAndCoords (WlzObject *obj, WlzGreyType *dstGType, int *dstNVal, WlzGreyP *dstValP, WlzVertexP *dstCoords, WlzSampleFn samFn, int samFac)
 Allocates buffers for both the grey values and the coordinates of the grey values in the given object. On return these buffers contain the sampled object values and the coordinates of the values. More...
 
WlzErrorNum WlzScalarFeatures2D (WlzObject *obj, int *dstNFeat, WlzIVertex2 **dstFeat, WlzScalarFeatureType fType, WlzThresholdType thrHL, WlzPixelV thrV, double filterV, double minDist)
 Finds scalar features within the given object. Where the feature values are all either above or below the given threshold value, depending on the value of thrHL, and the features have the given minimum seperation distance. More...
 
WlzObjectWlzDGTensorFeatures (WlzObject *mObj, unsigned int features, int points, double dMin, WlzDVertex3 dither, WlzDVertex3 smooth, int voxScaling, WlzErrorNum *dstErr)
 Computes features of a deformation gradient tensor field and creates a compound object, each element of which is a required feature of the given deformation gradient field object. The feature object may be either a points object or a spatial domain object as required. See WlzDGTensorSDFeature() which this function calls to compute the feature objects. More...
 
WlzObjectWlzDGTensorSDFeature (WlzObject *mObj, WlzDomain fDom, WlzDGTensorFeatureType feat, WlzDVertex3 smooth, WlzErrorNum *dstErr)
 Computes a feature of a deformation gradient tensor field throughout the given 3D spatial domain. This function assumes all input parameters to be valid, when this is not certain use WlzDGTensorFeatures(). The returned object will have it's name property set to an appropriate name for the required feature: WLZ_DGTENSOR_FEATURE_DETJAC ("jacobian"), WLZ_DGTENSOR_FEATURE_EIGENVEC ("eigen vectors") or WLZ_DGTENSOR_FEATURE_EIGENVAL ("eigen values"). More...
 
WlzObjectWlzDGTensorPDFeature (WlzObject *mObj, WlzDomain fDom, WlzDGTensorFeatureType feat, WlzErrorNum *dstErr)
 Computes a feature of a deformation gradient tensor field throughout the given 3D points domain. This function assumes all input parameters to be valid, when this is not certain use WlzDGTensorFeatures(). More...
 
WlzErrorNum WlzTensorSmooth (WlzObject *obj, WlzDVertex3 smooth)
 Smooths the (possibly) non-scalar features of the given object in place by applying a Gaussian filter with the given sigma values (sigma value <~ 0.0 implies no filtering in the corresponding direction. More...
 
WlzObjectWlzTensorGetComponent (WlzObject *tObj, int cpt, WlzErrorNum *dstErr)
 Extracts a single value component from a (possibly) non-scalar object and creates an object with a non-tiled value table which is returned. This function may also be used to convert a tiled value object to a non-tiled value object. More...
 
WlzErrorNum WlzTensorSetComponent (WlzObject *tObj, WlzObject *fObj, int cpt)
 Sets a single value component in a (possibly) non-scalar object using scalar values of the second given object. More...
 
WlzObjectWlzCMeshDGTensor (WlzObject *cObj, int invert, WlzErrorNum *dstErr)
 Given a conforming mesh transform this function computes the displacement gradient tensor for each of it's valid elements. Given displacement \(\vec{u}(\vec{r})\) with position vector \(\vec{r}\) which maps a point from a space \(\vec{x}\) to a space \(\vec{u}\) the displacement gradient tensor is defined in 3D as

\[ { \newcommand{\pd}[2]{\frac{\partial #1}{\partial #2}} u_{i,j} = \left [ \begin{array}{ccc} \pd{u_0}{x_0} & \pd{u_0}{x_1} & \pd{u_0}{x_2} \\ \pd{u_1}{x_0} & \pd{u_1}{x_1} & \pd{u_1}{x_2} \\ \pd{u_2}{x_0} & \pd{u_2}{x_1} & \pd{u_2}{x_2} \end{array} \right] } \]

with

\[ \Delta r_i = u_{ij} r_j \]

where \(\vec{u} = \left[u_0, u_1, u_2\right]^T\) and \(\Delta \vec{r} = \left[x_0, x_1, x_2\right]^T\). The displacement gradient tensor matrix is just the rotation and independent scaling part of the affine transform that displaces the element. More...

 
WlzObjectWlzCMeshDGTensorAtPts (WlzObject *cObj, int invert, WlzDVertex3 sd, int dither, WlzErrorNum *dstErr)
 Given a conforming mesh transform this function computes the displacement gradient tensor at regular cartesian grid sample points throughout the mesh. The tensor values at the sample points are computed at each point by computing an iverse distance weighted least squares general affine transform for the ring of nodes surrounding the closest node. See WlzCMeshDGTensor() for the description of the tensor. More...
 
WlzObjectWlzCMeshStrainTensor (WlzObject *cObj, int invert, WlzErrorNum *dstErr)
 Given a conforming mesh transform this function computes the strain tensor for each of it's valid elements. This function uses WlzCMeshDGTensor() to compute the displacement gradient tensor and the derives the strain tensor \(e_{ij}\) from this using:

\[ e_{ij} = \frac{1}{2} (u_{ij} + u_{ji}) \]

. More...

 
WlzObjectWlzCMeshStrainTensorAtPts (WlzObject *cObj, int invert, WlzDVertex3 sd, int dither, WlzErrorNum *dstErr)
 Given a conforming mesh transform this function computes the displacement gradient tensor at regular cartesian grid sample points throughout the mesh. The tensor values at the sample points are computed using WlzCMeshDGTensorAtPts(). The strain tensor is then computed from the displacement gradient tensor as for WlzCMeshStrainTensor(). More...
 
WlzObjectWlzThinToPoints (WlzObject *gObj, int gThin, int gStart, int gInc, WlzErrorNum *dstErr)
 Extracts a points object in which the points are the centres of thinned regions of the input domain object. If the object has grey values and gThin is set then the object is erroded by successive thresholding while collecting all disconnected regions or if the object has no values the object is simply labeled to give a collection of disconnected regions. The disconnected regions are then eroded (morphologicaly) again collecting disconnected regions. More...
 
WlzVertexP WlzVerticesFromObj (WlzObject *obj, WlzVertexP *dstNr, int *dstCnt, WlzVertexType *dstType, WlzErrorNum *dstErr)
 Allocates a buffer which it fills with the vertices from the given object. If the object is not one of the types that is represented by vertices, eg polylines, boundlists, contours ..., then this may result in a very large number of vertices, with for example one per voxel. Normals will only be allocated and set for objects represented by vertices, eg there will be no normals for voxel based objects. More...
 
WlzVertexP WlzVerticesFromObjBnd (WlzObject *obj, int *dstCnt, WlzVertexType *dstType, WlzErrorNum *dstErr)
 Extracts all vertices that lie on the boundary of the given objects domain. More...
 
WlzErrorNum WlzVerticesFromObjBnd2I (WlzObject *obj, int *dstNVtx, WlzIVertex2 **dstVtx)
 Extracts all vertices that lie on the boundary of the given 2D domain object's domain. More...
 
WlzErrorNum WlzVerticesFromObjBnd3I (WlzObject *obj, int *dstNVtx, WlzIVertex3 **dstVtx)
 Extracts all vertices that lie on the boundary of the given 3D domain object's domain. More...
 
WlzErrorNum WlzVerticesFromObj2I (WlzObject *obj, int *dstNVtx, WlzIVertex2 **dstVtx)
 Extracts all vertices that lie within the given 2D domain object's domain. More...
 
WlzErrorNum WlzVerticesFromObj3I (WlzObject *obj, int *dstNVtx, WlzIVertex3 **dstVtx)
 Extracts all vertices that lie within the given 3D domain object's domain. More...
 
WlzVertexP WlzVerticesFromGM (WlzGMModel *model, WlzVertexP *dstNr, int **dstVId, int *dstCnt, WlzVertexType *dstType, WlzErrorNum *dstErr)
 Allocates a buffer which it fills with the vertices from a geometric model. More...
 
WlzVertexP WlzDVerticesFromGM (WlzGMModel *model, int *dstCnt, WlzVertexType *dstType, WlzErrorNum *dstErr)
 Allocates a buffer which it fills with either 2D or 3D double precission vertices from the geometric model. The indicies of the vertices in the buffer are the same as the indices of the vertices in the model. More...
 
WlzVertexP WlzDVerticesFromCMesh (WlzCMeshP mesh, int *dstCnt, WlzVertexType *dstType, int skip, WlzErrorNum *dstErr)
 Allocates a buffer which it fills with either 2D or 3D double precission vertices from the conforming mesh. The indicies of the vertices in the buffer are the same as the indices of the vertices in the model unless the skip non-valid nodes flag is set.. More...
 
int WlzVertexQSortFnI2 (void *p0, void *p1)
 Function for qsort() to sort WlzIVertex2 vertices so that they have increasing Y then X. More...
 
int WlzVertexQSortFnI3 (void *p0, void *p1)
 Function for qsort() to sort WlzIVertex3 vertices so that they have increasing z then Y then X. More...
 
int WlzVertexHeapSortIdxFnI2 (void *data, int *idx, int id0, int id1)
 Function for AlgHeapSortIdx() to sort WlzIVertex2 vertices so that they have increasing Y then X. More...
 
int WlzVertexHeapSortIdxFnI3 (void *data, int *idx, int id0, int id1)
 Function for AlgHeapSortIdx() to sort WlzIVertex3 vertices so that they have increasing Z then Y then X. More...
 
int WlzVertexHeapSortIdxFnD2 (void *data, int *idx, int id0, int id1)
 Function for AlgHeapSortIdx() to sort WlzDVertex2 vertices so that they have increasing Z then Y then X. More...
 
int WlzVertexHeapSortIdxFnD3 (void *data, int *idx, int id0, int id1)
 Function for AlgHeapSortIdx() to sort WlzDVertex3 vertices so that they have increasing Z then Y then X. More...
 
AlcKDTTreeWlzVerticesBuildTree (WlzVertexType vType, int nV, WlzVertexP vtx, int *shfBuf, WlzErrorNum *dstErr)
 Allocates and populates a k-D tree from the given vertices. The vertices are either WlzDVertex2 orWlzDVertex3. More...
 

Detailed Description

Macro Definition Documentation

#define WLZ_DGTENSOR_FEATURE_MASK (   F)    (((F)>0)?(1<<((F)-1)):(0))

Bit mask generator for features of Jacobian deformation gradient tensors.

Referenced by WlzDGTensorFeatures().

Enumeration Type Documentation

Scalar features of objects.

Enumerator
WLZ_SCALARFEATURE_VALUE 

Grey value.

WLZ_SCALARFEATURE_GRADIENT 

Gradient of grey values.

Features of Jacobian deformation gradient tensors.

Enumerator
WLZ_DGTENSOR_FEATURE_NONE 

No feature, null case.

WLZ_DGTENSOR_FEATURE_DETJAC 

Determinant of Jacobian tensor.

WLZ_DGTENSOR_FEATURE_EIGENVEC 

Eigen vectors.

WLZ_DGTENSOR_FEATURE_EIGENVAL 

Eigen values.

WLZ_DGTENSOR_FEATURE_LIMIT 

Not a feature but used to itterate through the features, keep it the largest value.

Function Documentation

WlzLong WlzArea ( WlzObject obj,
WlzErrorNum dstErr 
)
WlzIBox2 WlzBoundingBox2I ( WlzObject inObj,
WlzErrorNum dstErr 
)

Computes the 2D integer axis aligned bounding box of the given object.

Returns
2D integer bounding box.
Parameters
inObjThe given object.
dstErrDestination error pointer, may be NULL.

References WLZ_ERR_NONE, WlzBoundingBox3I(), _WlzIBox2::xMax, _WlzIBox3::xMax, _WlzIBox2::xMin, _WlzIBox3::xMin, _WlzIBox2::yMax, _WlzIBox3::yMax, _WlzIBox2::yMin, and _WlzIBox3::yMin.

Referenced by WlzAffineTransformIsTranslate(), WlzAutoCor(), WlzContourFromPoints(), WlzContourGrdObj2D(), WlzFourierTransformObj(), WlzImageBlendObjToBufRGBA(), WlzMeshFromObjBox(), WlzRegCCorObjs(), WlzSepFilter(), WlzSplitMontageObj(), WlzSplitObj(), and WlzToArray1D().

WlzDBox2 WlzBoundingBox2D ( WlzObject inObj,
WlzErrorNum dstErr 
)

Computes the 2D double precision axis aligned bounding box of the given object.

Returns
2D double precision bounding box.
Parameters
inObjThe given object.
dstErrDestination error pointer, may be NULL.

References WLZ_ERR_NONE, WlzBoundingBox3D(), _WlzDBox2::xMax, _WlzDBox3::xMax, _WlzDBox2::xMin, _WlzDBox3::xMin, _WlzDBox2::yMax, _WlzDBox3::yMax, _WlzDBox2::yMin, and _WlzDBox3::yMin.

WlzIBox3 WlzBoundingBox3I ( WlzObject inObj,
WlzErrorNum dstErr 
)

Computes the integer 3D axis aligned bounding box of the given object.

Returns
3D integer bounding box.
Parameters
inObjThe given object.
dstErrDestination error pointer, may be NULL.

References _WlzDomain::b, _WlzValues::core, _WlzDomain::core, _WlzDomain::ctr, _WlzObject::domain, _WlzDomain::i, _WlzIntervalDomain::kol1, _WlzPlaneDomain::kol1, _WlzIntervalDomain::lastkl, _WlzPlaneDomain::lastkl, _WlzIntervalDomain::lastln, _WlzPlaneDomain::lastln, _WlzPlaneDomain::lastpl, _WlzIntervalDomain::line1, _WlzPlaneDomain::line1, _WlzValues::obj, _WlzDomain::p, _WlzPlaneDomain::plane1, _WlzDomain::poly, _WlzDomain::t, _WlzObject::type, _WlzCoreDomain::type, _WlzObject::values, WLZ_2D_DOMAINOBJ, WLZ_2D_POLYGON, WLZ_3D_DOMAINOBJ, WLZ_3D_POLYGON, WLZ_3D_WARP_TRANS, WLZ_AFFINE_TRANS, WLZ_BOUNDLIST, WLZ_COMPOUND_ARR_1, WLZ_COMPOUND_ARR_2, WLZ_COMPOUND_LIST_1, WLZ_COMPOUND_LIST_2, WLZ_CONTOUR, WLZ_CONV_HULL, WLZ_CONVOLVE_FLOAT, WLZ_CONVOLVE_INT, WLZ_EMPTY_OBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_VALUES_NULL, WLZ_FMATCHOBJ, WLZ_HISTOGRAM, WLZ_INTERVALDOMAIN_INTVL, WLZ_INTERVALDOMAIN_RECT, WLZ_PLANEDOMAIN_DOMAIN, WLZ_PROPERTY_OBJ, WLZ_RECTANGLE, WLZ_TEXT, WLZ_TRANS_OBJ, WLZ_TRANSFORM_2D_AFFINE, WLZ_WARP_TRANS, WlzBoundingBox3DTo3I(), _WlzIBox3::xMax, _WlzIBox3::xMin, _WlzIBox3::yMax, _WlzIBox3::yMin, _WlzIBox3::zMax, and _WlzIBox3::zMin.

Referenced by WlzAffineTransformGMShell(), WlzAffineTransformIsTranslate(), WlzBoundingBox2I(), WlzCompoundToRGBA(), WlzContourFromPoints(), WlzContourGrdObj2D(), WlzContourRBFBndObj3D(), WlzDomainFill3D(), WlzEffWriteObjAm(), WlzEffWriteObjNrrd(), WlzFourierTransformObj(), WlzGreyValueMixing_s(), WlzRasterObj(), WlzSepFilter(), WlzSplitMontageObj(), and WlzSplitObj().

WlzDBox3 WlzBoundingBox3D ( WlzObject inObj,
WlzErrorNum dstErr 
)

Computes the double precision 3D axis aligned bounding box of the given object.

Returns
3D double precision bounding box.
Parameters
inObjThe given object.
dstErrDestination error pointer, may be NULL.

References _WlzDomain::b, _WlzCMesh2D::bBox, _WlzCMesh2D5::bBox, _WlzCMesh3D::bBox, _WlzDomain::cm2, _WlzDomain::cm2d5, _WlzDomain::cm3, _WlzValues::core, _WlzDomain::core, _WlzDomain::ctr, _WlzObject::domain, _WlzDomain::i, _WlzIntervalDomain::kol1, _WlzPlaneDomain::kol1, _WlzIntervalDomain::lastkl, _WlzPlaneDomain::lastkl, _WlzIntervalDomain::lastln, _WlzPlaneDomain::lastln, _WlzPlaneDomain::lastpl, _WlzIntervalDomain::line1, _WlzPlaneDomain::line1, _WlzValues::obj, _WlzDomain::p, _WlzPlaneDomain::plane1, _WlzDomain::poly, _WlzDomain::t, _WlzObject::type, _WlzCoreDomain::type, _WlzObject::values, WLZ_2D_DOMAINOBJ, WLZ_2D_POLYGON, WLZ_3D_DOMAINOBJ, WLZ_3D_POLYGON, WLZ_3D_WARP_TRANS, WLZ_AFFINE_TRANS, WLZ_BOUNDLIST, WLZ_CMESH_2D, WLZ_CMESH_2D5, WLZ_CMESH_3D, WLZ_COMPOUND_ARR_1, WLZ_COMPOUND_ARR_2, WLZ_COMPOUND_LIST_1, WLZ_COMPOUND_LIST_2, WLZ_CONTOUR, WLZ_CONV_HULL, WLZ_CONVOLVE_FLOAT, WLZ_CONVOLVE_INT, WLZ_EMPTY_OBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_VALUES_NULL, WLZ_FMATCHOBJ, WLZ_HISTOGRAM, WLZ_INTERVALDOMAIN_INTVL, WLZ_INTERVALDOMAIN_RECT, WLZ_PLANEDOMAIN_DOMAIN, WLZ_PROPERTY_OBJ, WLZ_RECTANGLE, WLZ_TEXT, WLZ_TRANS_OBJ, WLZ_TRANSFORM_2D_AFFINE, WLZ_WARP_TRANS, WlzCMeshUpdateBBox2D(), WlzCMeshUpdateBBox2D5(), WlzCMeshUpdateBBox3D(), _WlzDBox2::xMax, _WlzDBox3::xMax, _WlzDBox2::xMin, _WlzDBox3::xMin, _WlzDBox2::yMax, _WlzDBox3::yMax, _WlzDBox2::yMin, _WlzDBox3::yMin, _WlzDBox3::zMax, and _WlzDBox3::zMin.

Referenced by WlzBoundingBox2D(), and WlzBoundingBoxVtx3I().

WlzDBox3 WlzBoundingBoxGModel3D ( WlzGMModel model,
WlzErrorNum dstErr 
)

Computes the 3D axis aligned bounding box of the 3D geometric model. It is an error if the model is not a 3D model.

Returns
3D bounding box.
Parameters
modelGiven model.
dstErrDestination error pointer, may be NULL.

References _WlzGMModel::child, _WlzGMShell::idx, _WlzGMShell::next, _WlzGMModel::type, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_GMMOD_3D, WLZ_GMMOD_3I, WLZ_GMMOD_3N, WlzGMShellGetGBB3D(), _WlzDBox3::xMax, _WlzDBox3::xMin, _WlzDBox3::yMax, _WlzDBox3::yMin, _WlzDBox3::zMax, and _WlzDBox3::zMin.

Referenced by WlzBoundingBoxVtx3I(), and WlzGeoModelGridWSpSet3D().

WlzDBox2 WlzBoundingBoxGModel2D ( WlzGMModel model,
WlzErrorNum dstErr 
)

Computes the 2D axis aligned bounding box of the 2D geometric model. It is an error if the model is not a 2D model.

Returns
2D bounding box.
Parameters
modelGiven model.
dstErrDestination error pointer, may be NULL.

References _WlzGMModel::child, _WlzGMShell::idx, _WlzGMShell::next, _WlzGMModel::type, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_GMMOD_2D, WLZ_GMMOD_2I, WLZ_GMMOD_2N, WlzGMShellGetGBB2D(), _WlzDBox2::xMax, _WlzDBox2::xMin, _WlzDBox2::yMax, and _WlzDBox2::yMin.

WlzIBox2 WlzBoundingBox2DTo2I ( WlzDBox2  bBox2D)

Converts a 2D double precision bounding box to an integer bounding box. There is no checking done for underflows or overflows.

Returns
Integer bounding box.
Parameters
bBox2DDouble precision bounding box.

References _WlzIBox2::xMax, _WlzDBox2::xMax, _WlzIBox2::xMin, _WlzDBox2::xMin, _WlzIBox2::yMax, _WlzDBox2::yMax, _WlzIBox2::yMin, and _WlzDBox2::yMin.

WlzDBox2 WlzBoundingBox2ITo2D ( WlzIBox2  bBox2I)

Converts a 2D integer bounding box to an double precision bounding box.

Returns
Double precision bounding box.
Parameters
bBox2IDouble precision bounding box.

References _WlzIBox2::xMax, _WlzDBox2::xMax, _WlzIBox2::xMin, _WlzDBox2::xMin, _WlzIBox2::yMax, _WlzDBox2::yMax, _WlzIBox2::yMin, and _WlzDBox2::yMin.

WlzIBox3 WlzBoundingBox3DTo3I ( WlzDBox3  bBox3D)

Converts a 3D double precision bounding box to an integer bounding box. There is no checking done for underflows or overflows.

Returns
Integer bounding box.
Parameters
bBox3DDouble precision bounding box.

References _WlzIBox3::xMax, _WlzDBox3::xMax, _WlzIBox3::xMin, _WlzDBox3::xMin, _WlzIBox3::yMax, _WlzDBox3::yMax, _WlzIBox3::yMin, _WlzDBox3::yMin, _WlzIBox3::zMax, _WlzDBox3::zMax, _WlzIBox3::zMin, and _WlzDBox3::zMin.

Referenced by WlzBoundingBox3I().

WlzDBox3 WlzBoundingBox3ITo3D ( WlzIBox3  bBox3I)

Converts a 3D integer bounding box to an double precision bounding box.

Returns
Double precision bounding box.
Parameters
bBox3IInteger bounding box.

References _WlzIBox3::xMax, _WlzDBox3::xMax, _WlzIBox3::xMin, _WlzDBox3::xMin, _WlzIBox3::yMax, _WlzDBox3::yMax, _WlzIBox3::yMin, _WlzDBox3::yMin, _WlzIBox3::zMax, _WlzDBox3::zMax, _WlzIBox3::zMin, and _WlzDBox3::zMin.

WlzFBox3 WlzBoundingBox3DTo3F ( WlzDBox3  bBox3D)

Converts a 3D double bounding box to a single precision bounding box.

Returns
Single precision bounding box.
Parameters
bBox3DDouble precision bounding box.

References _WlzDBox3::xMax, _WlzFBox3::xMax, _WlzDBox3::xMin, _WlzFBox3::xMin, _WlzDBox3::yMax, _WlzFBox3::yMax, _WlzDBox3::yMin, _WlzFBox3::yMin, _WlzDBox3::zMax, _WlzFBox3::zMax, _WlzDBox3::zMin, and _WlzFBox3::zMin.

WlzDBox3 WlzBoundingBox3FTo3D ( WlzFBox3  bBox3F)

Converts a 3D single bounding box to a double precision bounding box.

Returns
Double precision bounding box.
Parameters
bBox3FSingle precision bounding box.

References _WlzDBox3::xMax, _WlzFBox3::xMax, _WlzDBox3::xMin, _WlzFBox3::xMin, _WlzDBox3::yMax, _WlzFBox3::yMax, _WlzDBox3::yMin, _WlzFBox3::yMin, _WlzDBox3::zMax, _WlzFBox3::zMax, _WlzDBox3::zMin, and _WlzFBox3::zMin.

WlzIBox2 WlzBoundingBoxUnion2I ( WlzIBox2  box0,
WlzIBox2  box1 
)

Computes the 2D integer bounding box which encloses the given pair of bounding boxes.

Returns
Axis alligned 2D integer bounding box.
Parameters
box0First bounding box.
box1Second bounding box.

References _WlzIBox2::xMax, _WlzIBox2::xMin, _WlzIBox2::yMax, and _WlzIBox2::yMin.

Referenced by WlzImageBlendObjToBufRGBA().

WlzFBox2 WlzBoundingBoxUnion2F ( WlzFBox2  box0,
WlzFBox2  box1 
)

Computes the 2D single precision bounding box which encloses the given pair of bounding boxes.

Returns
Axis alligned 2D single precision bounding box.
Parameters
box0First bounding box.
box1Second bounding box.

References _WlzFBox2::xMax, _WlzFBox2::xMin, _WlzFBox2::yMax, and _WlzFBox2::yMin.

WlzDBox2 WlzBoundingBoxUnion2D ( WlzDBox2  box0,
WlzDBox2  box1 
)

Computes the 2D double precision bounding box which encloses the given pair of bounding boxes.

Returns
Axis alligned 2D double precision bounding box.
Parameters
box0First bounding box.
box1Second bounding box.

References _WlzDBox2::xMax, _WlzDBox2::xMin, _WlzDBox2::yMax, and _WlzDBox2::yMin.

WlzIBox3 WlzBoundingBoxUnion3I ( WlzIBox3  box0,
WlzIBox3  box1 
)

Computes the 3D integer bounding box which encloses the given pair of bounding boxes.

Returns
Axis alligned 3D integer bounding box.
Parameters
box0First bounding box.
box1Second bounding box.

References _WlzIBox3::xMax, _WlzIBox3::xMin, _WlzIBox3::yMax, _WlzIBox3::yMin, _WlzIBox3::zMax, and _WlzIBox3::zMin.

WlzFBox3 WlzBoundingBoxUnion3F ( WlzFBox3  box0,
WlzFBox3  box1 
)

Computes the 3D single precision bounding box which encloses the given pair of bounding boxes.

Returns
Axis alligned 3D float precision bounding box.
Parameters
box0First bounding box.
box1Second bounding box.

References _WlzFBox3::xMax, _WlzFBox3::xMin, _WlzFBox3::yMax, _WlzFBox3::yMin, _WlzFBox3::zMax, and _WlzFBox3::zMin.

WlzDBox3 WlzBoundingBoxUnion3D ( WlzDBox3  box0,
WlzDBox3  box1 
)

Computes the 3D double precision bounding box which encloses the given pair of bounding boxes.

Returns
Axis alligned 3D double precision bounding box.
Parameters
box0First bounding box.
box1Second bounding box.

References _WlzDBox3::xMax, _WlzDBox3::xMin, _WlzDBox3::yMax, _WlzDBox3::yMin, _WlzDBox3::zMax, and _WlzDBox3::zMin.

Referenced by WlzBoundingBoxVtx3I().

double WlzCCorS2D ( WlzObject obj0,
WlzObject obj1,
int  unionFlg,
int  normFlg,
WlzErrorNum dstErr 
)

Computes the cross correlation of the two given 2D spatial domain objects in the spatial domain. The algorithm used by this function is not an efficient unless a single cross correlation value is required.

Returns
Cross correlation value.
Parameters
obj0First object. Must have been assigned.
obj1Second object. Must have been assigned.
unionFlgComputes the cross correlation value in the union of the two objects domains if non zero. The default is to use the intersection of the domains.
normFlgNormalise the cross-correlation value by dividing it by the area/volume over which it is computed if this flag is non-zero.
dstErrDestination error pointer, may be NULL.

References _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzGreyValueWSpace::gType, _WlzGreyValueWSpace::gVal, _WlzIntervalWSpace::lftpos, _WlzIntervalWSpace::linpos, _WlzIntervalWSpace::rgtpos, _WlzObject::type, _WlzObject::values, _WlzIVertex2::vtX, _WlzIVertex2::vtY, WLZ_2D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_EOO, WLZ_ERR_GREY_TYPE, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_VALUES_NULL, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_RASTERDIR_ILIC, WlzArea(), WlzFreeObj(), WlzGreyValueFreeWSp(), WlzGreyValueGet(), WlzGreyValueMakeWSp(), WlzInitRasterScan(), WlzIntersect2(), WlzNextInterval(), and WlzUnion2().

double WlzCentrality ( WlzObject fObj,
WlzObject bObj,
int  nRay,
int  binFlg,
double *  dstMaxR,
WlzErrorNum dstErr 
)

Computes the centrality of a feature domain with respect to a boundary domain. The boundary domain must enclose the feature domain.

Returns
Centrality feature value in range [0.0-1.0].
            Rays are projected from the centre of mass of the boundary
            domain to it's boundary. The maximum value of this distance
            for a given angle \form#99 being \form#100. At each point
            in the feature domain intersected by the ray the currrent
            value of the centrality is updated. The distance from the
            centre of mass to each feature point is defined to be
\(r_{i,j}\) and the mass at this point \(m_{i,j}\). The centrality of the feature domain \(\Omega_f\) with respect to the border domain \(Omega_b\) is defined to be

\[ c = \frac{\sum_{i,j}{m_{i,j}(R_i - r_{i,j})}} {\sum_{i,j}{m_{i,j}R}} \]

Parameters
fObjFeature domain object, \(Omega_f\).
bObjBoundary domain object, \(Omega_b\).
nRayNumber of equally spaced rays projected from the centre of mass.
binFlgTreat as binary object if non-zero, with all masses having value 1.0.
dstMaxRDestination pointer for maximum boundary radius, may be NULL.
dstErrDestination error pointer, may be NULL.

References AlcFree(), AlcMalloc(), ALG_M_PI, _WlzDomain::b, _WlzValues::core, _WlzDomain::core, _WlzVertexP::d2, _WlzGreyP::dbp, _WlzObject::domain, _WlzBoundList::down, _WlzVertexP::f2, _WlzGreyP::flp, _WlzVertexP::i2, _WlzGreyP::inp, _WlzIntervalWSpace::lftpos, _WlzIntervalWSpace::linpos, _WlzBoundList::next, _WlzPolygonDomain::nvertices, _WlzGreyWSpace::pixeltype, _WlzBoundList::poly, _WlzIntervalWSpace::rgtpos, _WlzGreyP::shp, _WlzObject::type, _WlzPolygonDomain::type, _WlzGreyWSpace::u_grintptr, _WlzGreyP::ubp, _WlzObject::values, _WlzIVertex2::vtX, _WlzFVertex2::vtX, _WlzDVertex2::vtX, _WlzPolygonDomain::vtx, _WlzIVertex2::vtY, _WlzFVertex2::vtY, _WlzDVertex2::vtY, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_EOO, WLZ_ERR_GREY_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_UNIMPLEMENTED, WLZ_ERR_VALUES_NULL, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_POLYGON_DOUBLE, WLZ_POLYGON_FLOAT, WLZ_POLYGON_INT, WLZ_RASTERDIR_ILIC, WlzBoundTo8Bound(), WlzCentreOfMass2D(), WlzEndGreyScan(), WlzFreeObj(), WlzGeomPolar2D(), WlzInitGreyScan(), WlzInitRasterScan(), WlzNextGreyInterval(), WlzNextInterval(), and WlzObjToBoundary().

WlzDVertex2 WlzCentreOfMass2D ( WlzObject srcObj,
int  binObjFlag,
double *  dstMass,
WlzErrorNum dstErr 
)

Calculates the centre of mass of a Woolz object. If the given object does not have grey values or the binary object flag is set (ie non zero) then every pixel or vertex within the object's domain has the same mass.

Returns
Coordinates of center of mass.
Parameters
srcObjGiven object.
binObjFlagBinary object flag.
dstMassDestination pointer for mass, may be NULL if not required.
dstErrDestination pointer for error, may be NULL.

References _WlzObject::domain, _WlzValues::obj, _WlzDomain::t, _WlzObject::type, _WlzObject::values, _WlzDVertex2::vtX, _WlzDVertex2::vtY, WLZ_2D_DOMAINOBJ, WLZ_CONTOUR, WLZ_DBG, WLZ_DBG_LVL_1, WLZ_DBG_LVL_2, WLZ_DBG_LVL_FN, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, and WLZ_TRANS_OBJ.

Referenced by WlzCentrality(), WlzCentreOfMassVtx3D(), and WlzThinToPoints().

WlzDVertex3 WlzCentreOfMass3D ( WlzObject srcObj,
int  binObjFlag,
double *  dstMass,
WlzErrorNum dstErr 
)

Calculates the centre of mass of a Woolz object. If the given object does not have grey values or the binary object flag is set (ie non zero) then every pixel or vertex within the objects domain has the same mass.

Returns
Coordinates of center of mass.
Parameters
srcObjGiven object.
binObjFlagBinary object flag.
dstMassDestination pointer for mass, may be NULL if not required.
dstErrDestination pointer for error, may be NULL.

References _WlzObject::domain, _WlzValues::obj, _WlzDomain::t, _WlzObject::type, _WlzObject::values, _WlzDVertex2::vtX, _WlzDVertex3::vtX, _WlzDVertex2::vtY, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_CONTOUR, WLZ_DBG, WLZ_DBG_LVL_1, WLZ_DBG_LVL_2, WLZ_DBG_LVL_FN, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, and WLZ_TRANS_OBJ.

Referenced by WlzCentreOfMassVtx3D(), and WlzThinToPoints().

WlzDVertex2 WlzCentreOfMassVtx2D ( int  nVtx,
WlzDVertex2 vtx 
)

Computes the centre of mass of a vector of 2D vertices.

Returns
Coordinates of centre of mass.
Parameters
nVtxNumber of vertices.
vtxThe vertices.

References WLZ_VTX_2_ADD, WLZ_VTX_2_SCALE, and WLZ_VTX_2_ZERO.

WlzDVertex3 WlzCentreOfMassVtx3D ( int  nVtx,
WlzDVertex3 vtx 
)

Computes the centre of mass of a vector of 3D vertices.

Returns
Coordinates of centre of mass.
Parameters
nVtxNumber of vertices.
vtxThe vertices.

References AlcVectorItemGet(), _WlzValues::core, _WlzDomain::core, _WlzDomain::ctr, _WlzGreyP::dbp, _WlzObject::domain, _WlzPlaneDomain::domains, _WlzGreyP::flp, _WlzGMVertex::idx, _WlzGreyP::inp, _WlzPlaneDomain::lastpl, _WlzIntervalWSpace::lftpos, _WlzIntervalWSpace::linpos, _WlzContour::model, _WlzGMResource::numIdx, _WlzDomain::p, _WlzGreyWSpace::pixeltype, _WlzPlaneDomain::plane1, _WlzGMModel::res, _WlzGreyP::rgbp, _WlzIntervalWSpace::rgtpos, _WlzGreyP::shp, _WlzGMModel::type, _WlzContour::type, _WlzCoreDomain::type, _WlzCoreValues::type, _WlzGreyWSpace::u_grintptr, _WlzGreyP::ubp, _WlzObject::values, _WlzVoxelValues::values, _WlzGMResource::vec, _WlzGMModelR::vertex, _WlzValues::vox, _WlzIVertex2::vtX, _WlzDVertex2::vtX, _WlzDVertex3::vtX, _WlzIVertex2::vtY, _WlzDVertex2::vtY, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_CONTOUR, WLZ_EMPTY_OBJ, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_EOO, WLZ_ERR_GREY_TYPE, WLZ_ERR_NONE, WLZ_ERR_TRANSFORM_TYPE, WLZ_ERR_VOXELVALUES_TYPE, WLZ_GMMOD_2D, WLZ_GMMOD_2I, WLZ_GMMOD_2N, WLZ_GMMOD_3D, WLZ_GMMOD_3I, WLZ_GMMOD_3N, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_RGBA, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_INTERVALDOMAIN_INTVL, WLZ_INTERVALDOMAIN_RECT, WLZ_PLANEDOMAIN_DOMAIN, WLZ_RASTERDIR_ILIC, WLZ_RGBA_MODULUS, WLZ_VTX_3_ADD, WLZ_VTX_3_SCALE, WLZ_VTX_3_ZERO, WlzAffineTransformVertexD2(), WlzAffineTransformVertexD3(), WlzCentreOfMass2D(), WlzCentreOfMass3D(), WlzEndGreyScan(), WlzFreeObj(), WlzGMVertexGetG3D(), WlzGreyTableIsTiled(), WlzInitGreyScan(), WlzInitRasterScan(), WlzMakeMain(), WlzNextGreyInterval(), and WlzNextInterval().

Referenced by WlzGeometryLSqOPlane().

WlzErrorNum WlzDistMetricGM ( WlzGMModel model0,
WlzGMModel model1,
double *  dstDistH,
double *  dstDistM,
double *  dstDistN,
double *  dstDistI 
)

Computes any combination of the Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the vertices of the given geometric models. See WlzDistMetricVertex2D() for details of the metrics.

Returns
Woolz error code.
Parameters
model0First geometric model.
model1Second geometric model.
dstDistHDestination pointer for the directed Hausdorff distance, may be NULL.
dstDistMDestination pointer for the directed mean nearest neighbour distance, may be NULL.
dstDistNDestination pointer for the directed median nearest neighbour distance, may be NULL.
dstDistIDestination pointer for the minimum nearest neighbour distance, may be NULL.

References AlcFree(), _WlzGMModel::type, _WlzVertexP::v, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_VERTEX_D2, WLZ_VERTEX_D3, WlzDistMetricVertex2D(), WlzDistMetricVertex3D(), and WlzVerticesFromGM().

WlzErrorNum WlzDistMetricDirGM ( WlzGMModel model0,
WlzGMModel model1,
double *  dstDistH,
double *  dstDistM,
double *  dstDistN,
double *  dstDistI 
)

Computes any combination of the directed Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the vertices of the given geometric models. See WlzDistMetricDirVertex2D() for details of the metrics.

Returns
Woolz error code.
Parameters
model0First geometric model.
model1Second geometric model.
dstDistHDestination pointer for the directed Hausdorff distance, may be NULL.
dstDistMDestination pointer for the directed mean nearest neighbour distance, may be NULL.
dstDistNDestination pointer for the directed median nearest neighbour distance, may be NULL.
dstDistIDestination pointer for the minimum nearest neighbour distance, may be NULL.

References AlcFree(), _WlzGMModel::type, _WlzVertexP::v, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_VERTEX_D2, WLZ_VERTEX_D3, WlzDistMetricDirVertex2D(), WlzDistMetricDirVertex3D(), and WlzVerticesFromGM().

WlzErrorNum WlzDistMetricVertex2D ( int  n0,
WlzDVertex2 vx0,
int  n1,
WlzDVertex2 vx1,
double *  dstDistH,
double *  dstDistM,
double *  dstDistN,
double *  dstDistI 
)

Computes any combination of the Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the given sets of vertices. Each of these distance measures is the maximum of the two possible directed measures:

\[ D = \max{(d(A,B), d(B,A))} \]

Where \(D\) is a non-directed distance metric and \(d\) is the associated directed distance metric. \(A\) and \(B\) are the two datasets.

Returns
Woolz error code.
Parameters
n0Number of vertices in the first array.
vx0First array of vertices.
n1Number of vertices in the second array.
vx1Second array of vertices.
dstDistHDestination pointer for the directed Hausdorff distance, may be NULL.
dstDistMDestination pointer for the directed mean nearest neighbour distance, may be NULL.
dstDistNDestination pointer for the directed median nearest neighbour distance, may be NULL.
dstDistIDestination pointer for the minimum nearest neighbour distance, may be NULL.

References WLZ_ERR_NONE, WLZ_MAX, and WlzDistMetricDirVertex2D().

Referenced by WlzDistMetricDirVertex3D(), and WlzDistMetricGM().

WlzErrorNum WlzDistMetricVertex3D ( int  n0,
WlzDVertex3 vx0,
int  n1,
WlzDVertex3 vx1,
double *  dstDistH,
double *  dstDistM,
double *  dstDistN,
double *  dstDistI 
)

Computes any combination of the Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the given sets of vertices. See WlzDistMetricVertex2D() for an explaination of the distance metrics.

Returns
Woolz error code.
Parameters
n0Number of vertices in the first array.
vx0First array of vertices.
n1Number of vertices in the second array.
vx1Second array of vertices.
dstDistHDestination pointer for the directed Hausdorff distance, may be NULL.
dstDistMDestination pointer for the directed mean nearest neighbour distance, may be NULL.
dstDistNDestination pointer for the directed median nearest neighbour distance, may be NULL.
dstDistIDestination pointer for the minimum nearest neighbour distance, may be NULL.

References WLZ_ERR_NONE, WLZ_MAX, and WlzDistMetricDirVertex3D().

Referenced by WlzDistMetricGM().

WlzErrorNum WlzDistMetricDirVertex2D ( int  n0,
WlzDVertex2 vx0,
int  n1,
WlzDVertex2 vx1,
double *  dstDistH,
double *  dstDistM,
double *  dstDistN,
double *  dstDistI 
)

Computes any combination of the directed Hausdorff, mean nearest neighbour, median nearest neighbour and minimum mean neighbour distances between the given sets of vertices. The directed Hausdorff distance metric is:

\[ \max_{a \in A}{\min_{b \in B}{\|a - b\|}} \]

The directed mean nearest neighbour distance metric is:

\[ \frac{1}{n_a} \sum_{a \in A}{\min_{b \in B}{\|a - b\|}} \]

Likewise the directed median nearest neighbour distance metric is:

\[ \mathrm{median}_{a \in A}{\min_{b \in B}{\|a - b\|}} \]

Where \(A\) and \(B\) are the two datasets.

Returns
Woolz error code.
Parameters
n0Number of vertices in the first array.
vx0First array of vertices.
n1Number of vertices in the second array.
vx1Second array of vertices.
dstDistHDestination pointer for the directed Hausdorff distance, may be NULL.
dstDistMDestination pointer for the directed mean nearest neighbour distance, may be NULL.
dstDistNDestination pointer for the directed median nearest neighbour distance, may be NULL.
dstDistIDestination pointer for the minimum nearest neighbour distance, may be NULL.

References AlcFree(), AlcKDTGetNN(), AlcKDTTreeFree(), AlcMalloc(), AlgRankSelectD(), _WlzVertexP::d2, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_PARAM_DATA, WLZ_ERR_PARAM_NULL, WLZ_VERTEX_D2, and WlzVerticesBuildTree().

Referenced by WlzDistMetricDirGM(), and WlzDistMetricVertex2D().

WlzErrorNum WlzDistMetricDirVertex3D ( int  n0,
WlzDVertex3 vx0,
int  n1,
WlzDVertex3 vx1,
double *  dstDistH,
double *  dstDistM,
double *  dstDistN,
double *  dstDistI 
)

Computes any combination of the directed Hausdorff, mean nearest neighbour, median nearest neighbour and minimum nearest neighbour distances between the given sets of vertices. See WlzDistMetricDirVertex2D() for an explaination of the distance metrics.

Returns
Woolz error code.
Parameters
n0Number of vertices in the first array.
vx0First array of vertices.
n1Number of vertices in the second array.
vx1Second array of vertices.
dstDistHDestination pointer for the directed Hausdorff distance, may be NULL.
dstDistMDestination pointer for the directed mean nearest neighbour distance, may be NULL.
dstDistNDestination pointer for the directed median nearest neighbour distance, may be NULL.
dstDistIDestination pointer for the minimum nearest neighbour distance, may be NULL.

References AlcFree(), AlcKDTGetNN(), AlcKDTTreeFree(), AlcMalloc(), AlgRankSelectD(), _WlzVertexP::d3, main(), _WlzDVertex2::vtX, _WlzDVertex2::vtY, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_PARAM_DATA, WLZ_ERR_PARAM_NULL, WLZ_VERTEX_D3, WlzDistMetricVertex2D(), and WlzVerticesBuildTree().

Referenced by WlzDistMetricDirGM(), and WlzDistMetricVertex3D().

WlzDVertex3* WlzGeometryTrackUpAndDown_s ( int  numberOfPixelsZ,
int  startTrackingFile,
int  numberOfFilesDownOrUp,
double  disForInAndOutGuid,
double  disForInAndOut,
unsigned char **  TwoDImageFilesNameList,
int  numOf2DWlzFiles,
int  downOrUp,
int  sectionLength_N,
int  subSubSectionLength_L,
int  numberOfSampleP_k,
char *  surfacePointFileName,
char *  surfaceInPointFileName,
char *  surfaceOutPointFileName,
int  startShell,
int  endShell,
int  startSection,
int  endSection,
double  minDis,
WlzErrorNum dstErr 
)

Track a curved path through a set of geometric model shells.

Returns
An array of vertices tracking thougha set of geometry model shells
Parameters
numberOfPixelsZthe input z-derection of pixel number (input)
startTrackingFilenot documented
numberOfFilesDownOrUpnumner of files (?)
disForInAndOutGuiddistance parameter
disForInAndOutdistance parameter
TwoDImageFilesNameList2D image files name list
numOf2DWlzFilesnumber of 2D woolz files
downOrUptracking direction flag
sectionLength_Nlength used to cut a patch (unit in pixel)
subSubSectionLength_Llength, smaller than sectionLength_N used to sample points
numberOfSampleP_knumber of points will be sampled in the above section
surfacePointFileNameFileNameStr to output the surface points
surfaceInPointFileNameFileNameStr to output the in surface points
surfaceOutPointFileNameFileNameStr to output the out surface points
startShellthe n-th Shell to begin with tracking
endShellthe end Shell from where stop tracking
startSectionthe n-th Section to begin with tracking
endSectionthe section to stop tracking.
minDisminimum distance (?)
dstErrerror return.
Source:
WlzGeometryTrackUpAndDown_s.c
Author
: J. Rao, R. Baldock and B. Hill

References ALC_ER_NONE, AlcFree(), AlcKDTGetNN(), AlcKDTTreeFacts(), AlcMalloc(), AlcVectorItemGet(), _WlzGMShell::child, _WlzGMModel::child, _WlzDomain::ctr, _WlzVertexP::d2, _WlzVertexP::d3, _WlzGMVertexT::diskT, _WlzGMVertex::diskT, _WlzObject::domain, _WlzGMEdgeT::edge, _WlzGMEdge::edgeT, _WlzGMLoopT::edgeT, free_matrix(), free_vector(), _WlzGMVertex::geo, _AlcKDTNode::idx, _WlzGMVertex::idx, _WlzGMDiskT::idx, _WlzGMLoopT::idx, _WlzGMShell::idx, _AlcPointP::kD, _AlcKDTNode::key, _WlzGMModelR::loopT, matrix(), MaxNumOfFiles, _WlzContour::model, _WlzGMEdgeT::next, _WlzGMLoopT::next, _WlzGMShell::next, NumberToTrack, _WlzGMEdgeT::opp, _WlzGMVertexT::parent, _WlzGMEdgeT::parent, _WlzGMLoopT::parent, _WlzGMEdgeT::prev, _WlzGMModel::res, _WlzGMModelR::shell, TOL, _WlzGMModel::type, _WlzGeomPolyListItem2D::v, _WlzVertexP::v, _WlzGMResource::vec, vector(), _WlzGMDiskT::vertex, _WlzGMModelR::vertex, _WlzGMDiskT::vertexT, _WlzGMEdgeT::vertexT, _WlzGMVertexGU::vg2D, _WlzGMVertexGU::vg2I, _WlzGMVertexGU::vg3D, _WlzGMVertexGU::vg3I, _WlzIVertex2::vtX, _WlzDVertex2::vtX, _WlzIVertex3::vtX, _WlzDVertex3::vtX, _WlzGMVertexG2I::vtx, _WlzGMVertexG2D::vtx, _WlzGMVertexG3I::vtx, _WlzGMVertexG3D::vtx, _WlzIVertex2::vtY, _WlzDVertex2::vtY, _WlzIVertex3::vtY, _WlzDVertex3::vtY, _WlzIVertex3::vtZ, _WlzDVertex3::vtZ, WLZ_CONTOUR, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_FILE_OPEN, WLZ_ERR_GMELM_NULL, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_PARAM_NULL, WLZ_GMMOD_2D, WLZ_GMMOD_2I, WLZ_GMMOD_3D, WLZ_GMMOD_3I, WLZ_VTX_2_ADD, WLZ_VTX_2_LENGTH, WLZ_VTX_2_SCALE, WLZ_VTX_2_SUB, WlzFreeObj(), WlzGeomTriangleNormal(), WlzGeomTriangleSnArea2(), WlzGMModelDeleteS(), WlzGMModelDeleteV(), WlzReadObj(), WlzValueCopyDVertexToDVertex3(), WlzVerticesBuildTree(), and WlzVerticesFromObj().

size_t WlzGreySize ( WlzGreyType  gType)
int WlzGreyStats ( WlzObject srcObj,
WlzGreyType dstGType,
double *  dstMin,
double *  dstMax,
double *  dstSum,
double *  dstSumSq,
double *  dstMean,
double *  dstStdDev,
WlzErrorNum dstErr 
)

Calculates simple quick statistics for given 2D or 3D domain object with grey values. Pointers provided for results may be NULL without causing an error.

Returns
Object area or -1 on error.
Parameters
srcObjObject from which to calculate the statistics.
dstGTypePointer for grey type.
dstMinPointer for minimum value.
dstMaxPointer for maximum value.
dstSumPointer for sum of values.
dstSumSqPointer for sum of squares of values.
dstMeanMean value.
dstStdDevStandard deviation of values.
dstErrDestination pointer for error number, may be NULL if not required.

References _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzPlaneDomain::domains, _WlzPlaneDomain::lastpl, _WlzDomain::p, _WlzPlaneDomain::plane1, _WlzObject::type, _WlzCoreDomain::type, _WlzCoreValues::type, _WlzObject::values, _WlzVoxelValues::values, _WlzValues::vox, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_DBG, WLZ_DBG_LVL_1, WLZ_DBG_LVL_2, WLZ_DBG_LVL_FN, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_VALUES_DATA, WLZ_ERR_VALUES_NULL, WLZ_PLANEDOMAIN_DOMAIN, WlzFreeObj(), WlzGreyTableIsTiled(), and WlzMakeMain().

Referenced by main(), WlzEffWriteObjAnl(), WlzGetPatchTreeToDepth(), WlzInteriority(), WlzPatchTreeToObject(), WlzRegCCorObjs(), WlzRGBAGreyStats(), WlzToArray2D(), and WlzToArray3D().

WlzObject* WlzGreyValueMixing_s ( WlzObject sObj,
WlzObject tObj,
double  xmiddle,
WlzErrorNum dstErr 
)
double* WlzInteriorityN ( WlzObject refObj,
int  nTstObj,
WlzObject **  tstObjs,
WlzErrorNum dstErr 
)

Computes an interiority score for each test object with respect to the reference object. See WlzInteriority(). This function computes the distance transform for the reference domain once and then uses this for each of the test domains. If not NULL the returned array of scores should be freed using AlcFree().

Returns
Array of interiority scores with a score for each of the test objects or NULL on error.
Parameters
refObjGiven reference object.
nTstObjNumber of test objects.
tstObjsArray of test objects.
dstErrDestination error pointer, may be NULL.

References AlcCalloc(), AlcFree(), _WlzDomain::core, _WlzObject::domain, _WlzObject::type, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_EMPTY_OBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_ERR_PARAM_NULL, WlzAssignObject(), and WlzFreeObj().

double WlzInteriority ( WlzObject refObj,
WlzObject tstObj,
WlzErrorNum dstErr 
)

Computes an interiority score for the test object with respect to the reference object. The interiority score is the mean distance of those elements of the intersection of the reference and test object from the boundary of the reference object, ie:

\[ s = t \cap r b = t \neg t^- i = \frac{1}{|s|} \sum_{s}{D(b, s)} \]

where \(t\) is a test object, \(t^-\) is the eroded test object, \(|x|\) is the cardinality of \(x\) and \(D\) is the distance operator.

Returns
Interiority score for the test object.
Parameters
refObjGiven reference object.
tstObjArray of test objects.
dstErrDestination error pointer, may be NULL.

References _WlzDomain::core, _WlzObject::domain, _WlzGreyV::inv, _WlzPixelV::type, _WlzObject::type, _WlzPixelV::v, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_EMPTY_OBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_GREY_INT, WLZ_GREY_TAB_RAGR, WLZ_OCTAGONAL_DISTANCE, WlzAssignObject(), WlzBoundaryDomain(), WlzDistanceTransform(), WlzFreeObj(), WlzGreyStats(), WlzGreyTransfer(), WlzGreyValueTableType(), WlzIntersect2(), WlzIsEmpty(), and WlzNewObjectValues().

int WlzLineArea ( WlzObject obj,
WlzErrorNum dstErr 
)

Calculate the line-area of an object defined as the sum of the line segments bounded by the left hand end of the first interval in a line and the right hand end of the last interval in that line.

Returns
Line area calculated, -1 on error.
Parameters
objInput object.
dstErrError return.
Source:
WlzLineArea.c

References _WlzDomain::core, _WlzObject::domain, _WlzDomain::i, _WlzIntervalWSpace::intrmn, _WlzIntervalDomain::kol1, _WlzIntervalDomain::lastkl, _WlzIntervalDomain::lastln, _WlzIntervalWSpace::lftpos, _WlzIntervalDomain::line1, _WlzIntervalWSpace::rgtpos, _WlzObject::type, _WlzIntervalDomain::type, WLZ_2D_DOMAINOBJ, WLZ_EMPTY_OBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_EOO, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_INTERVALDOMAIN_INTVL, WLZ_INTERVALDOMAIN_RECT, WLZ_RASTERDIR_ILIC, WlzInitRasterScan(), and WlzNextInterval().

Referenced by WlzNewValueTb(), and WlzReadObj().

WlzObject* WlzMakeMarkers ( WlzVertexType  vType,
int  nVtx,
WlzVertexP  vtx,
WlzMarkerType  mType,
int  mSz,
WlzErrorNum dstErr 
)

Constructs a domain from the union of marker domains with a marker domain at each of the given vertex positions.

Returns
New domain object without values.
Parameters
vTypeVertex type.
nVtxNumber of vertices.
vtxGiven vertices.
mTypeMarker type.
mSzMarker size. This is the radius of a sphere marker. The marker size is ignored for point markers.
dstErrDestination error pointer, may be NULL.

References _WlzVertexP::i2, _WlzVertexP::i3, _WlzVertexP::v, _WlzIVertex3::vtX, _WlzIVertex3::vtY, _WlzIVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_NONE, WLZ_ERR_PARAM_DATA, WLZ_ERR_PARAM_NULL, WLZ_ERR_PARAM_TYPE, WLZ_MARKER_POINT, WLZ_MARKER_SPHERE, WLZ_VERTEX_I2, WLZ_VERTEX_I3, WlzFreeObj(), WlzMakeEmpty(), WlzMakeSinglePixelObject(), WlzMakeSphereObject(), WlzShiftObject(), and WlzUnion2().

Referenced by WlzMarkerLattice(), and WlzPointsToMarkers().

WlzObject* WlzMarkerLattice ( WlzObject gObj,
WlzMarkerType  mType,
int  mSz,
int  mSep,
WlzErrorNum dstErr 
)
WlzPoints* WlzMakePoints ( WlzObjectType  type,
int  nVtx,
WlzVertexP  vtxP,
int  maxVtx,
WlzErrorNum dstErr 
)

Creates a new point domain. A point domain consists of an array of vertices which are treated as seperate points.

Returns
New point domain.
Parameters
typeType of point vertices, which must be one of WLZ_POINTS_2I, WLZ_POINTS_2D, WLZ_POINTS_3I or WLZ_POINTS_3D.
nVtxNumber of points to copy to the new domain.
vtxPPoints to copy to the new domain. These must be of the correct type. If NULL then no points are copied.
maxVtxThe number of vertices for which space is allocated.
dstErrDestination error pointer, may be NULL.

References AlcCalloc(), _WlzPoints::maxPoints, _WlzPoints::nPoints, _WlzPoints::points, _WlzPoints::type, _WlzVertexP::v, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_POINTS_2D, WLZ_POINTS_2I, WLZ_POINTS_3D, and WLZ_POINTS_3I.

Referenced by WlzAffineTransformPoints(), WlzCMeshStrainTensorAtPts(), WlzCMeshTransformManyObjAsIdx(), WlzEffWritePointsVtkFieldValues(), WlzPointsDither(), WlzPointsFromDomObj(), WlzReadMeshTransform3D(), and WlzThinToPoints().

WlzErrorNum WlzNObjGreyStats ( WlzObject gObj,
int  mean,
int  stddev,
int *  dstN,
WlzObject **  dstMinObj,
WlzObject **  dstMaxObj,
WlzObject **  dstSumObj,
WlzObject **  dstSSqObj 
)

Computes a collection of objects from the object (which should be a compound array object). The computed objects all have the intersection of the given object domains as their domain and WLZ_GREY_DOUBLE values for the minimum, maximum, sum and sum of squares of the given grey values at each pixel/voxel within the intersection domain. Returned objects will have name properties set to: min, max, sum, ssq, mean and stddev as appropriate.

Returns
Woolz error code.
Parameters
gObjGiven object.
meanCompute mean not sum if non-zero.
stddevCompute standard deviation not sum of squares if non-zero.
dstNDestination pointer for number of objects, may be NULL.
dstMinObjDestination pointer for minimum value object, may be NULL if not required.
dstMaxObjDestination pointer for maximum value object, may be NULL if not required.
dstSumObjDestination pointer for sum of values object, may be NULL if not required.
dstSSqObjDestination pointer for sum of squares object, may be NULL if not required.

References ALC_ER_NONE, AlcDLPListEntryAppend(), _WlzValues::core, _WlzDomain::core, _WlzProperty::core, _WlzGreyP::dbp, _WlzGreyV::dbv, _WlzObject::domain, _WlzPlaneDomain::domains, _WlzPlaneDomain::lastpl, _WlzIntervalWSpace::lftpos, _WlzPropertyList::list, _WlzProperty::name, _WlzDomain::p, _WlzGreyWSpace::pixeltype, _WlzPlaneDomain::plane1, _WlzObject::plist, _WlzIntervalWSpace::rgtpos, _WlzPixelV::type, _WlzObject::type, _WlzCoreValues::type, _WlzGreyWSpace::u_grintptr, _WlzGreyP::ubp, _WlzPixelV::v, _WlzObject::values, _WlzVoxelValues::values, _WlzValues::vox, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_BO_SUBTRACT, WLZ_COMPOUND_ARR_1, WLZ_COMPOUND_ARR_2, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_EOO, WLZ_ERR_GREY_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_VALUES_NULL, WLZ_ERR_VALUES_TYPE, WLZ_FN_SCALAR_SQR, WLZ_FN_SCALAR_SQRT, WLZ_GREY_DOUBLE, WLZ_GREY_TAB_RAGR, WLZ_GREY_UBYTE, WlzAssignPropertyList(), WlzEndGreyScan(), WlzFreeObj(), WlzFreeProperty(), WlzFreePropertyListEntry(), WlzGreySetValue(), WlzGreyTableIsTiled(), WlzGreyValueTableType(), WlzImageArithmetic(), WlzInitGreyScan(), WlzIntersectN(), WlzIsEmpty(), WlzMakeMain(), WlzMakeNameProperty(), WlzMakePropertyList(), WlzNewObjectValues(), WlzNextGreyInterval(), WlzScalarFn(), and WlzScalarMultiply().

WlzErrorNum Wlz3DSectionOcc ( WlzObject obj,
WlzThreeDViewStruct vs,
double  sep,
double *  dstFirst,
double *  dstLast,
int *  dstArraySizeOcc,
int **  dstArrayOcc 
)

Computes an array of integers which correspond to a line through the given object's domain perpendicular to the plane defined by the given view structure. At each point along the line the occupancy area or number of domains intersecting the plane is computed. When the given object is a 3D spatial domain object then areas are computed and when it is a compound array then the occupancy (number of domains) is computed.

Returns
Woolz error code.
Parameters
objGiven object with the domain or a compound object with many domains.
vsGiven view structure which defines the cutting plane. The view structure will be initialised within this function.
sepPlane separation distance, must be greater than ALG_DBL_TOLLERANCE.
dstFirstDestination pointer for the first coordinate of the line in a 1D coordinate system perpendicular to the cutting plane. May be NULL.
dstLastDestination pointer for the last coordinate of the line in a 1D coordinate system perpendicular to the cutting plane. May be NULL.
dstArraySizeOccDestination pointer for the size of the occupancy array. May be NULL.
dstArrayOccDestination pointer for the occupancy array. The occupancy array should be freed using AlcFree(). May be NULL.

References AlcCalloc(), AlcFree(), ALG_DBL_TOLLERANCE, _WlzDomain::core, _WlzThreeDViewStruct::dist, _WlzObject::domain, _WlzThreeDViewStruct::maxvals, _WlzThreeDViewStruct::minvals, _WlzCompoundArray::n, _WlzCompoundArray::o, _WlzThreeDViewStruct::ref_obj, _WlzObject::type, _WlzThreeDViewStruct::type, _WlzDVertex3::vtZ, WLZ_3D_DOMAINOBJ, WLZ_3D_VIEW_STRUCT, WLZ_COMPOUND_ARR_1, WLZ_COMPOUND_ARR_2, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOUBLE_DATA, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_ERR_PARAM_NULL, WLZ_ERR_PARAM_TYPE, WLZ_INTERPOLATION_NEAREST, WlzArea(), WlzAssignObject(), WlzFree3DViewStruct(), WlzFreeObj(), WlzGetSubSectionFromObject(), WlzInit3DViewStruct(), WlzIsEmpty(), WlzMake3DViewStructCopy(), and WlzUnionN().

WlzObject* WlzDomainOccupancy ( WlzObject gObj,
WlzErrorNum dstErr 
)

Computes a new Woolz domain object which has the domain of the given object (union of domains if the object is a compound array) and a value table with integer values representing the number of domains present.

Returns
New Woolz object or NULL on error.
Parameters
gObjGiven object.
dstErrDestination error pointer.

References _WlzGreyV::inv, _WlzCompoundArray::n, _WlzCompoundArray::o, _WlzGreyV::shv, _WlzPixelV::type, _WlzObject::type, _WlzGreyV::ubv, _WlzPixelV::v, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_COMPOUND_ARR_1, WLZ_COMPOUND_ARR_2, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_GREY_INT, WLZ_GREY_SHORT, WLZ_GREY_TAB_RAGR, WLZ_GREY_UBYTE, WlzFreeObj(), WlzGreyIncValuesInDomain(), WlzGreySetValue(), WlzGreyValueTableType(), WlzNewObjectValues(), and WlzUnionN().

WlzObject* WlzOffsetDist ( WlzObject obj0,
WlzObject obj1,
int  maxDist,
WlzErrorNum dstErr 
)

Computes an object with domain and values that are the set of minimum distances between the two given objects. An equidistant boundary is computed between the domains of the two given objects, within maxDist of each object's domain and within the convex hull of the union of the two given object's domains. This function will probably only be useful where one of the objects tends to track the other.

Returns
New object with minimum distances.
Parameters
obj0First given object.
obj1Second given object.
maxDistMaximum distance for offset. This is used to compute a distance object, large distances will significantly increase the processing time. If zero the maximum distance will be determined by the convex hull.
dstErrDestination error pointer, may be NULL.

References _WlzDomain::core, _WlzObject::domain, _WlzGreyV::inv, _WlzPixelV::type, _WlzPixelV::v, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_BO_EQ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_GREY_INT, WLZ_OCTAGONAL_DISTANCE, WLZ_THRESH_HIGH, WlzAssignObject(), WlzConvexHullToObj(), WlzDistanceTransform(), WlzFreeObj(), WlzGreyTemplate(), WlzImageArithmetic(), WlzIntersect2(), WlzMakeEmpty(), WlzMakeSphereObject(), WlzObjToConvexHull(), WlzSetBackground(), WlzStructDilation(), WlzThreshold(), WlzUnionN(), and WlzVolume().

WlzObject* WlzPointsToDomObj ( WlzPoints pnt,
double  scale,
WlzErrorNum dstErr 
)

Creates a domain object which coresponds to the union of the given points.

Returns
New domain object which coresponds to the union of the given points.
Parameters
pntPoint domain.
scaleScale, which if greater than zero is used as the diameter of a circle or sphere centred on each of the points vertices and a multiplier for the point position.
dstErrDestination error poiter, may be NULL.

References _WlzVertexP::d2, _WlzVertexP::d3, _WlzVertex::d3, _WlzVertexP::i2, _WlzVertexP::i3, _WlzVertex::i3, _WlzPoints::points, _WlzPoints::type, _WlzIVertex2::vtX, _WlzDVertex2::vtX, _WlzIVertex3::vtX, _WlzDVertex3::vtX, _WlzIVertex2::vtY, _WlzDVertex2::vtY, _WlzIVertex3::vtY, _WlzDVertex3::vtY, _WlzIVertex3::vtZ, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_ERR_PARAM_TYPE, WLZ_NINT, WLZ_POINTS_2D, WLZ_POINTS_2I, WLZ_POINTS_3D, WLZ_POINTS_3I, WlzFreeObj(), WlzMakeEmpty(), WlzMakeSinglePixelObject(), WlzMakeSphereObject(), and WlzUnion2().

Referenced by WlzDistanceTransform().

WlzPoints* WlzPointsFromDomObj ( WlzObject gvnObj,
double  dMin,
int  useFloatingPoint,
int  voxelScaling,
int  useGrey,
double  gMin,
double  gMax,
double  gGam,
WlzErrorNum dstErr 
)

Finds points which are within the given opjects domain and are seperated by at least the given minimum distance. If the given object's grey values are used, then the probability of a point being placed is proportional to:

\[ \left\{ \begin{array}{ll} 0.0 & g_i < g_{min} \\ frac{(g_i - g_{min})^\gamma}{g_{max} - g_{min}} & g_i > g_{min} \end{array} \right. \]

.

Returns
New points domain or NULL on error.
Parameters
gvnObjGiven spatial domain object.
dMinGiven minimum distance (if less than 1.0 then will be set to 1.0).
useFloatingPointIf non-zero (or voxelScaling is set) the the points will always have double (rather than int) point positions.
voxelScalingUse voxel scaling if non-zero (voxel scaling implies floating point).
useGreyUse grey values.
gMinMinimum grey value.
gMaxMaximum grey value.
gGamGamma for grey value.
dstErrDestination error pointer, may be NULL.

References ALC_ER_NONE, ALC_POINTTYPE_INT, AlcFree(), AlcKDTGetNN(), AlcKDTInsert(), AlcKDTTreeFree(), AlcKDTTreeNew(), AlcRealloc(), AlcVectorExtend(), AlcVectorFree(), AlcVectorItemGet(), AlcVectorNew(), ALG_NINT, AlgRandUniform(), AlgShuffleIdx(), _WlzValues::core, _WlzDomain::core, _WlzVertexP::d2, _WlzVertexP::d3, _WlzGreyV::dbv, _WlzObject::domain, _WlzGreyV::flv, _WlzGreyValueWSpace::gType, _WlzGreyValueWSpace::gVal, _WlzVertexP::i2, _WlzVertexP::i3, _WlzGreyV::inv, _WlzPoints::nPoints, _WlzDomain::p, _WlzPoints::points, _WlzGreyV::rgbv, _WlzGreyV::shv, _WlzPixelV::type, _WlzObject::type, _WlzCoreDomain::type, _WlzGreyV::ubv, _WlzVertexP::v, _WlzPixelV::v, _WlzObject::values, _WlzPlaneDomain::voxel_size, _WlzIVertex2::vtX, _WlzDVertex2::vtX, _WlzIVertex3::vtX, _WlzDVertex3::vtX, _WlzIVertex2::vtY, _WlzDVertex2::vtY, _WlzIVertex3::vtY, _WlzDVertex3::vtY, _WlzIVertex3::vtZ, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_GREY_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_ERR_VALUES_NULL, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_RGBA, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_INTERVALDOMAIN_INTVL, WLZ_INTERVALDOMAIN_RECT, WLZ_PLANEDOMAIN_DOMAIN, WLZ_POINTS_2I, WLZ_POINTS_3D, WLZ_POINTS_3I, WLZ_RGBA_MODULUS, WLZ_THRESH_HIGH, WLZ_THRESH_LOW, WlzAssignObject(), WlzBoundaryDomain(), WlzFreeObj(), WlzGreyValueFreeWSp(), WlzGreyValueGet(), WlzGreyValueMakeWSp(), WlzIsEmpty(), WlzMakeCuboidObject(), WlzMakeMain(), WlzMakePoints(), WlzMakeRectangleObject(), WlzStructErosion(), WlzThreshold(), WlzVerticesFromObj2I(), and WlzVerticesFromObj3I().

Referenced by WlzDGTensorFeatures().

WlzPointValues* WlzPointValuesFromDomObj ( WlzPoints pdm,
WlzObject domObj,
WlzErrorNum dstErr 
)

Creates a new point values using the given points domain and domain object with values. Values are sampled from the domain object using the locations of the points in the points domain.

Returns
New point values or NULL on error.
Parameters
pdmGiven points domain.
domObjGiven domain object with values.
dstErrDestination error pointer, may be NULL.

References AlcFree(), AlcMalloc(), _WlzValues::core, _WlzDomain::core, _WlzVertexP::d2, _WlzVertexP::d3, _WlzGreyP::dbp, _WlzObject::domain, _WlzGreyP::flp, _WlzGreyValueWSpace::gPtr, _WlzGreyValueWSpace::gType, _WlzVertexP::i2, _WlzVertexP::i3, _WlzGreyP::inp, _WlzPoints::nPoints, _WlzPoints::points, _WlzGreyP::rgbp, _WlzGreyP::shp, _WlzObject::type, _WlzPoints::type, _WlzGreyP::ubp, _WlzGreyP::v, _WlzObject::values, _WlzPointValues::values, _WlzIVertex2::vtX, _WlzDVertex2::vtX, _WlzIVertex3::vtX, _WlzDVertex3::vtX, _WlzIVertex2::vtY, _WlzDVertex2::vtY, _WlzIVertex3::vtY, _WlzDVertex3::vtY, _WlzIVertex3::vtZ, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_GREY_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_VALUES_NULL, WLZ_GREY_DOUBLE, WLZ_GREY_ERROR, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_RGBA, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_POINTS_2D, WLZ_POINTS_2I, WLZ_POINTS_3D, WLZ_POINTS_3I, WLZ_VERTEX_D2, WLZ_VERTEX_D3, WLZ_VERTEX_ERROR, WLZ_VERTEX_I2, WLZ_VERTEX_I3, WlzFreePointValues(), WlzGreyValueFreeWSp(), WlzGreyValueGet(), WlzGreyValueMakeWSp(), and WlzMakePointValues().

WlzObject* WlzPointsToMarkers ( WlzPoints pts,
WlzMarkerType  mType,
int  mSz,
WlzErrorNum dstErr 
)

Constructs a domain from the union of marker domains with a marker domain at each of the given point positions.

Returns
New domain object without values.
Parameters
ptsGiven points.
mTypeMarker type.
mSzMarker size. This is the radius of a sphere marker. The marker size is ignored for point markers.
dstErrDestination error pointer, may be NULL.

References _WlzPoints::nPoints, _WlzPoints::points, _WlzPoints::type, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_POINTS_2D, WLZ_POINTS_2I, WLZ_POINTS_3D, WLZ_POINTS_3I, WLZ_VERTEX_D2, WLZ_VERTEX_D3, WLZ_VERTEX_ERROR, WLZ_VERTEX_I2, WLZ_VERTEX_I3, and WlzMakeMarkers().

WlzPoints* WlzPointsDither ( WlzPoints gPts,
WlzDVertex3  dSz,
WlzObject resObj,
WlzErrorNum dstErr 
)

Dithers the vertices of the given points by adding a random displacement within the range -d to +d, where d is the given dither size.

Returns
New points domain.
Parameters
gPtsGiven points.
dSzDither size (z component is not used if points are 2D).
resObjIf non NULL then the dithered points will always fall within the given spatial domain object's domain.
dstErrDestination error pointer, may be NULL.

References AlgRandUniform(), _WlzVertexP::d2, _WlzVertex::d2, _WlzVertexP::d3, _WlzVertex::d3, _WlzVertexP::i2, _WlzVertexP::i3, _WlzPoints::nPoints, _WlzPoints::points, _WlzObject::type, _WlzPoints::type, _WlzVertexP::v, _WlzDVertex2::vtX, _WlzDVertex3::vtX, _WlzDVertex2::vtY, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_ERR_OBJECT_TYPE, WLZ_POINTS_2D, WLZ_POINTS_2I, WLZ_POINTS_3D, WLZ_POINTS_3I, WLZ_VTX_2_ADD, WLZ_VTX_2_COPY, WLZ_VTX_3_ADD, WLZ_VTX_3_COPY, WlzInsideDomain(), and WlzMakePoints().

Referenced by WlzDGTensorFeatures().

int WlzRGBAGreyStats ( WlzObject srcObj,
WlzRGBAColorSpace  colSpc,
WlzGreyType dstGType,
double *  dstMin,
double *  dstMax,
double *  dstSum,
double *  dstSumSq,
double *  dstMean,
double *  dstStdDev,
WlzErrorNum dstErr 
)

Calculates simple quick statistics for the domain object with RGBA values. Each component has its statictics computed and entered into the four double[4] arrays.

Returns
Object area or -1 on error.
Parameters
srcObjGiven object.
colSpcColour space.
dstGTypePointer for grey type.
dstMinArray for the 4 minimum value.
dstMaxArray for the 4 maximum value.
dstSumArray for the 4 sum of values.
dstSumSqArray for the 4 sum of squares of values.
dstMeanArray for the 4 mean values.
dstStdDevArray for the 4 standard deviation values.
dstErrDestination pointer for error, may be NULL.

References _WlzCompoundArray::o, WLZ_ERR_NONE, WLZ_GREY_RGBA, WlzFreeObj(), WlzGreyStats(), and WlzRGBAToCompound().

Referenced by WlzPatchTreeToObject().

WlzErrorNum WlzSampleValuesAndCoords ( WlzObject obj,
WlzGreyType dstGType,
int *  dstNVal,
WlzGreyP dstValP,
WlzVertexP dstCoords,
WlzSampleFn  samFn,
int  samFac 
)

Allocates buffers for both the grey values and the coordinates of the grey values in the given object. On return these buffers contain the sampled object values and the coordinates of the values.

Returns
Parameters
objGiven object.
dstGTypeType of grey value.
dstNValNumber of grey values, also the number of coordinates.
dstValPDestination pointer for the values.
dstCoordsDestination pointer for the coordinates, these are always either WlzIVertex2 or WlzIVertex3 depending on the objects dimension.
samFnSampling function.
samFacSampling factor.

References AlcCalloc(), AlcFree(), AlcMalloc(), AlcRealloc(), _WlzValues::core, _WlzDomain::core, _WlzGreyP::dbp, _WlzObject::domain, _WlzGreyP::flp, _WlzDomain::i, _WlzVertexP::i2, _WlzGreyP::inp, _WlzIntervalWSpace::intrmn, _WlzIntervalDomain::kol1, _WlzIntervalDomain::lastkl, _WlzIntervalWSpace::lftpos, _WlzIntervalDomain::line1, _WlzIntervalWSpace::linpos, _WlzIntervalWSpace::linrmn, _WlzGreyWSpace::pixeltype, _WlzGreyP::rgbp, _WlzIntervalWSpace::rgtpos, _WlzGreyP::shp, _WlzObject::type, _WlzGreyWSpace::u_grintptr, _WlzGreyP::ubp, _WlzObject::values, _WlzIVertex2::vtX, _WlzIVertex2::vtY, WLZ_2D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_EOO, WLZ_ERR_GREY_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_ERR_PARAM_NULL, WLZ_ERR_PARAM_TYPE, WLZ_ERR_VALUES_NULL, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_RGBA, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_SAMPLEFN_MAX, WLZ_SAMPLEFN_MIN, WlzArea(), WlzEndGreyScan(), WlzGreyTypeFromObj(), WlzInitGreyScan(), and WlzNextGreyInterval().

Referenced by WlzScalarFeatures2D().

WlzErrorNum WlzScalarFeatures2D ( WlzObject obj,
int *  dstNFeat,
WlzIVertex2 **  dstFeat,
WlzScalarFeatureType  fType,
WlzThresholdType  thrHL,
WlzPixelV  thrV,
double  filterV,
double  minDist 
)

Finds scalar features within the given object. Where the feature values are all either above or below the given threshold value, depending on the value of thrHL, and the features have the given minimum seperation distance.

Returns
Woolz error code.
    The features are found using the following algorithm:
    <ul>
      <li>
      Compute feature values from given object.
      </li>
      <li>
      Threshold and extract a list of features.
      </li>
      <li>
      Sort the list of features by value.
      </li>
      <li>
      Create a kD-tree.
      </li>
      <li>
      While the list of feature values is not empty.
      <ul>
        <li>
        Remove item from list of features.
        </li>
        <li>
        Find distance to nearest neighbour in the kD-tree.
        </li>
        <li>
        If the distance is greater than the minimum.
        <ul>
          <li>
          Add the feature to the kD-tree.
          </li>
        </ul></li>
      </ul></li>
      <li>
      Output features of the kD-tree.
      </li>
    </ul>
    The cost of this function depends on the threshold value
    and to some extent on the minimum distance.

    If feature values are computed then they are normalised
    using WlzGreyNormalise(), to allow threshold values to be
    set.
Parameters
objGiven object.
fTypeType of feature to find.
thrHLHigh or low feature values.
thrVThreshold feature value.
minDistMinimum distance between features.
dstNFeatDestination pointer for the number of scalar features found.
dstFeatDestination pointer for coordinates of the features found.
filterVFilter value for computing features.
dstFeatDestination pointer for the coordinates of the scalar features.

References ALC_ER_NONE, ALC_POINTTYPE_DBL, AlcFree(), AlcKDTGetNN(), AlcKDTInsert(), AlcKDTTreeFree(), AlcKDTTreeNew(), AlcMalloc(), AlgHeapSortCmpIdxDFn(), AlgHeapSortCmpIdxFFn(), AlgHeapSortCmpIdxIFn(), AlgHeapSortCmpIdxLFn(), AlgHeapSortCmpIdxSFn(), AlgHeapSortCmpIdxUFn(), AlgHeapSortIdx(), AlgHeapSortInvCmpIdxDFn(), AlgHeapSortInvCmpIdxFFn(), AlgHeapSortInvCmpIdxIFn(), AlgHeapSortInvCmpIdxLFn(), AlgHeapSortInvCmpIdxSFn(), AlgHeapSortInvCmpIdxUFn(), _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzVertexP::i2, _WlzGreyP::inp, _WlzObject::type, _WlzVertexP::v, _WlzObject::values, WLZ_2D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_GREY_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_ERR_VALUES_NULL, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_LONG, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_SAMPLEFN_MAX, WLZ_SAMPLEFN_MIN, WLZ_SCALARFEATURE_GRADIENT, WLZ_SCALARFEATURE_VALUE, WLZ_THRESH_HIGH, WLZ_THRESH_LOW, WlzAssignObject(), WlzFreeObj(), WlzGreyModGradient(), WlzGreyNormalise(), WlzSampleValuesAndCoords(), and WlzThreshold().

WlzObject* WlzDGTensorFeatures ( WlzObject mObj,
unsigned int  features,
int  points,
double  dMin,
WlzDVertex3  dither,
WlzDVertex3  smooth,
int  voxScaling,
WlzErrorNum dstErr 
)

Computes features of a deformation gradient tensor field and creates a compound object, each element of which is a required feature of the given deformation gradient field object. The feature object may be either a points object or a spatial domain object as required. See WlzDGTensorSDFeature() which this function calls to compute the feature objects.

Returns
New compound object containing feature objects or NULL on error.
Parameters
mObjGiven deformation gradient field object. This must be a 3D object in which the (tiled) voxel values are each a nine element Jacobian deformation gradient tensor.
featuresMask with required features.
pointsGenerate a points object rather than a field.
dMinIf generating a points the points will have this minimum seperation distance (if less than 1.0 then will be set to 1.0).
ditherIf generating a points object dither the points within this range (no dithering if values are zero). The dithering is always done in unit voxel space.
smoothIf smoothing values are > 0.0 apply a Gaussian smoothing filter with these sigma values to spatial field feature values. There is no smoothing of point feature values.
voxScalingUse voxel size for points objects if non zero.
dstErrDestination error pointer, may be NULL.

References _WlzValues::core, _WlzDomain::core, _WlzVertexP::d3, _WlzTiledValues::dim, _WlzObject::domain, _WlzCompoundArray::n, _WlzPoints::nPoints, _WlzCompoundArray::o, _WlzDomain::p, _WlzPoints::points, _WlzDomain::pts, _WlzValues::t, _WlzObject::type, _WlzCoreDomain::type, _WlzCoreValues::type, _WlzObject::values, _WlzTiledValues::vDim, _WlzPlaneDomain::voxel_size, _WlzTiledValues::vRank, _WlzDVertex3::vtX, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_3D_DOMAINOBJ, WLZ_COMPOUND_ARR_1, WLZ_DGTENSOR_FEATURE_LIMIT, WLZ_DGTENSOR_FEATURE_MASK, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_VALUES_NULL, WLZ_ERR_VALUES_TYPE, WLZ_NULL, WLZ_PLANEDOMAIN_DOMAIN, WLZ_POINTS, WLZ_VTX_3_SQRLEN, WlzAssignDomain(), WlzAssignObject(), WlzDGTensorPDFeature(), WlzDGTensorSDFeature(), WlzFreeDomain(), WlzFreeObj(), WlzGreyTableIsTiled(), WlzMakeCompoundArray(), WlzPointsDither(), and WlzPointsFromDomObj().

WlzObject* WlzDGTensorSDFeature ( WlzObject mObj,
WlzDomain  fDom,
WlzDGTensorFeatureType  feat,
WlzDVertex3  smooth,
WlzErrorNum dstErr 
)

Computes a feature of a deformation gradient tensor field throughout the given 3D spatial domain. This function assumes all input parameters to be valid, when this is not certain use WlzDGTensorFeatures(). The returned object will have it's name property set to an appropriate name for the required feature: WLZ_DGTENSOR_FEATURE_DETJAC ("jacobian"), WLZ_DGTENSOR_FEATURE_EIGENVEC ("eigen vectors") or WLZ_DGTENSOR_FEATURE_EIGENVAL ("eigen values").

Returns
New object containing features or NULL on error.
Parameters
mObjGiven deformation gradient field object. This must be a 3D object in which the (tiled) voxel values are each a nine element Jacobian deformation gradient tensor.
fDomGiven 3D spatial domain (WlzPlaneDomain).
featRequired feature.
smoothIf values are > 0.0 apply a Gaussian smoothing filter with these sigma values to the feature values.
dstErrDestination error pointer, may be NULL.

References ALC_ER_NONE, AlcDLPListEntryAppend(), ALG_MAX, ALG_MIN, AlgMatrixFree(), AlgMatrixRectNew(), _AlgMatrix::core, _WlzValues::core, _WlzProperty::core, _WlzGreyV::dbv, _WlzObject::domain, _WlzPlaneDomain::domains, _WlzDomain::i, _WlzInterval::ileft, _WlzInterval::iright, _WlzIntervalDomain::lastln, _WlzPlaneDomain::lastpl, _WlzIntervalDomain::line1, _WlzIntervalWSpace::linpos, _WlzPropertyList::list, _WlzProperty::name, _WlzDomain::p, _WlzPlaneDomain::plane1, _WlzObject::plist, _AlgMatrix::rect, _WlzPixelV::type, _WlzPixelV::v, _WlzDVertex3::vtX, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_DGTENSOR_FEATURE_DETJAC, WLZ_DGTENSOR_FEATURE_EIGENVAL, WLZ_DGTENSOR_FEATURE_EIGENVEC, WLZ_ERR_EOO, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_PARAM_DATA, WLZ_GREY_DOUBLE, WLZ_RASTERDIR_ILIC, WLZ_TILEDVALUES_TILE_SIZE, WlzAssignPropertyList(), WlzFreeObj(), WlzFreeProperty(), WlzFreePropertyList(), WlzFreePropertyListEntry(), WlzGreyValueFreeWSp(), WlzGreyValueMakeWSp(), WlzInitRasterScan(), WlzIWSpIntersection(), WlzMakeMain(), WlzMakeNameProperty(), WlzMakePropertyList(), WlzMakeTiledValuesObj3D(), WlzNextInterval(), and WlzTensorSmooth().

Referenced by WlzDGTensorFeatures().

WlzObject* WlzDGTensorPDFeature ( WlzObject mObj,
WlzDomain  fDom,
WlzDGTensorFeatureType  feat,
WlzErrorNum dstErr 
)

Computes a feature of a deformation gradient tensor field throughout the given 3D points domain. This function assumes all input parameters to be valid, when this is not certain use WlzDGTensorFeatures().

Returns
New object containing features or NULL on error.
Parameters
mObjGiven deformation gradient field object. This must be a 3D object in which the (tiled) voxel values are each a nine element Jacobian deformation gradient tensor.
fDomGiven 3D points domain (WlzPoints).
featRequired feature.
dstErrDestination error pointer, may be NULL.

References ALC_ER_NONE, AlcCalloc(), AlcDLPListEntryAppend(), AlcFree(), AlgMatrixFree(), AlgMatrixRectNew(), _WlzProperty::core, _WlzVertexP::d3, _WlzGreyValueWSpace::gPtr, _WlzGreyValueWSpace::gType, _WlzPropertyList::list, _WlzPoints::maxPoints, _WlzProperty::name, _WlzPoints::nPoints, _WlzObject::plist, _WlzPoints::points, _WlzValues::pts, _WlzDomain::pts, _WlzObject::values, _WlzDVertex3::vtX, _WlzDVertex3::vtY, _WlzPointValues::vType, _WlzDVertex3::vtZ, WLZ_DGTENSOR_FEATURE_DETJAC, WLZ_DGTENSOR_FEATURE_EIGENVAL, WLZ_DGTENSOR_FEATURE_EIGENVEC, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_PARAM_DATA, WLZ_GREY_DOUBLE, WLZ_POINTS, WlzAssignPropertyList(), WlzFreeObj(), WlzFreeProperty(), WlzFreePropertyList(), WlzFreePropertyListEntry(), WlzGreyValueFreeWSp(), WlzGreyValueGet(), WlzGreyValueMakeWSp(), WlzMakeMain(), WlzMakeNameProperty(), WlzMakePointValues(), and WlzMakePropertyList().

Referenced by WlzDGTensorFeatures().

WlzErrorNum WlzTensorSmooth ( WlzObject obj,
WlzDVertex3  smooth 
)

Smooths the (possibly) non-scalar features of the given object in place by applying a Gaussian filter with the given sigma values (sigma value <~ 0.0 implies no filtering in the corresponding direction.

Returns
Woolz error code.
Parameters
objGiven object with values to smooth.
smoothGaussian filter sigma values.

References ALG_PAD_END, _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzValues::t, _WlzObject::type, _WlzCoreValues::type, _WlzObject::values, _WlzTiledValues::vpe, _WlzDVertex3::vtX, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_VALUES_NULL, WlzFreeObj(), WlzGaussFilter(), WlzGreyTableIsTiled(), WlzGreyTypeFromObj(), WlzTensorGetComponent(), and WlzTensorSetComponent().

Referenced by WlzDGTensorSDFeature().

WlzObject* WlzTensorGetComponent ( WlzObject tObj,
int  cpt,
WlzErrorNum dstErr 
)

Extracts a single value component from a (possibly) non-scalar object and creates an object with a non-tiled value table which is returned. This function may also be used to convert a tiled value object to a non-tiled value object.

Returns
New object containing a single component of the given object.
Parameters
tObjGiven object (possibly) with non-scalar values.
cptThe component index which must be in the range [0-(v - 1)] where v is the values per element.
dstErrDestination error pointer, may be NULL.

References _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzValues::t, _WlzObject::type, _WlzCoreValues::type, _WlzObject::values, _WlzTiledValues::vpe, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_ERR_VALUES_NULL, WLZ_GREY_ERROR, WLZ_GREY_TAB_RAGR, WlzFreeObj(), WlzGetBackground(), WlzGreyTableIsTiled(), WlzGreyTableTypeToGreyType(), WlzGreyValueTableType(), and WlzNewObjectValues().

Referenced by WlzTensorSmooth().

WlzErrorNum WlzTensorSetComponent ( WlzObject tObj,
WlzObject fObj,
int  cpt 
)

Sets a single value component in a (possibly) non-scalar object using scalar values of the second given object.

Returns
Woolz error code.
Parameters
tObjGiven object (possibly) with non-scalar values which is to have component values set.
fObjGiven scalar valued object with values to be transfered to the first given object.
cptThe component index which must be in the range [0-(v - 1)] where v is the values per element of the first object.

References _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzValues::t, _WlzObject::type, _WlzCoreValues::type, _WlzObject::values, _WlzTiledValues::vpe, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_ERR_VALUES_NULL, and WlzGreyTableIsTiled().

Referenced by WlzTensorSmooth().

WlzObject* WlzCMeshDGTensor ( WlzObject cObj,
int  invert,
WlzErrorNum dstErr 
)

Given a conforming mesh transform this function computes the displacement gradient tensor for each of it's valid elements. Given displacement \(\vec{u}(\vec{r})\) with position vector \(\vec{r}\) which maps a point from a space \(\vec{x}\) to a space \(\vec{u}\) the displacement gradient tensor is defined in 3D as

\[ { \newcommand{\pd}[2]{\frac{\partial #1}{\partial #2}} u_{i,j} = \left [ \begin{array}{ccc} \pd{u_0}{x_0} & \pd{u_0}{x_1} & \pd{u_0}{x_2} \\ \pd{u_1}{x_0} & \pd{u_1}{x_1} & \pd{u_1}{x_2} \\ \pd{u_2}{x_0} & \pd{u_2}{x_1} & \pd{u_2}{x_2} \end{array} \right] } \]

with

\[ \Delta r_i = u_{ij} r_j \]

where \(\vec{u} = \left[u_0, u_1, u_2\right]^T\) and \(\Delta \vec{r} = \left[x_0, x_1, x_2\right]^T\). The displacement gradient tensor matrix is just the rotation and independent scaling part of the affine transform that displaces the element.

Returns
Conforming mesh object with tensor values attached to elements or NULL on error.
Parameters
cObjGiven conforming mesh object.
invertInvert if non-zero, by default the tensors are computed for the transform from the mesh to the displaced mesh.
dstErrDestination error pointer, may be NULL.

References _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzObject::type, _WlzObject::values, WLZ_CMESH_2D, WLZ_CMESH_3D, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_UNIMPLEMENTED, and WLZ_ERR_VALUES_NULL.

Referenced by WlzCMeshStrainTensor().

WlzObject* WlzCMeshDGTensorAtPts ( WlzObject cObj,
int  invert,
WlzDVertex3  sd,
int  dither,
WlzErrorNum dstErr 
)

Given a conforming mesh transform this function computes the displacement gradient tensor at regular cartesian grid sample points throughout the mesh. The tensor values at the sample points are computed at each point by computing an iverse distance weighted least squares general affine transform for the ring of nodes surrounding the closest node. See WlzCMeshDGTensor() for the description of the tensor.

Returns
Points object with tensor values at the point locations or NULL on error.
Parameters
cObjGiven conforming mesh object.
invertInvert if non-zero, by default the tensors are computed for the transform from the mesh to the displaced mesh.
sdSample distance.
ditherDither the sample locations.
dstErrDestination error pointer, may be NULL.

References _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzObject::type, _WlzObject::values, _WlzDVertex3::vtX, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_CMESH_2D, WLZ_CMESH_3D, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_ERR_UNIMPLEMENTED, WLZ_ERR_VALUES_NULL, and WLZ_MESH_TOLERANCE.

Referenced by WlzCMeshStrainTensorAtPts().

WlzObject* WlzCMeshStrainTensor ( WlzObject cObj,
int  invert,
WlzErrorNum dstErr 
)

Given a conforming mesh transform this function computes the strain tensor for each of it's valid elements. This function uses WlzCMeshDGTensor() to compute the displacement gradient tensor and the derives the strain tensor \(e_{ij}\) from this using:

\[ e_{ij} = \frac{1}{2} (u_{ij} + u_{ji}) \]

.

Returns
Conforming mesh object with tensor values attached to elements or NULL on error.
Parameters
cObjGiven conforming mesh object.
invertInvert if non-zero, by default the tensors are computed for the transform from the mesh to the displaced mesh.
dstErrDestination error pointer, may be NULL.

References _WlzObject::type, WLZ_CMESH_2D, WLZ_CMESH_3D, WLZ_ERR_NONE, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_UNIMPLEMENTED, WlzCMeshDGTensor(), and WlzFreeObj().

Referenced by WlzCMeshExpansion().

WlzObject* WlzCMeshStrainTensorAtPts ( WlzObject cObj,
int  invert,
WlzDVertex3  sd,
int  dither,
WlzErrorNum dstErr 
)

Given a conforming mesh transform this function computes the displacement gradient tensor at regular cartesian grid sample points throughout the mesh. The tensor values at the sample points are computed using WlzCMeshDGTensorAtPts(). The strain tensor is then computed from the displacement gradient tensor as for WlzCMeshStrainTensor().

Returns
Points object with tensor values or NULL on error.
Parameters
cObjGiven conforming mesh object.
invertInvert if non-zero, by default the tensors are computed for the transform from the mesh to the displaced mesh.
sdSample distance.
ditherDither the sample locations.
dstErrDestination error pointer, may be NULL.

References AlcVectorItemGet(), AlgMatrixLUDetermRaw(), AlgMatrixRSEigen(), AlgRandSeed(), AlgRandZigNormal(), _AlgMatrixRect::array, _WlzIndexedValues::attach, _WlzCMesh3D::bBox, _WlzDomain::cm3, _WlzValues::core, _WlzDomain::core, _WlzVertexP::d3, _WlzGreyP::dbp, _WlzIndexedValues::dim, _WlzObject::domain, _WlzPlaneDomain::domains, _WlzCMeshRes::elm, _WlzGreyP::flp, _WlzGreyValueWSpace::gPtr, _WlzGreyValueWSpace::gType, _WlzCMeshElm3D::idx, _WlzGreyP::inp, _WlzIntervalWSpace::lftpos, _WlzIntervalWSpace::linpos, _WlzGreyP::lnp, _WlzCMeshEntRes::maxEnt, _WlzPoints::nPoints, _WlzDomain::p, _WlzGreyWSpace::pixeltype, _WlzPlaneDomain::plane1, _WlzPoints::points, _WlzCMeshNod3D::pos, _WlzValues::pts, _WlzDomain::pts, _WlzIndexedValues::rank, _AlgMatrix::rect, _WlzCMesh3D::res, _WlzGreyP::rgbp, _WlzIntervalWSpace::rgtpos, _WlzGreyP::shp, _WlzObject::type, _WlzCoreValues::type, _WlzGreyWSpace::u_grintptr, _WlzGreyP::ubp, _WlzVertexP::v, _WlzObject::values, _WlzVoxelValues::values, _WlzPointValues::values, _WlzCMeshEntRes::vec, _WlzValues::vox, _WlzIVertex3::vtX, _WlzDVertex3::vtX, _WlzIVertex3::vtY, _WlzDVertex3::vtY, _WlzIndexedValues::vType, _WlzPointValues::vType, _WlzIVertex3::vtZ, _WlzDVertex3::vtZ, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_CLAMP, WLZ_CLAMP_DOUBLE_TO_GREYP, WLZ_CMESH_2D, WLZ_CMESH_3D, WLZ_CMESH_ELM3D_GET_NODE_0, WLZ_CMESH_ELM3D_GET_NODE_1, WLZ_CMESH_ELM3D_GET_NODE_2, WLZ_CMESH_ELM3D_GET_NODE_3, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_EOO, WLZ_ERR_NONE, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_UNIMPLEMENTED, WLZ_ERR_VALUES_TYPE, WLZ_GREY_DOUBLE, WLZ_GREY_FLOAT, WLZ_GREY_INT, WLZ_GREY_LONG, WLZ_GREY_RGBA, WLZ_GREY_SHORT, WLZ_GREY_UBYTE, WLZ_INDEXED_VALUES, WLZ_MESH_TOLERANCE_SQ, WLZ_POINTS, WLZ_POINTS_3D, WLZ_VALUE_ATTACH_ELM, WLZ_VALUE_ATTACH_NOD, WlzAssignObject(), WlzCMeshDGTensorAtPts(), WlzCMeshElmEnclosingPos3D(), WlzCMeshTransformInvert(), WlzCMeshUpdateBBox3D(), WlzFreeDomain(), WlzFreeIndexedValues(), WlzFreeObj(), WlzFreePointValues(), WlzGeomTetraAffineSolve(), WlzGreyTableIsTiled(), WlzGreyValueFreeWSp(), WlzGreyValueGet(), WlzGreyValueMakeWSp(), WlzIndexedValueGet(), WlzInitGreyScan(), WlzMakeIndexedValues(), WlzMakeMain(), WlzMakePoints(), WlzMakePointValues(), WlzNextGreyInterval(), WlzPointValueGet(), WlzValueCopyGreyToGrey(), _WlzValues::x, _WlzDBox3::xMax, _WlzDBox3::xMin, _WlzDBox3::yMax, _WlzDBox3::yMin, _WlzDBox3::zMax, and _WlzDBox3::zMin.

WlzObject* WlzThinToPoints ( WlzObject gObj,
int  gThin,
int  gStart,
int  gInc,
WlzErrorNum dstErr 
)

Extracts a points object in which the points are the centres of thinned regions of the input domain object. If the object has grey values and gThin is set then the object is erroded by successive thresholding while collecting all disconnected regions or if the object has no values the object is simply labeled to give a collection of disconnected regions. The disconnected regions are then eroded (morphologicaly) again collecting disconnected regions.

Returns
New Woolz points object.
Parameters
gObjGiven domain object, with or without values.
gThinUse object grey values.
gStartInitial threshold value for grey thinning.
gIncIncrement for grey thinning.
dstErrDestination error pointer, may be NUll.

References AlcFree(), AlcHeapEntFree(), AlcHeapFree(), AlcHeapInsertEnt(), AlcHeapNew(), AlcHeapTop(), _WlzValues::core, _WlzDomain::core, _WlzObject::domain, _WlzDomain::i, _WlzVertexP::i2, _WlzVertexP::i3, _WlzGreyV::inv, _AlcHeap::nEnt, _WlzPoints::nPoints, _WlzThinToPointsHeapEntry::obj, _WlzDomain::p, _WlzPoints::points, _WlzThinToPointsHeapEntry::priority, _WlzDomain::pts, _WlzThinToPointsHeapEntry::size, _WlzThinToPointsHeapEntry::thr, _WlzPixelV::type, _WlzObject::type, _WlzVertexP::v, _WlzPixelV::v, _WlzObject::values, _WlzValues::vox, WLZ_26_CONNECTED, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_8_CONNECTED, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_ERR_PARAM_DATA, WLZ_GREY_INT, WLZ_POINTS, WLZ_POINTS_2I, WLZ_POINTS_3I, WLZ_THRESH_HIGH, WLZ_THRESH_LOW, WLZ_VTX_2_NINT, WLZ_VTX_3_NINT, WlzAssignObject(), WlzCentreOfMass2D(), WlzCentreOfMass3D(), WlzErosion(), WlzFreeDomain(), WlzFreeObj(), WlzLabel(), WlzMakeMain(), WlzMakePoints(), WlzStandardIntervalDomain(), WlzStandardPlaneDomain(), WlzThreshold(), and WlzVolume().

WlzVertexP WlzVerticesFromObj ( WlzObject obj,
WlzVertexP dstNr,
int *  dstCnt,
WlzVertexType dstType,
WlzErrorNum dstErr 
)

Allocates a buffer which it fills with the vertices from the given object. If the object is not one of the types that is represented by vertices, eg polylines, boundlists, contours ..., then this may result in a very large number of vertices, with for example one per voxel. Normals will only be allocated and set for objects represented by vertices, eg there will be no normals for voxel based objects.

Returns
Allocated vertices.
Parameters
objGiven polygon domain object.
dstNrDestination ptr for normals. The normals will always be either WlzDVertex2 or WlzDVertex3. May be NULL.
dstCntDestination ptr for the number of vertices. Can NOT be NULL.
dstTypeDestination ptr for the type of vertices. Can NOT be NULL.
dstErrDestination error pointer, may be NULL.

References _WlzDomain::b, _WlzDomain::core, _WlzDomain::ctr, _WlzObject::domain, _WlzVertexP::i2, _WlzVertexP::i3, _WlzContour::model, _WlzDomain::poly, _WlzObject::type, _WlzVertexP::v, WLZ_2D_DOMAINOBJ, WLZ_2D_POLYGON, WLZ_3D_DOMAINOBJ, WLZ_BOUNDLIST, WLZ_CONTOUR, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_VERTEX_I2, WLZ_VERTEX_I3, WlzVerticesFromGM(), WlzVerticesFromObj2I(), and WlzVerticesFromObj3I().

Referenced by WlzGeometryTrackUpAndDown_s(), WlzObjToConvexHull(), WlzRegICPObjs(), WlzRegICPObjsGrd(), WlzRegICPObjWSD2D(), WlzSnapFit(), and WlzVerticesBuildTree().

WlzVertexP WlzVerticesFromObjBnd ( WlzObject obj,
int *  dstCnt,
WlzVertexType dstType,
WlzErrorNum dstErr 
)

Extracts all vertices that lie on the boundary of the given objects domain.

Returns
Allocated vertices.
Parameters
objGiven 2D or 3D domain object.
dstCntDestination ptr for the number of vertices.
dstTypeDestination ptr for the type of vertices, which will always be integer.
dstErrDestination error pointer, may be NULL.

References _WlzDomain::core, _WlzObject::domain, _WlzVertexP::i2, _WlzVertexP::i3, _WlzObject::type, _WlzVertexP::v, WLZ_2D_DOMAINOBJ, WLZ_3D_DOMAINOBJ, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WLZ_VERTEX_I2, WLZ_VERTEX_I3, WlzVerticesFromObjBnd2I(), and WlzVerticesFromObjBnd3I().

WlzErrorNum WlzVerticesFromObjBnd2I ( WlzObject obj,
int *  dstNVtx,
WlzIVertex2 **  dstVtx 
)

Extracts all vertices that lie on the boundary of the given 2D domain object's domain.

Returns
Error code.
Parameters
objGiven 2D domain object.
dstNVtxDestination ptr for the number of vertices, MUST NOT be NULL.
dstVtxDestination ptr for the vertices, MUST NOT be NULL.

References AlcMalloc(), _WlzDomain::b, _WlzObject::domain, _WlzVertexP::i2, _WlzVertexP::v, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_VERTEX_I2, WlzFreeObj(), and WlzObjToBoundary().

Referenced by WlzVerticesFromObjBnd().

WlzErrorNum WlzVerticesFromObjBnd3I ( WlzObject obj,
int *  dstNVtx,
WlzIVertex3 **  dstVtx 
)

Extracts all vertices that lie on the boundary of the given 3D domain object's domain.

Returns
Error code.
Parameters
objGiven 3D domain object.
dstNVtxDestination ptr for the number of vertices, MUST NOT be NULL.
dstVtxDestination ptr for the vertices, MUST NOT be NULL.

References _WlzDomain::core, _WlzObject::domain, _WlzObject::type, WLZ_3D_DOMAINOBJ, WLZ_6_CONNECTED, WLZ_ERR_DOMAIN_NULL, WLZ_ERR_NONE, WLZ_ERR_OBJECT_NULL, WLZ_ERR_OBJECT_TYPE, WlzDiffDomain(), WlzErosion(), WlzFreeObj(), and WlzVerticesFromObj3I().

Referenced by WlzContourRBFBndObj3D(), and WlzVerticesFromObjBnd().

WlzErrorNum WlzVerticesFromObj2I ( WlzObject obj,
int *  dstNVtx,
WlzIVertex2 **  dstVtx 
)

Extracts all vertices that lie within the given 2D domain object's domain.

Returns
Error code.
Parameters
objGiven 2D domain object.
dstNVtxDestination ptr for the number of vertices, MUST NOT be NULL.
dstVtxDestination ptr for the vertices, MUST NOT be NULL.

References AlcMalloc(), _WlzIntervalWSpace::lftpos, _WlzIntervalWSpace::linpos, _WlzIntervalWSpace::rgtpos, WLZ_ERR_DOMAIN_DATA, WLZ_ERR_EOO, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_RASTERDIR_ILIC, WlzArea(), WlzInitRasterScan(), and WlzNextInterval().

Referenced by WlzMarkerLattice(), WlzPointsFromDomObj(), WlzVerticesFromObj(), and WlzVerticesFromObj3I().

WlzVertexP WlzVerticesFromGM ( WlzGMModel model,
WlzVertexP dstNr,
int **  dstVId,
int *  dstCnt,
WlzVertexType dstType,
WlzErrorNum dstErr 
)

Allocates a buffer which it fills with the vertices from a geometric model.

Returns
Allocated vertices.
Parameters
modelGiven geometric model.
dstNrDestination ptr for normals, may be NULL.
dstVIdDestination ptr for the GM vertex indicies, may be NULL.
dstCntDestination ptr for the number of vertices.
dstTypeDestination ptr for the type of vertices.
dstErrDestination error pointer, may be NULL.

References _WlzGMModel::type, _WlzVertexP::v, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_GMMOD_2D, WLZ_GMMOD_2I, WLZ_GMMOD_2N, WLZ_GMMOD_3D, WLZ_GMMOD_3I, and WLZ_GMMOD_3N.

Referenced by WlzDistMetricDirGM(), WlzDistMetricGM(), WlzMatchICPCtr(), and WlzVerticesFromObj().

WlzVertexP WlzDVerticesFromGM ( WlzGMModel model,
int *  dstCnt,
WlzVertexType dstType,
WlzErrorNum dstErr 
)

Allocates a buffer which it fills with either 2D or 3D double precission vertices from the geometric model. The indicies of the vertices in the buffer are the same as the indices of the vertices in the model.

Returns
Allocated vertices.
Parameters
modelGiven geometric model.
dstCntDestination ptr for the number of vertices.
dstTypeDestination ptr for the type of vertices.
dstErrDestination error pointer, may be NULL.

References AlcMalloc(), AlcVectorItemGet(), _WlzVertexP::d2, _WlzVertexP::d3, _WlzGMVertex::geo, _WlzGMResource::numElm, _WlzGMResource::numIdx, _WlzGMModel::res, _WlzGMModel::type, _WlzVertexP::v, _WlzGMResource::vec, _WlzGMModelR::vertex, _WlzGMVertexGU::vg2D, _WlzGMVertexGU::vg2I, _WlzGMVertexGU::vg3D, _WlzGMVertexGU::vg3I, _WlzIVertex2::vtX, _WlzDVertex2::vtX, _WlzIVertex3::vtX, _WlzDVertex3::vtX, _WlzGMVertexG2I::vtx, _WlzGMVertexG2D::vtx, _WlzGMVertexG3I::vtx, _WlzGMVertexG3D::vtx, _WlzIVertex2::vtY, _WlzDVertex2::vtY, _WlzIVertex3::vtY, _WlzDVertex3::vtY, _WlzIVertex3::vtZ, _WlzDVertex3::vtZ, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_GMMOD_2D, WLZ_GMMOD_2I, WLZ_GMMOD_2N, WLZ_GMMOD_3D, WLZ_GMMOD_3I, WLZ_GMMOD_3N, WLZ_VERTEX_D2, and WLZ_VERTEX_D3.

Referenced by WlzGMFilterGeomLPLM().

WlzVertexP WlzDVerticesFromCMesh ( WlzCMeshP  mesh,
int *  dstCnt,
WlzVertexType dstType,
int  skip,
WlzErrorNum dstErr 
)

Allocates a buffer which it fills with either 2D or 3D double precission vertices from the conforming mesh. The indicies of the vertices in the buffer are the same as the indices of the vertices in the model unless the skip non-valid nodes flag is set..

Returns
Allocated vertices.
Parameters
meshGiven mesh.
dstCntDestination ptr for the number of vertices.
dstTypeDestination ptr for the type of vertices.
skipSkip non-valid nodes if non-zero.
dstErrDestination error pointer, may be NULL.

References _WlzVertexP::d2, _WlzVertexP::d3, _WlzCMeshP::m2, _WlzCMeshP::m2d5, _WlzCMeshP::m3, _WlzCMesh2D::type, _WlzVertexP::v, _WlzCMeshP::v, WLZ_CMESH_2D, WLZ_CMESH_2D5, WLZ_CMESH_3D, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_NONE, WLZ_VERTEX_D2, and WLZ_VERTEX_D3.

Referenced by WlzCMeshLPFilterLM().

int WlzVertexQSortFnI2 ( void *  p0,
void *  p1 
)

Function for qsort() to sort WlzIVertex2 vertices so that they have increasing Y then X.

Returns
Signed sort value.
Parameters
p0First vertex pointer.
p1Second vertex pointer.

References _WlzIVertex2::vtX, and _WlzIVertex2::vtY.

int WlzVertexQSortFnI3 ( void *  p0,
void *  p1 
)

Function for qsort() to sort WlzIVertex3 vertices so that they have increasing z then Y then X.

Returns
Signed sort value.
Parameters
p0First vertex pointer.
p1Second vertex pointer.

References _WlzIVertex3::vtX, _WlzIVertex3::vtY, and _WlzIVertex3::vtZ.

int WlzVertexHeapSortIdxFnI2 ( void *  data,
int *  idx,
int  id0,
int  id1 
)

Function for AlgHeapSortIdx() to sort WlzIVertex2 vertices so that they have increasing Y then X.

Returns
Signed sort value.
Parameters
dataVertex array.
idxVertex index array.
id0First index.
id1Second index.

References _WlzIVertex2::vtX, and _WlzIVertex2::vtY.

int WlzVertexHeapSortIdxFnI3 ( void *  data,
int *  idx,
int  id0,
int  id1 
)

Function for AlgHeapSortIdx() to sort WlzIVertex3 vertices so that they have increasing Z then Y then X.

Returns
Signed sort value.
Parameters
dataVertex array.
idxVertex index array.
id0First index.
id1Second index.

References _WlzIVertex3::vtX, _WlzIVertex3::vtY, and _WlzIVertex3::vtZ.

Referenced by WlzConvexHullFromVtx3().

int WlzVertexHeapSortIdxFnD2 ( void *  data,
int *  idx,
int  id0,
int  id1 
)

Function for AlgHeapSortIdx() to sort WlzDVertex2 vertices so that they have increasing Z then Y then X.

Returns
Signed sort value.
Parameters
dataVertex array.
idxVertex index array.
id0First index.
id1Second index.

References _WlzDVertex2::vtX, and _WlzDVertex2::vtY.

int WlzVertexHeapSortIdxFnD3 ( void *  data,
int *  idx,
int  id0,
int  id1 
)

Function for AlgHeapSortIdx() to sort WlzDVertex3 vertices so that they have increasing Z then Y then X.

Returns
Signed sort value.
Parameters
dataVertex array.
idxVertex index array.
id0First index.
id1Second index.

References AlcFree(), AlcMalloc(), AlcVectorItemGet(), _WlzGMVertexGU::core, _WlzVertexP::d2, _WlzVertexP::d3, _WlzGMVertexT::diskT, _WlzGMVertex::diskT, _WlzBoundList::down, _WlzVertexP::f2, _WlzGMVertex::geo, _WlzVertexP::i2, _WlzVertexP::i3, _WlzGMVertex::idx, _WlzCMeshNod2D::idx, _WlzCMeshNod2D5::idx, _WlzCMeshNod3D::idx, _WlzCMeshEntRes::maxEnt, _WlzGMVertexT::next, _WlzGMEdgeT::next, _WlzBoundList::next, _WlzCMeshRes::nod, _WlzGMVertexG2N::nrm, _WlzGMResource::numElm, _WlzCMeshEntRes::numEnt, _WlzPolygonDomain::nvertices, _WlzGMVertexT::parent, _WlzBoundList::poly, _WlzCMeshNod2D::pos, _WlzCMeshNod2D5::pos, _WlzCMeshNod3D::pos, _WlzGMVertexT::prev, _WlzGMEdgeT::prev, _WlzGMModel::res, _WlzCMesh2D::res, _WlzCMesh2D5::res, _WlzCMesh3D::res, _WlzGMCore::type, _WlzGMModel::type, _WlzPolygonDomain::type, _WlzKrigModelFn::type, _WlzVertexP::v, _WlzGMResource::vec, _WlzCMeshEntRes::vec, _WlzGMDiskT::vertex, _WlzGMModelR::vertex, _WlzGMDiskT::vertexT, _WlzGMEdgeT::vertexT, _WlzGMVertexGU::vg2D, _WlzGMVertexGU::vg2I, _WlzGMVertexGU::vg2N, _WlzGMVertexGU::vg3D, _WlzGMVertexGU::vg3I, _WlzIVertex2::vtX, _WlzDVertex2::vtX, _WlzDVertex3::vtX, _WlzGMVertexG2I::vtx, _WlzGMVertexG2D::vtx, _WlzGMVertexG3I::vtx, _WlzGMVertexG3D::vtx, _WlzPolygonDomain::vtx, _WlzIVertex2::vtY, _WlzDVertex2::vtY, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_ERR_DOMAIN_TYPE, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_GMELM_VERTEX_G2N, WLZ_GMMOD_2D, WLZ_GMMOD_2I, WLZ_GMMOD_2N, WLZ_GMMOD_3I, WLZ_POLYGON_DOUBLE, WLZ_POLYGON_FLOAT, WLZ_POLYGON_INT, WLZ_VERTEX_D2, WLZ_VERTEX_D3, WLZ_VERTEX_F2, WLZ_VERTEX_I2, WLZ_VERTEX_I3, WLZ_VTX_2_ADD, WLZ_VTX_2_LENGTH, WLZ_VTX_2_SCALE, WLZ_VTX_2_SUB, WlzGeomTriangleSnArea2(), WlzGMVertexNormal3D(), WlzValueCopyDVertexToDVertex(), WlzValueCopyFVertexToFVertex(), and WlzValueCopyIVertexToIVertex().

Referenced by WlzConvexHullFromVtx3().

AlcKDTTree* WlzVerticesBuildTree ( WlzVertexType  vType,
int  nV,
WlzVertexP  vtx,
int *  shfBuf,
WlzErrorNum dstErr 
)

Allocates and populates a k-D tree from the given vertices. The vertices are either WlzDVertex2 orWlzDVertex3.

Returns
Woolz error code
Parameters
vTypeType of vertices.
nVNumber of vertices.
vtxThe vertices.
shfBufWorkspace with at least nV ints used to shuffle vertices for randomized input to the K-D tree.
dstErrDestination error pointer, may be NULL.

References ALC_ER_NONE, ALC_POINTTYPE_DBL, AlcFree(), AlcKDTInsert(), AlcKDTTreeNew(), AlgShuffleIdx(), _WlzVertexP::d2, _WlzVertexP::d3, getopt(), _AlcKDTNode::idx, main(), optarg, opterr, optind, optopt, _WlzVertexP::v, _WlzDVertex2::vtX, _WlzDVertex3::vtX, _WlzDVertex2::vtY, _WlzDVertex3::vtY, _WlzDVertex3::vtZ, WLZ_ERR_MEM_ALLOC, WLZ_ERR_NONE, WLZ_ERR_PARAM_TYPE, WLZ_ERR_WRITE_EOF, WLZ_VERTEX_D2, WLZ_VERTEX_D3, WlzAssignObject(), WlzFreeObj(), WlzReadObj(), and WlzVerticesFromObj().

Referenced by WlzDistMetricDirVertex2D(), WlzDistMetricDirVertex3D(), WlzGeometryTrackUpAndDown_s(), WlzMatchICPCtr(), and WlzRegICPVerticesWSD2D().