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

runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeatures (Operator)

Name

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

Beschreibung

runlength_featuresrunlength_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeatures berechnet zu jeder Eingaberegion aus RegionsRegionsRegionsRegionsregions 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 wieviel die Anzahl der Sehnen vom Ideal des Quadrates abweichen, bei dem dieser Wert gleich 1.0 ist.

Der K-Faktor (KFactorKFactorKFactorKFactorKFactor) 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 (LFactorLFactorLFactorLFactorLFactor) gibt die mittlere Anzahl von Sehnen für jeden in der Region vorkommenden Zeilenindex aus.

MeanLengthMeanLengthMeanLengthMeanLengthmeanLength gibt die mittlere Länge der Sehnen an. Der Parameter BytesBytesBytesBytesbytes gibt an, wieviele Bytes zur Kodierung der Region mit Lauflängen benötigt werden.

Achtung

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

Ausführungsinformationen

Parameter

RegionsRegionsRegionsRegionsregions (input_object)  region(-array) → objectHRegionHRegionHobject

Zu untersuchende Regionen.

NumRunsNumRunsNumRunsNumRunsnumRuns (output_control)  integer(-array) → HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Anzahl der Sehnen.

Zusicherung: 0 <= NumRuns

KFactorKFactorKFactorKFactorKFactor (output_control)  real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Speicherfaktor gegenüber einem Quadrat.

Zusicherung: 0 <= KFactor

LFactorLFactorLFactorLFactorLFactor (output_control)  real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Mittlere Anzahl von Sehnen pro Zeile.

Zusicherung: 0 <= LFactor

MeanLengthMeanLengthMeanLengthMeanLengthmeanLength (output_control)  real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Mittlere Länge der Sehnen.

Zusicherung: 0 <= MeanLength

BytesBytesBytesBytesbytes (output_control)  integer(-array) → HTupleHTupleHtuple (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_featuresRunlengthFeaturesRunlengthFeaturesRunlengthFeatures liefert den Wert 2 (H_MSG_TRUE), falls die Eingabe nicht leer ist. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

thresholdthresholdThresholdThresholdThreshold, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, connectionconnectionConnectionConnectionConnection

Siehe auch

runlength_distributionrunlength_distributionRunlengthDistributionRunlengthDistributionRunlengthDistribution

Modul

Foundation

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH