Module: Pore_Statistics

Description:

In an image considered as a label field, where each grey level (of integer type) corresponds to a 6-connected group of pixels to characterise (except for those with value 0), this module gives in the form of a spreadsheet various values associated with each. The spreadsheet contains, in column order :

Label: Value (or greylevel) of the pixels corresponding to the pore
Number of pixels: Number of pixels in that pore (effectively, pore volume)
On border: Set to 1 if the pore touches the image border
Mean x,y,z-coordinate: Average coordinates of the pore pixels (effectively, barycentre)
Surface faces: Number of pixel faces at the pore surface (i.e. not shared with another pixel face of the same pore)
Connection faces: Number of pixel faces shared with other pores (i.e. excluding 0-valued pixels)
a,b,c: Eigen values of the inertia matrix (used to characterise pore excentricity)
(Ax,Ay,Az), (Bx,By,Bz), (Cx,Cy,Cz): Eigen vectors of the inertia matrix (to give directions of excentricity)
Number of separations: Number of contacts (i.e. connected components of pixel faces) with other pores. NOTE: Two pores can have several contacts.
Mean separation surface: Average surface area of one contact (i.e. (Surface faces)/(Number of separations))
Mean separation equivalent radius: As it suggests, i.e. sqrt((Mean separation surface)/PI)

Illustration of module's apllication: the top image shows a surface rendering of a labelfield representing a pore decomposition, where each color corresponds to a different label, and the bottom spreadsheet is the result.

Connections:

Image

[required]
The input image, of type HxUniformScalarField3 comes in through this port.

Ports:

Action button

Push the first button to start the computation.

Extract warning pores

Creates a second output image containing pores that have more that one 6-connected component.

Commands:

Additional options can be accessed when typing in the console Pore_Statistics COMMAND_NAME. Typing the command again usually reverts back to original settings.

`verbose`

Displays timing information after the computation, along with labels of pores having more than one 6-connected component. Retype to hide info.

`create`

Runs the computation. Returns the name of the output, so it can be used in a script, such as set RESULT [Pore_Statistics create].