MimStatCalculate

This function calculates a variety of statistics for the pixels that satisfy the specified condition in the source image. Results are stored in the specified statistic result buffer.

This function calculates both statistics and co-occurrence statistics. Before using this function to calculate statistics ( M_STAT...), you must enable the statistical operation to perform, using MimControl() and specify the condition (if any) using M_CONDITION. Co-occurrence statistics ( M_STAT_GLCM...) do not require a condition.

You can read the statistics from the result buffer using, MimGetResult(), MimGetResult1d() MimGetResult2d(), respective to the statistical operation performed. You can also draw statistical results, using MimDraw().

Once the statistic image processing context is configured, preprocess the context and result buffer by calling MimStatCalculate() with M_PREPROCESS. If the preprocess operation is not done explicitly (using M_PREPROCESS), it will be done when MimStatCalculate() is first called. When preprocessing explicitly, the source image buffer can be set to M_NULL if you set the size of the target area ( MimControl() with M_SOURCE_SIZE_X and M_SOURCE_SIZE_Y) to M_DEFAULT. Note that providing the source image buffer better optimizes future calls.

When dealing with a cumulative statistics context, you can remove the calculated statistics associated with the specified source image from the results buffer by call MimStatCalculate() with M_REMOVE. To reset the results generated from finding the extremes of each pixel's value in a cumulative statistics context (such as, M_STAT_MIN), use M_RESET_EXTREMES.

With both the cumulative statistics context or the Statistics image processing context, additional information (such as specific calculated values) can be overridden (by performing the operation again). To reset all the results in the result buffer, free it using MimFree(), and then a allocate new result buffer using MimAllocResult() with M_STATISTICS_RESULT.

The statistics result buffer of a cumulative statistics context can contain the results of an operation performed cumulatively on numerous images by calling this function multiple times, each time using a different source image buffer. Note that in this case, the source images should have the same dimensions, otherwise unpredictable results could occur.

You can limit some of this function's results to a region of an image buffer using a region of interest (ROI) set using MbufSetRegion(). The ROI must be defined in raster format (M_RASTER or M_VECTOR_AND_RASTER). An error is generated if the ROI is only in vector format (M_VECTOR). If you specify multiple image buffers with an ROI, results are limited to the portion of the ROIs that intersect. Note that not all statistics operations support ROIs; for a list of those that do, see MimControl().