CentroidPathTortuosity3d
Computes the tortuosity of a path formed by the centroids on each plan along the Z axis of a three-dimensional binary image.
Access to parameter description
Tortuosity is the ratio of the length of a curve to the distance between the ends of it along the Z axis. In this algorithm, the distance between the ends of curve is given by the number of planes along the Z axis.
This algorithm first computes the centroid c(i) of each plane z(i) of the image. Then it computes the path length through the centroids l=Σd(i) and then divides it by the height traveled along the Z axis: H=z(n)−z(0) .
Figure 1. Centroid path tortuosity computation
See also
Access to parameter description
Tortuosity is the ratio of the length of a curve to the distance between the ends of it along the Z axis. In this algorithm, the distance between the ends of curve is given by the number of planes along the Z axis.
This algorithm first computes the centroid c(i) of each plane z(i) of the image. Then it computes the path length through the centroids l=Σd(i) and then divides it by the height traveled along the Z axis: H=z(n)−z(0) .
Figure 1. Centroid path tortuosity computation
Function Syntax
This function returns outputMeasurement.
// Function prototype
CentroidTortuosity3dMsr::Ptr centroidPathTortuosity3d( std::shared_ptr< iolink::ImageView > inputBinaryImage, CentroidTortuosity3dMsr::Ptr outputMeasurement = NULL );
Class Syntax
Parameters
| Parameter Name | Description | Type | Supported Values | Default Value | |
|---|---|---|---|---|---|
 |
inputBinaryImage |
The input 3D binary image. | Image | Binary | nullptr |
 |
outputMeasurement |
The output measurement result. | CentroidTortuosity3dMsr | nullptr | |
Object Examples
auto foam_sep = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam_sep.vip" ); CentroidPathTortuosity3d centroidPathTortuosity3dAlgo; centroidPathTortuosity3dAlgo.setInputBinaryImage( foam_sep ); centroidPathTortuosity3dAlgo.execute(); std::cout << "tortuosityFactor: " << centroidPathTortuosity3dAlgo.outputMeasurement()->tortuosityFactor( ) ;
Function Examples
auto foam_sep = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam_sep.vip" ); auto result = centroidPathTortuosity3d( foam_sep ); std::cout << "tortuosityFactor: " << result->tortuosityFactor( ) ;