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

tuple_histo_rangeT_tuple_histo_rangeTupleHistoRangeTupleHistoRangetuple_histo_range (Operator)

Name

tuple_histo_rangeT_tuple_histo_rangeTupleHistoRangeTupleHistoRangetuple_histo_range — 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)

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

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)

def tuple_histo_range(tuple: Sequence[Union[float, int]], min: Union[float, int], max: Union[float, int], num_bins: int) -> Tuple[Sequence[int], float]

def tuple_histo_range_s(tuple: Sequence[Union[float, int]], min: Union[float, int], max: Union[float, int], num_bins: int) -> Tuple[int, float]

Beschreibung

tuple_histo_rangetuple_histo_rangeTupleHistoRangeTupleHistoRangeTupleHistoRangetuple_histo_range 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 NumBinsNumBinsNumBinsNumBinsnumBinsnum_bins gleichgroße Klassen aufgeteilt. Die Größe einer solchen Klasse wird in BinSizeBinSizeBinSizeBinSizebinSizebin_size 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 . Sind alle Einträge vom Datentyp integer (Ganzzahl) wird die Klassengröße über berechnet.

Sonderfall: Leere Eingabetupel

Falls eines oder mehrere Eingabetupel leer sind, wird eine Fehlermeldung angezeigt.

Achtung

Bei Tupeln, die nur Daten vom Typ integer (Ganzzahl) enthalten kann es in Abhängigkeit von BinSizeBinSizeBinSizeBinSizebinSizebin_size zu den folgenden Effekten kommen: Für BinSizeBinSizeBinSizeBinSizebinSizebin_size > 1 werden mehrere aufeinanderfolgende Zahlen der selben Klasse zugeordnet. Ist BinSizeBinSizeBinSizeBinSizebinSizebin_size dabei keine natürliche Zahl werden die Zahlen ungleichmäßig auf die Klassen verteilt (Für BinSizeBinSizeBinSizeBinSizebinSizebin_size = 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 BinSizeBinSizeBinSizeBinSizebinSizebin_size < 1 werden je nach BinSizeBinSizeBinSizeBinSizebinSizebin_size einigen Klassen keine Zahlen zugeordnet (Für BinSizeBinSizeBinSizeBinSizebinSizebin_size = 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 Struktur 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.

Ausführungsinformationen

Parameter

TupleTupleTupleTupletupletuple (input_control)  number-array → HTupleSequence[Union[float, int]]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Eingabetupel.

MinMinMinMinminmin (input_control)  number → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Minimaler Wert.

MaxMaxMaxMaxmaxmax (input_control)  number → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximaler Wert.

Restriktion: Max >= Min

NumBinsNumBinsNumBinsNumBinsnumBinsnum_bins (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Anzahl Klassen.

Restriktion: NumBins >= 1

HistoHistoHistoHistohistohisto (output_control)  histogram(-array) → HTupleSequence[int]HTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Zu berechnendes Histogramm.

BinSizeBinSizeBinSizeBinSizebinSizebin_size (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Klassengröße.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert tuple_histo_rangetuple_histo_rangeTupleHistoRangeTupleHistoRangeTupleHistoRangetuple_histo_range den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

tuple_mintuple_minTupleMinTupleMinTupleMintuple_min, tuple_maxtuple_maxTupleMaxTupleMaxTupleMaxtuple_max

Nachfolger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array

Siehe auch

gray_histogray_histoGrayHistoGrayHistoGrayHistogray_histo, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsGrayHistoAbsgray_histo_abs, gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangeGrayHistoRangegray_histo_range

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 21.05.0.0 Copyright © 1996-2021 MVTec Software GmbH
Follow us on