ClassesClassesClassesClasses | | | | Operators

gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange (Operator)

Name

gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange — Calculate the gray value distribution of a single channel image within a certain gray value range.

Signature

gray_histo_range(Regions, Image : : Min, Max, NumBins : Histo, BinSize)

Herror gray_histo_range(const Hobject Regions, const Hobject Image, double Min, double Max, const Hlong NumBins, Hlong* Histo, double* BinSize)

Herror T_gray_histo_range(const Hobject Regions, const Hobject Image, const Htuple Min, const Htuple Max, const Htuple NumBins, Htuple* Histo, Htuple* BinSize)

Herror gray_histo_range(Hobject Regions, Hobject Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, Hlong* Histo, double* BinSize)

Herror gray_histo_range(Hobject Regions, Hobject Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* Histo, HTuple* BinSize)

Hlong HRegion::GrayHistoRange(const HImage& Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, double* BinSize) const

HTuple HRegionArray::GrayHistoRange(const HImage& Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* BinSize) const

void GrayHistoRange(const HObject& Regions, const HObject& Image, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* Histo, HTuple* BinSize)

HTuple HImage::GrayHistoRange(const HRegion& Regions, const HTuple& Min, const HTuple& Max, Hlong NumBins, double* BinSize) const

Hlong HImage::GrayHistoRange(const HRegion& Regions, double Min, double Max, Hlong NumBins, double* BinSize) const

HTuple HRegion::GrayHistoRange(const HImage& Image, const HTuple& Min, const HTuple& Max, Hlong NumBins, double* BinSize) const

Hlong HRegion::GrayHistoRange(const HImage& Image, double Min, double Max, Hlong NumBins, double* BinSize) const

void HOperatorSetX.GrayHistoRange(
[in] IHUntypedObjectX* Regions, [in] IHUntypedObjectX* Image, [in] VARIANT Min, [in] VARIANT Max, [in] VARIANT NumBins, [out] VARIANT* Histo, [out] VARIANT* BinSize)

VARIANT HImageX.GrayHistoRange(
[in] IHRegionX* Regions, [in] VARIANT Min, [in] VARIANT Max, [in] Hlong NumBins, [out] double* BinSize)

VARIANT HRegionX.GrayHistoRange(
[in] IHImageX* Image, [in] VARIANT Min, [in] VARIANT Max, [in] Hlong NumBins, [out] double* BinSize)

static void HOperatorSet.GrayHistoRange(HObject regions, HObject image, HTuple min, HTuple max, HTuple numBins, out HTuple histo, out HTuple binSize)

HTuple HImage.GrayHistoRange(HRegion regions, HTuple min, HTuple max, int numBins, out double binSize)

int HImage.GrayHistoRange(HRegion regions, double min, double max, int numBins, out double binSize)

HTuple HRegion.GrayHistoRange(HImage image, HTuple min, HTuple max, int numBins, out double binSize)

int HRegion.GrayHistoRange(HImage image, double min, double max, int numBins, out double binSize)

Description

gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange calculates the gray value distribution HistoHistoHistoHistoHistohisto of the single channel ImageImageImageImageImageimage within RegionsRegionsRegionsRegionsRegionsregions and the gray value range [MinMinMinMinMinmin,MaxMaxMaxMaxMaxmax]. The values for MinMinMinMinMinmin and MaxMaxMaxMaxMaxmax are rounded down to the next integer if the ImageImageImageImageImageimage is not of type 'real'"real""real""real""real""real". The gray value range is divided into NumBinsNumBinsNumBinsNumBinsNumBinsnumBins bins of the same size, which is returned in BinSizeBinSizeBinSizeBinSizeBinSizebinSize. If a gray value lies between two bins the gray value is assigned to the smaller bin. If the ImageImageImageImageImageimage is of type 'real'"real""real""real""real""real" . If the ImageImageImageImageImageimage has discrete gray values the size of a bin is computed with . Since the accuracy of the histogram HistoHistoHistoHistoHistohisto can be adjusted with NumBinsNumBinsNumBinsNumBinsNumBinsnumBins, the calculation of the gray value histogram with gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange is most useful for images of type 'real'"real""real""real""real""real" and images of type 'integer'"integer""integer""integer""integer""integer", which have a high bit depth.

Attention

Note that the operator gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange only considers the given RegionsRegionsRegionsRegionsRegionsregions and ignores any previously set domain of the input image ImageImageImageImageImageimage.

If the ImageImageImageImageImageimage has discrete gray values the value of BinSizeBinSizeBinSizeBinSizeBinSizebinSize may cause the following effects: For BinSizeBinSizeBinSizeBinSizeBinSizebinSize > 1 multiple neighboring gray values are assigned to the same bin. If BinSizeBinSizeBinSizeBinSizeBinSizebinSize is no integer the gray values are distributed uneven among the bins, e.g., for BinSizeBinSizeBinSizeBinSizeBinSizebinSize = 1.5 the first and second gray value are assigned to the first bin, the third gray value is assigned to the second bin, and the fourth and fifth gray value are assigned to the third bin. This becomes noticeable in several peeks in the histogram HistoHistoHistoHistoHistohisto. If BinSizeBinSizeBinSizeBinSizeBinSizebinSize < 1 some classes are not assigned by any gray value, e.g., for BinSizeBinSizeBinSizeBinSizeBinSizebinSize = 0.5 the first gray value is assigned to the first bin and the second gray value is assigned to the third bin. The histogram HistoHistoHistoHistoHistohisto shows some gaps, which resembles the structure of a comb.

If the ImageImageImageImageImageimage is of type 'real'"real""real""real""real""real" and MinMinMinMinMinmin = MaxMaxMaxMaxMaxmax, all pixels of the corresponding gray value are assigned only to the first bin.

Parallelization

Parameters

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Region in which the histogram is to be calculated.

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / cyclic / direction / int1 / uint2 / int2 / int4 / int8 / real)

Input image.

MinMinMinMinMinmin (input_control)  real HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Minimum gray value.

Default value: 0

Suggested values: 0

MaxMaxMaxMaxMaxmax (input_control)  real HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Maximum gray value.

Default value: 255

Suggested values: 255

Restriction: Max >= Min

NumBinsNumBinsNumBinsNumBinsNumBinsnumBins (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Number of bins.

Default value: 256

Suggested values: 16, 32, 64, 128, 256

Restriction: NumBins >= 1

HistoHistoHistoHistoHistohisto (output_control)  histogram(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Histogram to be calculated.

BinSizeBinSizeBinSizeBinSizeBinSizebinSize (output_control)  real HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Bin size.

Result

If the parameters are valid, the operator gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange returns the value 2 (H_MSG_TRUE). If necessary an exception is raised.

Possible Predecessors

min_max_graymin_max_grayMinMaxGraymin_max_grayMinMaxGrayMinMaxGray

Possible Successors

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArray

Alternatives

gray_histogray_histoGrayHistogray_histoGrayHistoGrayHisto, gray_histo_absgray_histo_absGrayHistoAbsgray_histo_absGrayHistoAbsGrayHistoAbs

See also

histo_2dimhisto_2dimHisto2dimhisto_2dimHisto2dimHisto2dim, scale_image_maxscale_image_maxScaleImageMaxscale_image_maxScaleImageMaxScaleImageMax

Module

Foundation


ClassesClassesClassesClasses | | | | Operators