Module: Compute REV ()

Description:

A representative elementary volume (REV) is a subvolume representative of a larger one for a given property. The script focuses on the following property: the amount of a given label within the REV. A good REV should be as close as possible to the label distribution of the input volume. To find a good REV, the script extracts multiple subvolume (internally using a VolumeEdit tool so the REV shape is a cylinder) based on different user defined criterion, and for each one calculates the amount (volume fraction) of each label. More precisely the script outputs 2 spreadsheets. One presenting:

• REV id
• Diameter
• Height
• Center
• Amount of porosity (defined as a special label)
• Amount of connected porosity
• Amount of other labels

The second one summarizing properties per volume size with following column:

• Diameter
• Height
• Mean porosity
• Standard deviation porosity
• Mean connected porosity
• Mean standard deviation connected porosity

In a final step, the user selects the best REV to extract the data and access it from the data tree. The REV is extracted from the input data: a complete or cropped version of the REV is available.

Connections:

Data [required]
Image data to extract REV from, the data must be a label

Mask [optionnal]
Masked area to extract REV from (default is full volume)

Ports:

num_vol
Number of REV to compute

size option
Define size option for all REV or define only minimum size and maximum size (in which case the sizes are randomly picked within the minimum and maximum bounding box).

position option
Set REV position within input volume anywhere (random) or only at the top and the bottom of the input (Z plane).

porosity label
Define which label is porosity

num_pos
Number of position per REV (so the number of REV calculated equals num_vol * num_pos)

top and bottom
Only appears if the random option was previously checked. This option defines if the REV cylinder (top and bottom of the cylinder) is aligned vertically or horizontally.

height_vn
Size of the height (v1 is minimum size, v2 maximum size if min/max was previously checked). The size is entered in the current unit. The console outputs the height and the diameter of the current input. The size entered here cannot be larger than the size printed in the console.

diameter_vn
Size of the diameter (v1 is minimum size, v2 maximum size if min/max was previously checked) The size is entered in the current unit. The console outputs the height and the diameter of the current input. The size entered here cannot be larger than the size printed in the console.

num_id
REV id (corresponds to id in spreadsheet) to extract