``Region properties'' - find properties of a segmented volume

VFX name:

iRegionProps

IMPROMPTU Equivalent:

Region_properties

purpose:

This function will calculate various properties for a segmented volume, and (optionally) will compute gray-level characteristics as well. The computed properties are:

1.

Total volume of the object (in voxels).

2.

The minimum-bounding cuboid of the volume.

3.

The centroid of the volume.

4.

The normalized central moments up to order 2 or 3.

(Optional) Gray-Level Characteristics

1.

Minimum and maximum voxel intensities.

2.

Mean voxel intensity and standard deviation.

3.

10% and 90% intensity levels.

input:

An 8-bit binary image representing the segmented object, and an optional 8-bit gray-scale image of the original volume.

output:

A text file named ``propXXXXXX'', containing all of the computed information.

parameters:

The default parameters menu is

segmented_vol = 0
grayscale_volume = 0
object = 0
calc_stats = yes
calc_moments = no
outfile = NOT_SPECIFIED

The ``object'' parameter is necessary if there is more than one segmented object in the volume. If this argument is set to zero, any non-zero voxels in the segmented volume will be considered part of the object being analyzed. If this argument is not zero, only voxels with intensities matching this value will be considered.
The ``calc_stats'' parameter toggles between calculating gray-scale properties. If this is set to no, then the gray-scale volume specified will be ignored.
The ``calc_moments'' parameter, if set to no, will keep the routine from calculating moments higher than order two. If yes, then moments up to order 3 will be calculated.

comments:

1.

Not calculating higher-order moments speeds this function up significantly.

2.

The original image is not modified by this function.