GLRLM#

class zrad.radiomics.glrlm.GLRLM(aggr_dim, aggr_method, slice_weight=False, slice_median=False)[source]#

Grey level run length matrix features.

GLRLM features describe contiguous runs of equal discretized grey level along predefined directions. They capture coarse versus fine texture and low- versus high-grey-level run patterns.

Parameters:

  • aggr_dim ({"2D", "2.5D", "3D"}) – Spatial dimensionality used to build run length matrices.

  • aggr_method ({"MERG", "AVER", "SLICE_MERG", "DIR_MERG"}) – Strategy used to combine matrices across directions and slices.

  • slice_weight (bool, default=False) – Weight slice-wise averages by slice ROI voxel count.

  • slice_median (bool, default=False) – Aggregate slice-wise values by median instead of mean.

Methods

calculate_features(discretized_image_array)

Calculate GLRLM features for a prepared discretized intensity array.

get_feature_names()

Return the GLRLM feature names produced by this calculator.

get_params()

Return the configuration parameters of this GLRLM calculator.
GLRLM.calculate_features(discretized_image_array)[source]#

Calculate GLRLM features for a prepared discretized intensity array.

Parameters:

discretized_image_array (numpy.ndarray) – Prepared discretized intensity array with ROI voxels represented by integer grey levels and voxels outside the ROI set to NaN.

Returns:

Mapping of GLRLM feature names to calculated values.

Return type:

dict

GLRLM.get_feature_names()[source]#

Return the GLRLM feature names produced by this calculator.

Returns:

Feature names defined for the GLRLM family.

Return type:

list of str

GLRLM.get_params()[source]#

Return the configuration parameters of this GLRLM calculator.

Returns:

Parameter names mapped to their configured values.

Return type:

dict