Processing math: 100%
ImageDev

ObjectLinearDensity3d

Measures the structure linear density inside the volume of interest of a three-dimensional binary image.

Access to parameter description

For an introduction: The structure linear density represents the number of traversals across a structure made per unit length on a linear path.

Plate, rod, and sphere model definitions of object linear density Dn rely on the corresponding average object thickness Th values: Dn=VTh×TV where TV is total volume (volume of the mask if provided, else volume of the image bounding box) and V is the object volume.

See also

Function Syntax

This function returns the outputMeasurement output parameter. 
// Function prototype.
ObjectLinearDensityMsr::Ptr
objectLinearDensity3d( std::shared_ptr< iolink::ImageView > inputImage,
                       std::shared_ptr< iolink::ImageView > inputMaskImage,
                       ObjectLinearDensity3d::Model model,
                       ObjectLinearDensityMsr::Ptr outputMeasurement = NULL );

Class Syntax

Parameters

Class Name ObjectLinearDensity3d

Parameter Name Description Type Supported Values Default Value
input
inputImage
The 3D binary input image. Image Binary nullptr
input
inputMaskImage
The binary image defining the volume of interest. The measurement is computed from voxels having a value of 1 in this image. If it equals null, the computation is performed from all voxels of the input image. It must have same dimensions as the input image. Image Binary nullptr
input
model
The structure model used to compute the measurement.
PARALLEL_PLATE_MODEL The computation uses a parallel plate model.
CYLINDER_ROD_MODEL The computation uses a cylinder rod model.
SPHERE_MODEL The computation uses a sphere model.
Enumeration PARALLEL_PLATE_MODEL
output
outputMeasurement
The output measurement result. ObjectLinearDensityMsr nullptr

Object Examples

auto foam_sep = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam_sep.vip" );

ObjectLinearDensity3d objectLinearDensity3dAlgo;
objectLinearDensity3dAlgo.setInputImage( foam_sep );
objectLinearDensity3dAlgo.setInputMaskImage( foam_sep );
objectLinearDensity3dAlgo.setModel( ObjectLinearDensity3d::Model::PARALLEL_PLATE_MODEL );
objectLinearDensity3dAlgo.execute();

std::cout << "density: " << objectLinearDensity3dAlgo.outputMeasurement()->density( ) ;

Function Examples

auto foam_sep = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam_sep.vip" );

auto result = objectLinearDensity3d( foam_sep, foam_sep, ObjectLinearDensity3d::Model::PARALLEL_PLATE_MODEL );

std::cout << "density: " << result->density( ) ;