IntensityStatistics

Computes basic statistics of an image.

Access to parameter description

For an introduction:

section Image Analysis
section Image Statistics

This algorithm gives some image characteristics such as the total number of pixels, the minimum and maximum gray levels, the mean, the range, the standard deviation, the kurtosis, and the skewness factors.

$range = Max ~-~ Min ~+~ 1$
$\mbox{k-}th~ central~ moment = \mu_k = \sum{(I(i,j)-mean)}^{k}$
$stddev = \sigma=\sqrt{\mu_2}$
$skewness = \frac{\mu_3}{\sigma^3}$
$kurtosis = (\frac{\mu_4}{\sigma^4})-3$

The Skewness is the degree of asymmetry of a distribution.

If the distribution has a tail length smaller than the maximum, the function has negative skewness.
Otherwise, it has positive skewness.

The Kurtosis is the degree of peakedness of a distribution, also called the "excess" or "excess coefficient". Kurtosis is a normalized form of the fourth central moment of a distribution.

See also

See related example

GlobalAnalysis

Function Syntax

This function returns outputMeasurement.

// Function prototype
StatisticsMsr::Ptr
intensityStatistics( std::shared_ptr< iolink::ImageView > inputImage,
                     IntensityStatistics::RangeMode rangeMode,
                     iolink::Vector2i32 intensityInputRange,
                     StatisticsMsr::Ptr outputMeasurement = NULL );

This function returns outputMeasurement.

// Function prototype.
intensity_statistics( input_image,
                      range_mode = IntensityStatistics.RangeMode.MIN_MAX,
                      intensity_input_range = [0, 255],
                      output_measurement = None )

This function returns outputMeasurement.

// Function prototype.
public static StatisticsMsr
IntensityStatistics( IOLink.ImageView inputImage,
                     IntensityStatistics.RangeMode rangeMode = ImageDev.IntensityStatistics.RangeMode.MIN_MAX,
                     int[] intensityInputRange = null,
                     StatisticsMsr outputMeasurement = null );

Class Syntax

// Command constructor.
IntensityStatistics();

/// Gets the inputImage parameter.
/// The input image. It can be grayscale, color, multi-channel, or time series.
std::shared_ptr< iolink::ImageView > inputImage() const;
/// Sets the inputImage parameter.
/// The input image. It can be grayscale, color, multi-channel, or time series.
void setInputImage( std::shared_ptr< iolink::ImageView > inputImage );

/// Gets the rangeMode parameter.
/// The way to determine the input intensity range within which statistics are computed.
IntensityStatistics::RangeMode rangeMode() const;
/// Sets the rangeMode parameter.
/// The way to determine the input intensity range within which statistics are computed.
void setRangeMode( const IntensityStatistics::RangeMode& rangeMode );

/// Gets the intensityInputRange parameter.
/// The input intensity range [a,b] within which the statistics are computed. This parameter is ignored if the range mode is set to MIN_MAX.
iolink::Vector2i32 intensityInputRange() const;
/// Sets the intensityInputRange parameter.
/// The input intensity range [a,b] within which the statistics are computed. This parameter is ignored if the range mode is set to MIN_MAX.
void setIntensityInputRange( const iolink::Vector2i32& intensityInputRange );

/// Gets the outputMeasurement parameter.
/// The output measurement results.
StatisticsMsr::Ptr outputMeasurement() const;


// Method to launch the command.
void execute();

# Property of the inputImage parameter.
IntensityStatistics.input_image
# Property of the rangeMode parameter.
IntensityStatistics.range_mode
# Property of the intensityInputRange parameter.
IntensityStatistics.intensity_input_range
# Property of the outputMeasurement parameter.
IntensityStatistics.output_measurement

// Method to launch the command.
execute()

// Command constructor.
IntensityStatistics()

// Property of the inputImage parameter.
IntensityStatistics.inputImage
// Property of the rangeMode parameter.
IntensityStatistics.rangeMode
// Property of the intensityInputRange parameter.
IntensityStatistics.intensityInputRange
// Property of the outputMeasurement parameter.
IntensityStatistics.outputMeasurement

// Method to launch the command.
Execute()

Parameters

Parameter Name

Description

Type

Supported Values

Default Value

inputImage

The input image. It can be grayscale, color, multi-channel, or time series.

Image

Binary, Label, Grayscale or Multispectral

nullptr

rangeMode

The way to determine the input intensity range within which statistics are computed.

MIN_MAX	The measurements are computed between the minimum and the maximum of the image.
OTHER	The measurements are computed between user-defined bounds [a,b].

Enumeration

MIN_MAX

intensityInputRange

The input intensity range [a,b] within which the statistics are computed. This parameter is ignored if the range mode is set to MIN_MAX.

Vector2i32

Any value

{0, 255}

outputMeasurement

The output measurement results.

StatisticsMsr

nullptr

Object Examples

std::shared_ptr< iolink::ImageView > polystyrene = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "polystyrene.tif" );

IntensityStatistics intensityStatisticsAlgo;
intensityStatisticsAlgo.setInputImage( polystyrene );
intensityStatisticsAlgo.setRangeMode( IntensityStatistics::RangeMode::MIN_MAX );
intensityStatisticsAlgo.setIntensityInputRange( {0, 255} );
intensityStatisticsAlgo.execute();

std::cout << "pixelCount: " << intensityStatisticsAlgo.outputMeasurement()->pixelCount( 0 , 0 ) ;

polystyrene = ioformat.read_image(imagedev_data.get_image_path("polystyrene.tif"))

intensity_statistics_algo = imagedev.IntensityStatistics()
intensity_statistics_algo.input_image = polystyrene
intensity_statistics_algo.range_mode = imagedev.IntensityStatistics.MIN_MAX
intensity_statistics_algo.intensity_input_range = [0, 255]
intensity_statistics_algo.execute()

print( "pixelCount: ", str( intensity_statistics_algo.output_measurement.pixel_count( 0 , 0 ) ) )

ImageView polystyrene = ViewIO.ReadImage( @"Data/images/polystyrene.tif" );

IntensityStatistics intensityStatisticsAlgo = new IntensityStatistics
{
    inputImage = polystyrene,
    rangeMode = IntensityStatistics.RangeMode.MIN_MAX,
    intensityInputRange = new int[]{0, 255}
};
intensityStatisticsAlgo.Execute();

Console.WriteLine( "pixelCount: " + intensityStatisticsAlgo.outputMeasurement.pixelCount( 0 , 0 ) );

Function Examples

std::shared_ptr< iolink::ImageView > polystyrene = ioformat::readImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "polystyrene.tif" );

auto result = intensityStatistics( polystyrene, IntensityStatistics::RangeMode::MIN_MAX, {0, 255} );

std::cout << "pixelCount: " << result->pixelCount( 0 , 0 ) ;

polystyrene = ioformat.read_image(imagedev_data.get_image_path("polystyrene.tif"))

result = imagedev.intensity_statistics( polystyrene, imagedev.IntensityStatistics.MIN_MAX, [0, 255] )

print( "pixelCount: ", str( result.pixel_count( 0 , 0 ) )  )

ImageView polystyrene = ViewIO.ReadImage( @"Data/images/polystyrene.tif" );

StatisticsMsr result = Processing.IntensityStatistics( polystyrene, IntensityStatistics.RangeMode.MIN_MAX, new int[]{0, 255} );

Console.WriteLine(  "pixelCount: " + result.pixelCount( 0 , 0 )  );

IntensityStatistics

- Function Syntax

+ Class Syntax

Parameters

Object Examples

Function Examples

Function Syntax

Class Syntax