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

runlength_featuresrunlength_featuresRunlengthFeaturesrunlength_featuresRunlengthFeaturesRunlengthFeatures (Operator)

Name

runlength_featuresrunlength_featuresRunlengthFeaturesrunlength_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)

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

Herror runlength_features(Hobject Regions, HTuple* NumRuns, HTuple* KFactor, HTuple* LFactor, HTuple* MeanLength, HTuple* Bytes)

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

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

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

void HOperatorSetX.RunlengthFeatures(
[in] IHUntypedObjectX* Regions, [out] VARIANT* NumRuns, [out] VARIANT* KFactor, [out] VARIANT* LFactor, [out] VARIANT* MeanLength, [out] VARIANT* Bytes)

VARIANT HRegionX.RunlengthFeatures(
[out] VARIANT* KFactor, [out] VARIANT* LFactor, [out] VARIANT* MeanLength, [out] VARIANT* Bytes)

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_featuresRunlengthFeaturesrunlength_featuresRunlengthFeaturesRunlengthFeatures 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 wieviel 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.

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

Achtung

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

Parallelisierung

Parameter

RegionsRegionsRegionsRegionsRegionsregions (input_object)  region(-array) → objectHRegionHRegionHRegionHRegionXHobject

Zu untersuchende Regionen.

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

Anzahl der Sehnen.

Zusicherung: 0 <= NumRuns

KFactorKFactorKFactorKFactorKFactorKFactor (output_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Speicherfaktor gegenüber einem Quadrat.

Zusicherung: 0 <= KFactor

LFactorLFactorLFactorLFactorLFactorLFactor (output_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Mittlere Anzahl von Sehnen pro Zeile.

Zusicherung: 0 <= LFactor

MeanLengthMeanLengthMeanLengthMeanLengthMeanLengthmeanLength (output_control)  real(-array) → HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Mittlere Länge der Sehnen.

Zusicherung: 0 <= MeanLength

BytesBytesBytesBytesBytesbytes (output_control)  integer(-array) → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (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_featuresRunlengthFeaturesrunlength_featuresRunlengthFeaturesRunlengthFeatures 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_distributionRunlengthDistributionrunlength_distributionRunlengthDistributionRunlengthDistribution

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH