HALCON 23.11.0.0 / 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_rangeTupleHistoRangeTupleHistoRangetuple_histo_range erstellt die Werteverteilung HistoHistoHistohistohisto des Tupels TupleTupleTupletupletuple im Wertebereich [MinMinMinminmin,MaxMaxMaxmaxmax]. Die Werte für MinMinMinminmin und MaxMaxMaxmaxmax werden abgerundet falls alle Einträge des Tupels TupleTupleTupletupletuple vom Datentyp integer (Ganzzahl) sind. Der Wertebereich wird in NumBinsNumBinsNumBinsnumBinsnum_bins gleichgroße Klassen aufgeteilt. Die Größe einer solchen Klasse wird in BinSizeBinSizeBinSizebinSizebin_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 BinSizeBinSizeBinSizebinSizebin_size zu den folgenden Effekten kommen: Für BinSizeBinSizeBinSizebinSizebin_size > 1 werden mehrere aufeinanderfolgende Zahlen der selben Klasse zugeordnet. Ist BinSizeBinSizeBinSizebinSizebin_size dabei keine natürliche Zahl werden die Zahlen ungleichmäßig auf die Klassen verteilt (Für BinSizeBinSizeBinSizebinSizebin_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 HistoHistoHistohistohisto bemerkbar. Gilt BinSizeBinSizeBinSizebinSizebin_size < 1 werden je nach BinSizeBinSizeBinSizebinSizebin_size einigen Klassen keine Zahlen zugeordnet (Für BinSizeBinSizeBinSizebinSizebin_size = 0.5 wird beispielsweise die erste Zahl der ersten Klasse und die zweite Zahl der dritten Klasse zugeordnet). Das Histogramm HistoHistoHistohistohisto 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 MinMinMinminmin = MaxMaxMaxmaxmax alle Einträge des entsprechenden Wertes nur der ersten Klasse zugeordnet.

Ausführungsinformationen

Parameter

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

Eingabetupel.

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

Minimaler Wert.

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

Maximaler Wert.

Restriktion: Max >= Min

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

Anzahl Klassen.

Restriktion: NumBins >= 1

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

Zu berechnendes Histogramm.

BinSizeBinSizeBinSizebinSizebin_size (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Klassengröße.

Ergebnis

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

Vorgänger

tuple_mintuple_minTupleMinTupleMintuple_min, tuple_maxtuple_maxTupleMaxTupleMaxtuple_max

Nachfolger

create_funct_1d_arraycreate_funct_1d_arrayCreateFunct1dArrayCreateFunct1dArraycreate_funct_1d_array

Siehe auch

gray_histogray_histoGrayHistoGrayHistogray_histo, gray_histo_absgray_histo_absGrayHistoAbsGrayHistoAbsgray_histo_abs, gray_histo_rangegray_histo_rangeGrayHistoRangeGrayHistoRangegray_histo_range

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 23.11.0.0 Copyright © 1996-2023 MVTec Software GmbH