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

runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesrunlength_features (Operator)

Name

runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesrunlength_features — Ermitteln von charakteristischen Werten zur Lauflängenkodierung von Regionen.

Signatur

runlength_features(Regions : : : NumRuns, KFactor, LFactor, MeanLength, Bytes)

Herror runlength_features(const Hobject Regions, Hlong* NumRuns, double* KFactor, double* LFactor, double* MeanLength, Hlong* Bytes)

Herror T_runlength_features(const Hobject Regions, Htuple* NumRuns, Htuple* KFactor, Htuple* LFactor, Htuple* MeanLength, Htuple* Bytes)

void RunlengthFeatures(const HObject& Regions, HTuple* NumRuns, HTuple* KFactor, HTuple* LFactor, HTuple* MeanLength, HTuple* Bytes)

HTuple HRegion::RunlengthFeatures(HTuple* KFactor, HTuple* LFactor, HTuple* MeanLength, HTuple* Bytes) const

Hlong HRegion::RunlengthFeatures(double* KFactor, double* LFactor, double* MeanLength, Hlong* Bytes) const

static void HOperatorSet.RunlengthFeatures(HObject regions, out HTuple numRuns, out HTuple KFactor, out HTuple LFactor, out HTuple meanLength, out HTuple bytes)

HTuple HRegion.RunlengthFeatures(out HTuple KFactor, out HTuple LFactor, out HTuple meanLength, out HTuple bytes)

int HRegion.RunlengthFeatures(out double KFactor, out double LFactor, out double meanLength, out int bytes)

def runlength_features(regions: HObject) -> Tuple[Sequence[int], Sequence[float], Sequence[float], Sequence[float], Sequence[int]]

def runlength_features_s(regions: HObject) -> Tuple[int, float, float, float, int]

Beschreibung

runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeaturesrunlength_features berechnet zu jeder Eingaberegion aus RegionsRegionsRegionsRegionsregionsregions die Anzahl der Sehnen, die bei der Speicherung dieser Region mit Hilfe der Lauflängenkodierung benötigt werden. Weiterhin wird der sogenannte „K-Faktor“ bestimmt, der angibt, um wie viel die Anzahl der Sehnen vom Ideal des Quadrates abweichen, bei dem dieser Wert gleich 1.0 ist.

Der K-Faktor (KFactorKFactorKFactorKFactorKFactorkfactor) berechnet sich nach der Formel: wobei Area die Fläche der Region angibt. Es ist zu beachten, dass der K-Faktor kleiner als 1.0 werden kann (bei langgestreckten horizontalen Regionen).

Der L-Faktor (LFactorLFactorLFactorLFactorLFactorlfactor) gibt die mittlere Anzahl von Sehnen für jeden in der Region vorkommenden Zeilenindex aus.

MeanLengthMeanLengthMeanLengthMeanLengthmeanLengthmean_length gibt die mittlere Länge der Sehnen an. Der Parameter BytesBytesBytesBytesbytesbytes gibt an, wie viele Bytes zur Kodierung der Region mit Lauflängen benötigt werden.

Achtung

Alle mit runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeaturesrunlength_features berechneten Merkmale sind nicht rotationsinvariant, da die Lauflängenkodierung richtungsabhängig ist. runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeaturesrunlength_features dient nicht zur Berechnung von Formmerkmalen, sondern zur Kontrolle und Analyse der Leistungsfähigkeit der Lauflängenkodierung.

Ausführungsinformationen

Parameter

RegionsRegionsRegionsRegionsregionsregions (input_object)  region(-array) → objectHRegionHObjectHRegionHobject

Zu untersuchende Regionen.

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

Anzahl der Sehnen.

Zusicherung: 0 <= NumRuns

KFactorKFactorKFactorKFactorKFactorkfactor (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Speicherfaktor gegenüber einem Quadrat.

Zusicherung: 0 <= KFactor

LFactorLFactorLFactorLFactorLFactorlfactor (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Mittlere Anzahl von Sehnen pro Zeile.

Zusicherung: 0 <= LFactor

MeanLengthMeanLengthMeanLengthMeanLengthmeanLengthmean_length (output_control)  real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Mittlere Länge der Sehnen.

Zusicherung: 0 <= MeanLength

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

Anzahl an Bytes, die zur Kodierung der Region benötigt werden.

Zusicherung: 0 <= Bytes

Komplexität

Die Laufzeitkomplexität beträgt O(1).

Ergebnis

runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeaturesrunlength_features liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht leer ist. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThresholdthreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, connectionconnectionConnectionConnectionConnectionconnection

Siehe auch

runlength_distributionrunlength_distributionRunlengthDistributionRunlengthDistributionRunlengthDistributionrunlength_distribution

Modul

Foundation

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