Measurement module
The measurement infrastructure and functionality.
The dip::MeasurementTool
class provides the main interface to the
functionality in this module. Quantification results are encapsulated in
an object of the dip::Measurement
class.
Namespaces
 namespace dip::
Feature  Contains classes that implement the measurement features.
Classes

struct dip::
FeretValues  Contains the various Feret diameters as returned by
dip::ConvexHull::Feret
anddip::ChainCode::Feret
. 
class dip::
RadiusValues  Holds the various output values of the
dip::Polygon::RadiusStatistics
function. 
template<typename T>struct dip::
Vertex  Encodes a location in a 2D image.

template<typename T>struct dip::
BoundingBox  Encodes a bounding box in a 2D image by the top left and bottom right corners (both coordinates included in the box).

class dip::
CovarianceMatrix  A 2D covariance matrix for computation with 2D vertices.

struct dip::
Polygon  A polygon with floatingpoint vertices.

struct dip::
ConvexHull  A convex hull is a convex polygon. It can be constructed from a simple
dip::Polygon
, and is guaranteed clockwise. 
struct dip::
ChainCode  The contour of an object as a chain code sequence.

struct dip::
Feature:: Information  Information about a measurement feature

struct dip::
Feature:: ValueInformation  Information about a measurement value, one of the components of a feature

class dip::
Feature:: abstractBase  The pure virtual base class for all measurement features.

class dip::
Feature:: abstractLineBased  The pure virtual base class for all linebased measurement features.

class dip::
Feature:: abstractImageBased  The pure virtual base class for all imagebased measurement features.

class dip::
Feature:: abstractChainCodeBased  The pure virtual base class for all chaincode–based measurement features.

class dip::
Feature:: abstractPolygonBased  The pure virtual base class for all polygonbased measurement features.

class dip::
Feature:: abstractConvexHullBased  The pure virtual base class for all convexhull–based measurement features.

class dip::
Feature:: abstractComposite  The pure virtual base class for all composite measurement features.

class dip::
Measurement  Contains measurement results, as obtained through
dip::MeasurementTool::Measure
. 
class dip::
MeasurementTool  Performs measurements on images.
Aliases

using dip::
VertexFloat = dip::Vertex  A vertex with floatingpoint coordinates.

using dip::
VertexInteger = dip::Vertex  A vertex with integer coordinates

using dip::
BoundingBoxFloat = dip::BoundingBox  A bounding box with floatingpoint coordinates.

using dip::
BoundingBoxInteger = dip::BoundingBox  A bounding box with integer coordinates.

using dip::
ChainCodeArray = std::vector<ChainCode>  A collection of object contours.

using dip::
Feature:: = std::vector<Information>InformationArray  Information about the known measurement features

using dip::
Feature:: = std::vector<ValueInformation>ValueInformationArray  Information about the values of a measurement feature, or all values of all measurement features
in a
dip::Measurement
object. 
using dip::
ObjectIdToIndexMap = tsl::robin_map<dip::uint, dip::uint>  Maps object IDs to object indices
Enums

enum class dip::
Feature:: : uint8{ LINE_BASED, IMAGE_BASED, CHAINCODE_BASED, POLYGON_BASED, CONVEXHULL_BASED, COMPOSITE }Type  The types of measurement features
Functions

template<typename T>auto dip::
Norm (dip::Vertex const& v) > dip::dfloat  The norm of the vector
v
. 
template<typename T>auto dip::
NormSquare (dip::Vertex const& v) > dip::dfloat  The square of the norm of the vector
v
. 
template<typename T>auto dip::
Distance (dip::Vertex const& v1, dip::Vertex const& v2) > dip::dfloat  The norm of the vector
v2v1
. 
template<typename T>auto dip::
DistanceSquare (dip::Vertex const& v1, dip::Vertex const& v2) > dip::dfloat  The square norm of the vector
v2v1
. 
template<typename T>auto dip::
Angle (dip::Vertex const& v1, dip::Vertex const& v2) > dip::dfloat  The angle of the vector
v2v1
. 
template<typename T>auto dip::
CrossProduct (dip::Vertex const& v1, dip::Vertex const& v2) > dip::dfloat  Compute the z component of the cross product of vectors
v1
andv2
. 
template<typename T>auto dip::
ParallelogramSignedArea (dip::Vertex const& v1, dip::Vertex const& v2, dip::Vertex const& v3) > dip::dfloat  Compute the z component of the cross product of vectors
v2v1
andv3v1
. 
template<typename T>auto dip::
TriangleArea (dip::Vertex const& v1, dip::Vertex const& v2, dip::Vertex const& v3) > dip::dfloat  Compute the area of the triangle formed by vertices
v1
,v2
andv3
. 
template<typename T>auto dip::
TriangleHeight (dip::Vertex const& v1, dip::Vertex const& v2, dip::Vertex const& v3) > dip::dfloat  Compute the height of the triangle formed by vertices
v1
,v2
andv3
, withv3
the tip. 
auto dip::
GetImageChainCodes (dip::Image const& labels, std::vector<LabelType> const& objectIDs = {}, dip::uint connectivity = 2) > dip::ChainCodeArray  Returns the set of chain codes sequences that encode the contours of the given objects in a labeled image.

auto dip::
GetSingleChainCode (dip::Image const& labels, dip::UnsignedArray const& startCoord, dip::uint connectivity = 2) > dip::ChainCode  Returns the chain codes sequence that encodes the contour of one object in a binary or labeled image.

void dip::
ObjectToMeasurement (dip::Image const& label, dip::Image& out, dip::Measurement::IteratorFeature const& featureValues)  Paints each object with the selected measurement feature values.

void dip::
MeasurementWriteCSV (dip::Measurement const& measurement, dip::String const& filename, dip::StringSet const& options = {})  Writes a
dip::Measurement
structure to a CSV file. 
auto dip::
Minimum (dip::Measurement::IteratorFeature const& featureValues) > dip::Measurement::ValueType  Returns the smallest feature value in the first column of
featureValues
. 
auto dip::
Maximum (dip::Measurement::IteratorFeature const& featureValues) > dip::Measurement::ValueType  Returns the largest feature value in the first column of
featureValues
. 
auto dip::
Percentile (dip::Measurement::IteratorFeature const& featureValues, dip::dfloat percentile) > dip::Measurement::ValueType  Returns the
percentile
feature value in the first column offeatureValues
. 
auto dip::
Median (dip::Measurement::IteratorFeature const& featureValues) > dip::dfloat  Returns the median feature value in the first column of
featureValues
. 
auto dip::
Mean (dip::Measurement::IteratorFeature const& featureValues) > dip::dfloat  Returns the mean feature value in the first column of
featureValues
. 
auto dip::
MaximumAndMinimum (dip::Measurement::IteratorFeature const& featureValues) > dip::MinMaxAccumulator  Returns the maximum and minimum feature values in the first column of
featureValues
. 
auto dip::
Quartiles (dip::Measurement::IteratorFeature const& featu) > dip::QuartilesResult  Computes the minimum, lower quartile (25th percentile), median (50th percentile), upper quartile (75th percentile), and maximum.

auto dip::
SampleStatistics (dip::Measurement::IteratorFeature const& featureValues) > dip::StatisticsAccumulator  Returns the first four central moments of the feature values in the first column of
featureValues
. 
auto dip::
ObjectMinimum (dip::Measurement::IteratorFeature const& featureValues) > dip::uint  Returns the object ID with the smallest feature value in the first column of
featureValues
. 
auto dip::
ObjectMaximum (dip::Measurement::IteratorFeature const& featureValues) > dip::uint  Returns the object ID with the largest feature value in the first column of
featureValues
.
Operators

template<typename T>auto dip::
operator== (dip::Vertex v1, dip::Vertex v2) > bool  Compare two vertices.

template<typename T>auto dip::
operator+ (dip::Vertex lhs, dip::Vertex const& rhs) > dip::Vertex  Add two vertices together, with identical types.

auto dip::
operator+ (dip::VertexFloat lhs, dip::VertexInteger const& rhs) > dip::VertexFloat  Add two vertices together, where the LHS is floatingpoint and the RHS is integer.

auto dip::
operator+ (dip::VertexInteger const& lhs, dip::VertexFloat rhs) > dip::VertexFloat  Add two vertices together, where the LHS is integer and the RHS is floatingpoint.

template<typename T>auto dip::
operator (dip::Vertex lhs, dip::Vertex const& rhs) > dip::Vertex  Subtract two vertices from each other.

auto dip::
operator (dip::VertexFloat lhs, dip::VertexInteger const& rhs) > dip::VertexFloat  Subtract two vertices from each other, where the LHS is floatingpoint and the RHS is integer.

auto dip::
operator (dip::VertexInteger const& lhs, dip::VertexFloat const& rhs) > dip::VertexFloat  Subtract two vertices from each other, where the LHS is integer and the RHS is floatingpoint.

template<typename T, typename S>auto dip::
operator+ (dip::Vertex v, S t) > dip::Vertex  Add a vertex and a constant.

template<typename T, typename S>auto dip::
operator (dip::Vertex v, S t) > dip::Vertex  Subtract a vertex and a constant.

template<typename T>auto dip::
operator* (dip::Vertex v, dip::dfloat s) > dip::Vertex  Multiply a vertex and a constant, scaling isotropically.

template<typename T>auto dip::
operator* (dip::Vertex lhs, dip::Vertex const& rhs) > dip::Vertex  Multiply a vertex by another vertex, scaling anisotropically.

auto dip::
operator* (dip::VertexFloat lhs, dip::VertexInteger const& rhs) > dip::VertexFloat  Multiply a vertex by another vertex, scaling anisotropically, where the LHS is floatingpoint and the RHS is integer.

auto dip::
operator* (dip::VertexInteger const& lhs, dip::VertexFloat const& rhs) > dip::VertexFloat  Multiply a vertex by another vertex, scaling anisotropically, where the LHS is integer and the RHS is floatingpoint.

template<typename T>auto dip::
operator/ (dip::Vertex v, dip::dfloat s) > dip::Vertex  Divide a vertex by a constant, scaling isotropically.

template<typename T>auto dip::
operator/ (dip::Vertex lhs, dip::Vertex const& rhs) > dip::Vertex  Divide a vertex by another vertex, scaling anisotropically.

auto dip::
operator/ (dip::VertexFloat lhs, dip::VertexInteger const& rhs) > dip::VertexFloat  Divide a vertex by another vertex, scaling anisotropically, where the LHS is floatingpoint and the RHS is integer.

auto dip::
operator/ (dip::VertexInteger const& lhs, dip::VertexFloat const& rhs) > dip::VertexFloat  Divide a vertex by another vertex, scaling anisotropically, where the LHS is integer and the RHS is floatingpoint.

auto dip::
operator+ (dip::Measurement const& lhs, dip::Measurement const& rhs) > dip::Measurement  The
+
operator merges twodip::Measurement
objects. 
auto dip::
operator<< (std::ostream& os, dip::Measurement const& measurement) > std::ostream&  You can output a
dip::Measurement
tostd::cout
or any other stream to produce a humanreadable representation of the tabular data in it. 
auto dip::
operator== (dip::Measurement::IteratorFeature const& featureValues, dip::Measurement::ValueType value) > dip::LabelMap  Selects objects where the first element of
featureValues
is equal tovalue
. 
auto dip::
operator!= (dip::Measurement::IteratorFeature const& featureValues, dip::Measurement::ValueType value) > dip::LabelMap  Selects objects where the first element of
featureValues
is unequal tovalue
. 
auto dip::
operator> (dip::Measurement::IteratorFeature const& featureValues, dip::Measurement::ValueType value) > dip::LabelMap  Selects objects where the first element of
featureValues
is greater thanvalue
. 
auto dip::
operator>= (dip::Measurement::IteratorFeature const& featureValues, dip::Measurement::ValueType value) > dip::LabelMap  Selects objects where the first element of
featureValues
is not smaller thanvalue
. 
auto dip::
operator< (dip::Measurement::IteratorFeature const& featureValues, dip::Measurement::ValueType value) > dip::LabelMap  Selects objects where the first element of
featureValues
is smaller thanvalue
. 
auto dip::
operator<= (dip::Measurement::IteratorFeature const& featureValues, dip::Measurement::ValueType value) > dip::LabelMap  Selects objects where the first element of
featureValues
is not greater thanvalue
.
Class documentation
struct dip::FeretValues
#include "diplib/chain_code.h"
Contains the various Feret diameters as returned by dip::ConvexHull::Feret
and dip::ChainCode::Feret
.
Variables  

dip::dfloat maxDiameter  The maximum Feret diameter 
dip::dfloat minDiameter  The minimum Feret diameter 
dip::dfloat maxPerpendicular 
The Feret diameter perpendicular to minDiameter

dip::dfloat maxAngle 
The angle at which maxDiameter was measured

dip::dfloat minAngle 
The angle at which minDiameter was measured

Alias documentation
using dip::VertexFloat = dip::Vertex
#include "diplib/chain_code.h"
A vertex with floatingpoint coordinates.
using dip::VertexInteger = dip::Vertex
#include "diplib/chain_code.h"
A vertex with integer coordinates
using dip::BoundingBoxFloat = dip::BoundingBox
#include "diplib/chain_code.h"
A bounding box with floatingpoint coordinates.
using dip::BoundingBoxInteger = dip::BoundingBox
#include "diplib/chain_code.h"
A bounding box with integer coordinates.
using dip::ChainCodeArray = std::vector<ChainCode>
#include "diplib/chain_code.h"
A collection of object contours.
using dip::Feature::InformationArray = std::vector<Information>
#include "diplib/measurement.h"
Information about the known measurement features
using dip::Feature::ValueInformationArray = std::vector<ValueInformation>
#include "diplib/measurement.h"
Information about the values of a measurement feature, or all values of all measurement features
in a dip::Measurement
object.
using dip::ObjectIdToIndexMap = tsl::robin_map<dip::uint, dip::uint>
#include "diplib/measurement.h"
Maps object IDs to object indices
Enum documentation
enum class dip::Feature::Type : uint8
#include "diplib/measurement.h"
The types of measurement features
Enumerators  

LINE_BASED = 0 
The feature is derived from dip::Feature::LineBased

IMAGE_BASED = 1 
The feature is derived from dip::Feature::ImageBased

CHAINCODE_BASED = 2 
The feature is derived from dip::Feature::ChainCodeBased

POLYGON_BASED = 3 
The feature is derived from dip::Feature::PolygonBased

CONVEXHULL_BASED = 4 
The feature is derived from dip::Feature::ConvexHullBased

COMPOSITE = 5 
The feature is derived from dip::Feature::Composite

Function documentation
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::Norm (dip::Vertex const& v)
The norm of the vector v
.
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::NormSquare (dip::Vertex const& v)
The square of the norm of the vector v
.
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::Distance (dip::Vertex const& v1,
dip::Vertex const& v2)
The norm of the vector v2v1
.
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::DistanceSquare (dip::Vertex const& v1,
dip::Vertex const& v2)
The square norm of the vector v2v1
.
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::Angle (dip::Vertex const& v1,
dip::Vertex const& v2)
The angle of the vector v2v1
.
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::CrossProduct (dip::Vertex const& v1,
dip::Vertex const& v2)
Compute the z component of the cross product of vectors v1
and v2
.
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::ParallelogramSignedArea (dip::Vertex const& v1,
dip::Vertex const& v2,
dip::Vertex const& v3)
Compute the z component of the cross product of vectors v2v1
and v3v1
.
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::TriangleArea (dip::Vertex const& v1,
dip::Vertex const& v2,
dip::Vertex const& v3)
Compute the area of the triangle formed by vertices v1
, v2
and v3
.
#include "diplib/chain_code.h"
template<typename T>
dip::dfloat
dip::TriangleHeight (dip::Vertex const& v1,
dip::Vertex const& v2,
dip::Vertex const& v3)
Compute the height of the triangle formed by vertices v1
, v2
and v3
, with v3
the tip.
dip::ChainCodeArray
dip::GetImageChainCodes (dip::Image const& labels,
std::vector<LabelType> const& objectIDs = {},
dip::uint connectivity = 2)
#include "diplib/chain_code.h"
Returns the set of chain codes sequences that encode the contours of the given objects in a labeled image.
Note that only the first closed contour for each label is found; if an object has multiple connected components, only part of it is found. The chain code traces the outer perimeter of the object, holes are ignored.
objectIDs
is a list with object IDs present in the labeled image. If an empty array is given, all objects in
the image are used. For the meaning of connectivity
, see Connectivity.
labels
is a labeled image, and must be scalar and of an unsigned integer type.
dip::ChainCode
dip::GetSingleChainCode (dip::Image const& labels,
dip::UnsignedArray const& startCoord,
dip::uint connectivity = 2)
#include "diplib/chain_code.h"
Returns the chain codes sequence that encodes the contour of one object in a binary or labeled image.
Note that only one closed contour is found; if the object has multiple connected components, only part of it is found. The chain code traces the outer perimeter of the object, holes are ignored.
startCoord
is the 2D coordinates of a boundary pixel. If it points to a zerovalued pixel or a pixel not on
the boundary of an object, an exception will be thrown.
For the meaning of connectivity
, see Connectivity.
labels
is a labeled or binary image, and must be scalar and of a binary or unsigned integer type.
void
dip::ObjectToMeasurement (dip::Image const& label,
dip::Image& out,
dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Paints each object with the selected measurement feature values.
The input featureValues
is a view over a specific feature in a dip::Measurement
object.
It is assumed that that measurement object was obtained through measurement of the input label
image.
To obtain such a view, use the measurement’s []
indexing with a feature name. Alternatively, use the
dip::Measurement::FeatureValuesView
method to select an arbitrary subset of feature value columns.
The dip::Measurement::IteratorFeature::Subset
method can be used for the same purpose.
If the selected feature has more than one value, then out
will be a vector image with as many tensor elements
as values are in the feature.
out
will be of type DT_SFLOAT
. To change the data type, set the data type of out
and set its protect
flag before calling this function:
dip::Image out; out.SetDataType( dip::DT_UINT32 ); out.Protect(); ObjectToMeasurement( label, out, featureValues );
void
dip::MeasurementWriteCSV (dip::Measurement const& measurement,
dip::String const& filename,
dip::StringSet const& options = {})
#include "diplib/measurement.h"
Writes a dip::Measurement
structure to a CSV file.
The CSV (comma separated values) file is a generic container for tabular data, and can be read in just about any graphing and statistics software package.
The file written contains three header rows, followed by one row per object. The three header rows contain the feature names, the value names, and the value units. The feature names, of which there typically are fewer than columns, are interspersed with empty cells to line them up with the first column for the feature. For example:
ObjectID, Size, Center, , Feret, , , , , , dim0, dim1, Max, Min, PerpMin, MaxAng, MinAng , um^2, um, um, um, um, um, rad, rad 1, 397.0, 20.06, 12.98, 34.99, 16.43, 34.83, 2.111, 3.588 2, 171.0, 63.13, 4.123, 20.22, 11.00, 20.00, 2.993, 4.712 3, 628.0, 108.4, 12.47, 32.20, 26.00, 28.00, 2.202, 0.000 4, 412.0, 154.5, 9.561, 26.40, 22.00, 23.00, 2.222, 4.712
options
is one or more of the following values:
"unicode"
: The units will be written using unicode strings. By default, only ASCII characters are used."simple"
: There will only be a single header line, combining the three strings as follows:"Feature value (units)"
. For example:"Size (um^2)"
,"Feret Max (um)"
, etc.
dip::Measurement::ValueType
dip::Minimum (dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Returns the smallest feature value in the first column of featureValues
.
The input featureValues
is a view over a specific feature in a dip::Measurement
object. Only the
first value of the feature is used. For features with multiple values, select a value using the
dip::Measurement::IteratorFeature::Subset
method, or pick a column in the dip::Measurement
object
directly using dip::Measurement::FeatureValuesView
.
dip::Measurement::ValueType
dip::Maximum (dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Returns the largest feature value in the first column of featureValues
.
The input featureValues
is a view over a specific feature in a dip::Measurement
object. Only the
first value of the feature is used. For features with multiple values, select a value using the
dip::Measurement::IteratorFeature::Subset
method, or pick a column in the dip::Measurement
object
directly using dip::Measurement::FeatureValuesView
.
dip::Measurement::ValueType
dip::Percentile (dip::Measurement::IteratorFeature const& featureValues,
dip::dfloat percentile)
#include "diplib/measurement.h"
Returns the percentile
feature value in the first column of featureValues
.
Percentiles are always one of the values in the set. The nearest value to a given partition is used, rather than interpolate as classically done.
The input featureValues
is a view over a specific feature in a dip::Measurement
object. Only the
first value of the feature is used. For features with multiple values, select a value using the
dip::Measurement::IteratorFeature::Subset
method, or pick a column in the dip::Measurement
object
directly using dip::Measurement::FeatureValuesView
.
dip::dfloat
dip::Median (dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Returns the median feature value in the first column of featureValues
.
The input featureValues
is a view over a specific feature in a dip::Measurement
object. Only the
first value of the feature is used. For features with multiple values, select a value using the
dip::Measurement::IteratorFeature::Subset
method, or pick a column in the dip::Measurement
object
directly using dip::Measurement::FeatureValuesView
.
dip::dfloat
dip::Mean (dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Returns the mean feature value in the first column of featureValues
.
The input featureValues
is a view over a specific feature in a dip::Measurement
object. Only the
first value of the feature is used. For features with multiple values, select a value using the
dip::Measurement::IteratorFeature::Subset
method, or pick a column in the dip::Measurement
object
directly using dip::Measurement::FeatureValuesView
.
dip::MinMaxAccumulator
dip::MaximumAndMinimum (dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Returns the maximum and minimum feature values in the first column of featureValues
.
The input featureValues
is a view over a specific feature in a dip::Measurement
object. Only the
first value of the feature is used. For features with multiple values, select a value using the
dip::Measurement::IteratorFeature::Subset
method, or pick a column in the dip::Measurement
object
directly using dip::Measurement::FeatureValuesView
.
dip::QuartilesResult
dip::Quartiles (dip::Measurement::IteratorFeature const& featu)
#include "diplib/measurement.h"
Computes the minimum, lower quartile (25th percentile), median (50th percentile), upper quartile (75th percentile), and maximum.
Percentiles are always one of the values in the set. The nearest value to a given partition is used, rather than interpolate as classically done.
The input featureValues
is a view over a specific feature in a dip::Measurement
object. Only the
first value of the feature is used. For features with multiple values, select a value using the
dip::Measurement::IteratorFeature::Subset
method, or pick a column in the dip::Measurement
object
directly using dip::Measurement::FeatureValuesView
.
dip::StatisticsAccumulator
dip::SampleStatistics (dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Returns the first four central moments of the feature values in the first column of featureValues
.
The input featureValues
is a view over a specific feature in a dip::Measurement
object. Only the
first value of the feature is used. For features with multiple values, select a value using the
dip::Measurement::IteratorFeature::Subset
method, or pick a column in the dip::Measurement
object
directly using dip::Measurement::FeatureValuesView
.
dip::uint
dip::ObjectMinimum (dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Returns the object ID with the smallest feature value in the first column of featureValues
.
Same as dip::Minimum
, but returns the Object ID instead of
the feature value.
dip::uint
dip::ObjectMaximum (dip::Measurement::IteratorFeature const& featureValues)
#include "diplib/measurement.h"
Returns the object ID with the largest feature value in the first column of featureValues
.
Same as dip::Maximum
, but returns the Object ID instead of
the feature value.
#include "diplib/chain_code.h"
template<typename T>
bool
dip::operator== (dip::Vertex v1,
dip::Vertex v2)
Compare two vertices.
#include "diplib/chain_code.h"
template<typename T>
dip::Vertex
dip::operator+ (dip::Vertex lhs,
dip::Vertex const& rhs)
Add two vertices together, with identical types.
dip::VertexFloat
dip::operator+ (dip::VertexFloat lhs,
dip::VertexInteger const& rhs)
#include "diplib/chain_code.h"
Add two vertices together, where the LHS is floatingpoint and the RHS is integer.
dip::VertexFloat
dip::operator+ (dip::VertexInteger const& lhs,
dip::VertexFloat rhs)
#include "diplib/chain_code.h"
Add two vertices together, where the LHS is integer and the RHS is floatingpoint.
#include "diplib/chain_code.h"
template<typename T>
dip::Vertex
dip::operator (dip::Vertex lhs,
dip::Vertex const& rhs)
Subtract two vertices from each other.
dip::VertexFloat
dip::operator (dip::VertexFloat lhs,
dip::VertexInteger const& rhs)
#include "diplib/chain_code.h"
Subtract two vertices from each other, where the LHS is floatingpoint and the RHS is integer.
dip::VertexFloat
dip::operator (dip::VertexInteger const& lhs,
dip::VertexFloat const& rhs)
#include "diplib/chain_code.h"
Subtract two vertices from each other, where the LHS is integer and the RHS is floatingpoint.
#include "diplib/chain_code.h"
template<typename T, typename S>
dip::Vertex
dip::operator+ (dip::Vertex v,
S t)
Add a vertex and a constant.
#include "diplib/chain_code.h"
template<typename T, typename S>
dip::Vertex
dip::operator (dip::Vertex v,
S t)
Subtract a vertex and a constant.
#include "diplib/chain_code.h"
template<typename T>
dip::Vertex
dip::operator* (dip::Vertex v,
dip::dfloat s)
Multiply a vertex and a constant, scaling isotropically.
#include "diplib/chain_code.h"
template<typename T>
dip::Vertex
dip::operator* (dip::Vertex lhs,
dip::Vertex const& rhs)
Multiply a vertex by another vertex, scaling anisotropically.
dip::VertexFloat
dip::operator* (dip::VertexFloat lhs,
dip::VertexInteger const& rhs)
#include "diplib/chain_code.h"
Multiply a vertex by another vertex, scaling anisotropically, where the LHS is floatingpoint and the RHS is integer.
dip::VertexFloat
dip::operator* (dip::VertexInteger const& lhs,
dip::VertexFloat const& rhs)
#include "diplib/chain_code.h"
Multiply a vertex by another vertex, scaling anisotropically, where the LHS is integer and the RHS is floatingpoint.
#include "diplib/chain_code.h"
template<typename T>
dip::Vertex
dip::operator/ (dip::Vertex v,
dip::dfloat s)
Divide a vertex by a constant, scaling isotropically.
#include "diplib/chain_code.h"
template<typename T>
dip::Vertex
dip::operator/ (dip::Vertex lhs,
dip::Vertex const& rhs)
Divide a vertex by another vertex, scaling anisotropically.
dip::VertexFloat
dip::operator/ (dip::VertexFloat lhs,
dip::VertexInteger const& rhs)
#include "diplib/chain_code.h"
Divide a vertex by another vertex, scaling anisotropically, where the LHS is floatingpoint and the RHS is integer.
dip::VertexFloat
dip::operator/ (dip::VertexInteger const& lhs,
dip::VertexFloat const& rhs)
#include "diplib/chain_code.h"
Divide a vertex by another vertex, scaling anisotropically, where the LHS is integer and the RHS is floatingpoint.
dip::Measurement
dip::operator+ (dip::Measurement const& lhs,
dip::Measurement const& rhs)
#include "diplib/measurement.h"
The +
operator merges two dip::Measurement
objects.
The resulting object has, as feature set, the union of the two input feature sets, and as object IDs,
the union of the two object ID lists. That is, the output might have more columns or more rows
(i.e. more objects) than the two input objects, depending on the overlaps between the two. If both
features and cells differ between the two, then cells with unknown data are filled with NaN. If both
objects contain the same feature for the same measurement, and the value is NaN for one, the other value
is picked. If both have a nonNaN value, the one of the lhs
argument is picked (values are never
actually added together!). This process insures that it is possible to add multiple sets of measurements
(across different objects and different features) together, without worrying about the order that
they are added together:
dip::Image label1 = ... // one image with objects 110 dip::Image label2 = ... // one image with objects 1120 auto set1 = measurementTool.Measure( label1, {}, {'Size','Center'} ); auto set2 = measurementTool.Measure( label2, {}, {'Size','Center'} ); auto set3 = measurementTool.Measure( label1, {}, {'Feret','Radius'} ); auto set4 = measurementTool.Measure( label2, {}, {'Feret','Radius'} ); auto sum1 = set1 + set2; // Size and Center features for objects 120 auto sum2 = set1 + set3; // Size, Center, Feret and Radius features for objects 110 auto sumA = (set1 + set2) + (set3 + set4); // All features for all objects auto sumB = (set1 + set3) + (set2 + set4); // Idem auto sumC = set1 + set2 + set3 + set4; // Idem auto sumD = set1 + set4 + set3 + set2; // Idem
std::ostream&
dip::operator<< (std::ostream& os,
dip::Measurement const& measurement)
#include "diplib/measurement.h"
You can output a dip::Measurement
to std::cout
or any other stream to produce a humanreadable
representation of the tabular data in it.
dip::LabelMap
dip::operator== (dip::Measurement::IteratorFeature const& featureValues,
dip::Measurement::ValueType value)
#include "diplib/measurement.h"
Selects objects where the first element of featureValues
is equal to value
.
dip::LabelMap
dip::operator!= (dip::Measurement::IteratorFeature const& featureValues,
dip::Measurement::ValueType value)
#include "diplib/measurement.h"
Selects objects where the first element of featureValues
is unequal to value
.
dip::LabelMap
dip::operator> (dip::Measurement::IteratorFeature const& featureValues,
dip::Measurement::ValueType value)
#include "diplib/measurement.h"
Selects objects where the first element of featureValues
is greater than value
.
dip::LabelMap
dip::operator>= (dip::Measurement::IteratorFeature const& featureValues,
dip::Measurement::ValueType value)
#include "diplib/measurement.h"
Selects objects where the first element of featureValues
is not smaller than value
.
dip::LabelMap
dip::operator< (dip::Measurement::IteratorFeature const& featureValues,
dip::Measurement::ValueType value)
#include "diplib/measurement.h"
Selects objects where the first element of featureValues
is smaller than value
.
dip::LabelMap
dip::operator<= (dip::Measurement::IteratorFeature const& featureValues,
dip::Measurement::ValueType value)
#include "diplib/measurement.h"
Selects objects where the first element of featureValues
is not greater than value
.