Measure object features
#include "dip_measurement.h"
dip_Error dip_Measure ( measurement, featureID, featureParams, objectID, objectIm, intensityIm, connectivity, physDims )
objectIm: integer
intensityIm: integer, float
The Measure function is the top-level function of DIPlib's measurement library. This function performs measurements of the objects in the specified objectIm image. The measurements to be performed are specified by the featureID array of measurement function IDs. If featureParams is non-zero, its size should equal that of featureID. Although the current implementation of Measure does not make use of this argument, future versions will pass the data pointers of the featureParams to the corresponding measurement functions. featureParams should be set to zero for now.
The list of object IDs on which the measurements have to be performed is specified by objectID. If it is zero, Measure will call GetObjectLabels to obtain a list of all non-zero values in objectIm. The objectID values should be unequal to zero.
The state of measurement should be raw (see MeasurementNew), since Measure will forge the measurement data structure by calling MeasurementForge.
The intensityIm image defines the pixel intensity of the objects, whose shape is defined by objectIm. If none of the measurements specified in featureID require the grey-value image, it can be set to NULL.
The physDims parameter defines the physical dimensions of the pixel sizes and pixel intensity. See PhysicalDimensionsNew for more information.
| Data type | Name | Description |
| dip_Measurement | measurement | Measurement data structure |
| dip_IntegerArray | featureID | Array of measurement function IDs |
| dip_VoidPointerArray | featureParams (0) | Set to zero |
| dip_IntegerArray | objectID (0) | Array of Object IDs |
| dip_Image | objectIm | Image containing object IDs, i.e. object labels |
| dip_Image | intensityIm | Intensity image |
| dip_int | connectivity | Connectivity of object's contour pixels, see The connectivity parameter |
| dip_PhysicalDimensions | physDims | Structure specifying the physical dimensions of the image pixels |
Label, ObjectToMeasurement, MeasurementToImage, MeasurementToHistogram, MeasurementWrite, MeasurementNew, MeasurementFree, MeasurementIsValid
FeatureAnisotropy2D, FeatureBendingEnergy, FeatureCenter, FeatureChainCodeBendingEnergy, FeatureConvexArea, FeatureConvexPerimeter, FeatureConvexity, FeatureDimension, FeatureExcessKurtosis, FeatureFeret, FeatureGinertia, FeatureGmu, FeatureGravity, FeatureInertia, FeatureLongestChaincodeRun, FeatureMass, FeatureMaxVal, FeatureMaximum, FeatureMean, FeatureMinVal, FeatureMinimum, FeatureMu, FeatureOrientation2D, FeatureP2A, FeaturePerimeter, FeatureRadius, FeatureShape, FeatureSize, FeatureSkewness, FeatureStdDev, FeatureSum, FeatureSurfaceArea