prepare_variation_modelprepare_variation_modelPrepareVariationModelPrepareVariationModel (Operator)

Name

prepare_variation_modelprepare_variation_modelPrepareVariationModelPrepareVariationModel — Vorbereitung eines Variationsmodells zum Vergleich.

Signatur

prepare_variation_model( : : ModelID, AbsThreshold, VarThreshold : )

Beschreibung

prepare_variation_modelprepare_variation_modelPrepareVariationModelPrepareVariationModelPrepareVariationModel bereitet ein Variationsmodell zum Vergleich mit compare_variation_modelcompare_variation_modelCompareVariationModelCompareVariationModelCompareVariationModel oder compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModelCompareExtVariationModel vor. Hierzu werden aus dem mit train_variation_modeltrain_variation_modelTrainVariationModelTrainVariationModelTrainVariationModel trainierten idealen Bild und dem zugehörigen Variationsbild zwei interne Schwellwertbilder berechnet und im Variationsmodell abgespeichert. Diese Schwellwertbilder werden in compare_variation_modelcompare_variation_modelCompareVariationModelCompareVariationModelCompareVariationModel oder compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModelCompareExtVariationModel verwendet, um den Vergleich des aktuellen Bildes mit dem Variationsmodell zu beschleunigen.

Zur Berechnung der Schwellwertbilder werden zwei Schwellwerte verwendet. Der Schwellwert AbsThresholdAbsThresholdAbsThresholdAbsThresholdabsThreshold gibt an, um wieviele Graustufen sich das Bild des aktuellen Objektes mindestens vom idealen Bild unterscheiden muss. Der Schwellwert VarThresholdVarThresholdVarThresholdVarThresholdvarThreshold gibt einen Faktor für den Unterschied des aktuellen Bildes relativ zu der im Variationsbild gespeicherten Variation des Objektes an. AbsThresholdAbsThresholdAbsThresholdAbsThresholdabsThreshold und VarThresholdVarThresholdVarThresholdVarThresholdvarThreshold können jeweils einen oder zwei Werte enthalten. Falls zwei Werte angegeben werden, können unterschiedliche Schwellen für zu helle und zu dunkle Pixel festgelegt werden. Dabei bezieht sich der erste Wert auf die zu hellen Grauwerte und der zweite Wert auf die zu dunklen Grauwerte. Falls nur ein Wert angegeben wird, bezieht sich der Wert sowohl auf die zu hellen als auch auf die zu dunklen Grauwerte. Sei i(x,y) das ideale Bild, v(x,y) das Variationsbild, , , und (bzw. , , und ). Dann werden die beiden Schwellwertbilder wie folgt berechnet:

Wenn das aktuelle Bild c(x,y) mit compare_variation_modelcompare_variation_modelCompareVariationModelCompareVariationModelCompareVariationModel mit dem Variationsmodell verglichen wird, wird die Ausgaberegion aus allen Punkten bestimmt, die sich stark vom Modell unterscheiden, d.h. für die gilt:

In compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModelCompareExtVariationModel stehen erweiterte Vergleichsmodi zur Verfügung, mit denen zusätzlich nur zu helle Fehler, nur zu dunkle Fehler und zu helle und zu dunkle Fehler als separate Regionen zurückgeliefert werden können.

Nachdem die Schwellwertbilder erzeugt worden sind, können sie mit get_thresh_images_variation_modelget_thresh_images_variation_modelGetThreshImagesVariationModelGetThreshImagesVariationModelGetThreshImagesVariationModel ausgelesen werden. Außerdem können die Trainingsdaten mit clear_train_data_variation_modelclear_train_data_variation_modelClearTrainDataVariationModelClearTrainDataVariationModelClearTrainDataVariationModel gelöscht werden, um Speicherplatz zu sparen.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:

ModelIDModelIDModelIDModelIDmodelID

Der Wert dieses Parameters darf nicht über mehrere Threads verwendet werden.

Parameter

ModelIDModelIDModelIDModelIDmodelID (input_control, Zustand wird modifiziert) variation_model → (integer)

ID des Variationsmodells.

AbsThresholdAbsThresholdAbsThresholdAbsThresholdabsThreshold (input_control) number(-array) → (real / integer)

Absoluter Mindestschwellwert für die Unterschiede bezüglich des Variationsmodells.

Defaultwert: 10

Wertevorschläge: 0, 5, 10, 15, 20, 30, 40, 50

Restriktion: AbsThreshold >= 0

VarThresholdVarThresholdVarThresholdVarThresholdvarThreshold (input_control) number(-array) → (real / integer)

Schwellwert für die Unterschiede bezüglich der Variation des Variationsmodells.

Defaultwert: 2

Wertevorschläge: 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5

Restriktion: VarThreshold >= 0

Ergebnis

prepare_variation_modelprepare_variation_modelPrepareVariationModelPrepareVariationModelPrepareVariationModel liefert 2 (H_MSG_TRUE) zurück, wenn alle Parameter korrekt sind.

Vorgänger

train_variation_modeltrain_variation_modelTrainVariationModelTrainVariationModelTrainVariationModel

Nachfolger

compare_variation_modelcompare_variation_modelCompareVariationModelCompareVariationModelCompareVariationModel, compare_ext_variation_modelcompare_ext_variation_modelCompareExtVariationModelCompareExtVariationModelCompareExtVariationModel, get_thresh_images_variation_modelget_thresh_images_variation_modelGetThreshImagesVariationModelGetThreshImagesVariationModelGetThreshImagesVariationModel, clear_train_data_variation_modelclear_train_data_variation_modelClearTrainDataVariationModelClearTrainDataVariationModelClearTrainDataVariationModel, write_variation_modelwrite_variation_modelWriteVariationModelWriteVariationModelWriteVariationModel

Alternativen

prepare_direct_variation_modelprepare_direct_variation_modelPrepareDirectVariationModelPrepareDirectVariationModelPrepareDirectVariationModel

Siehe auch

create_variation_modelcreate_variation_modelCreateVariationModelCreateVariationModelCreateVariationModel

Modul

Matching

Operatoren