HALCON Website / HALCON Operator-Referenz / Tupel / Merkmale
KlassenKlassenKlassenKlassen | | | | Operatoren

tuple_histo_rangeT_tuple_histo_rangeTupleHistoRangetuple_histo_rangeTupleHistoRangeTupleHistoRange (Operator)

Name

tuple_histo_rangeT_tuple_histo_rangeTupleHistoRangetuple_histo_rangeTupleHistoRangeTupleHistoRange — Berechnen der Werteverteilung eines Tupels innerhalb eines bestimmten Wertebereichs.

Signatur

tuple_histo_range( : : Tuple, Min, Max, NumBins : Histo, BinSize)

Herror T_tuple_histo_range(const Htuple Tuple, const Htuple Min, const Htuple Max, const Htuple NumBins, Htuple* Histo, Htuple* BinSize)

Herror tuple_histo_range(const HTuple& Tuple, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, Hlong* Histo, double* BinSize)

Herror tuple_histo_range(const HTuple& Tuple, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* Histo, HTuple* BinSize)

void TupleHistoRange(const HTuple& Tuple, const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* Histo, HTuple* BinSize)

HTuple HTuple::TupleHistoRange(const HTuple& Min, const HTuple& Max, const HTuple& NumBins, HTuple* BinSize) const

void HOperatorSetX.TupleHistoRange(
[in] VARIANT Tuple, [in] VARIANT Min, [in] VARIANT Max, [in] VARIANT NumBins, [out] VARIANT* Histo, [out] VARIANT* BinSize)

VARIANT HTupleX.TupleHistoRange(
[in] VARIANT Tuple, [in] VARIANT Min, [in] VARIANT Max, [in] VARIANT NumBins, [out] VARIANT* BinSize)

static void HOperatorSet.TupleHistoRange(HTuple tuple, HTuple min, HTuple max, HTuple numBins, out HTuple histo, out HTuple binSize)

HTuple HTuple.TupleHistoRange(HTuple min, HTuple max, HTuple numBins, out HTuple binSize)

Beschreibung

tuple_histo_rangetuple_histo_rangeTupleHistoRangetuple_histo_rangeTupleHistoRangeTupleHistoRange erstellt die Werteverteilung HistoHistoHistoHistoHistohisto des Tupels TupleTupleTupleTupleTupletuple im Wertebereich [MinMinMinMinMinmin,MaxMaxMaxMaxMaxmax]. Die Werte für MinMinMinMinMinmin und MaxMaxMaxMaxMaxmax werden abgerundet falls alle Einträge des Tupels TupleTupleTupleTupleTupletuple vom Datentyp integer (Ganzzahl) sind. Der Wertebereich wird in NumBinsNumBinsNumBinsNumBinsNumBinsnumBins gleichgroße Klassen aufgeteilt. Die Größe einer solchen Klasse wird in BinSizeBinSizeBinSizeBinSizeBinSizebinSize ausgegeben. Liegt ein Wert zwischen zwei Klassen wird er immer der kleineren Klasse zugeordnet. Bei einem Tupel mit Einträgen vom Datentyp real (Gleitkommazahl) ist die Klassengröße BinSizeBinSizeBinSizeBinSizeBinSizebinSize = (MaxMaxMaxMaxMaxmax - MinMinMinMinMinmin) / NumBinsNumBinsNumBinsNumBinsNumBinsnumBins . Sind alle Einträge vom Datentyp integer (Ganzzahl) wird die Klassengröße über BinSizeBinSizeBinSizeBinSizeBinSizebinSize = (MaxMaxMaxMaxMaxmax - MinMinMinMinMinmin + 1) / NumBinsNumBinsNumBinsNumBinsNumBinsnumBins berechnet.

Achtung

Bei Tupeln, die nur Daten vom Typ integer (Ganzzahl) enthalten kann es in Abhängigkeit von BinSizeBinSizeBinSizeBinSizeBinSizebinSize zu den folgenden Effekten kommen: Für BinSizeBinSizeBinSizeBinSizeBinSizebinSize > 1 werden mehrere aufeinanderfolgende Zahlen der selben Klasse zugeordnet. Ist BinSizeBinSizeBinSizeBinSizeBinSizebinSize dabei keine natürliche Zahl werden die Zahlen ungleichmäßig auf die Klassen verteilt (Für BinSizeBinSizeBinSizeBinSizeBinSizebinSize = 1.5 werden beispielsweise die ersten beiden Zahlen der ersten Klasse, die dritte Zahl der zweiten Klasse und die vierte und fünfte Zahl der dritten Klasse zugeordnet). Dies macht sich durch einzelne Spitzen im Histogramm HistoHistoHistoHistoHistohisto bemerkbar. Gilt BinSizeBinSizeBinSizeBinSizeBinSizebinSize < 1 werden je nach BinSizeBinSizeBinSizeBinSizeBinSizebinSize einigen Klassen keine Zahlen zugeordnet (Für BinSizeBinSizeBinSizeBinSizeBinSizebinSize = 0.5 wird beispielsweise die erste Zahl der ersten Klasse und die zweite Zahl der dritten Klasse zugeordnet). Das Histogramm HistoHistoHistoHistoHistohisto weist dann einige Lücken auf, was der Strukur eines Kamms ähnelt.

Bei einem Tupel mit Einträgen vom Datentyp real (Gleitkommazahl) werden für MinMinMinMinMinmin = MaxMaxMaxMaxMaxmax alle Einträge des entsprechenden Wertes nur der ersten Klasse zugeordnet.

Parallelisierung

Parameter

TupleTupleTupleTupleTupletuple (input_control)  real-array → HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Eingabetupel.

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

Minimaler Wert.

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

Maximaler Wert.

Restriktion: Max >= Min

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

Anzahl Klassen.

Restriktion: NumBins >= 1

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

Zu berechnendes Histogramm.

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

Klassengröße.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert tuple_histo_rangetuple_histo_rangeTupleHistoRangetuple_histo_rangeTupleHistoRangeTupleHistoRange den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

tuple_mintuple_minTupleMintuple_minTupleMinTupleMin, tuple_maxtuple_maxTupleMaxtuple_maxTupleMaxTupleMax

Nachfolger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArray

Siehe auch

gray_histogray_histoGrayHistogray_histoGrayHistoGrayHisto, gray_histo_absgray_histo_absGrayHistoAbsgray_histo_absGrayHistoAbsGrayHistoAbs, gray_histo_rangegray_histo_rangeGrayHistoRangegray_histo_rangeGrayHistoRangeGrayHistoRange

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 11.0.5 Copyright © 1996-2015 MVTec Software GmbH