create_trained_component_modelT_create_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel (Operator)

Name

create_trained_component_modelT_create_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModel — Vorbereiten eines Komponentenmodells für das Matching auf der Basis trainierter Komponenten.

Signatur

Beschreibung

create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel bereitet das Trainingsergebnis, das in ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID übergeben wird, als Komponentenmodell für das Matching vor. Der Ausgabeparameter ComponentModelIDComponentModelIDComponentModelIDComponentModelIDcomponentModelID ist ein Handle für dieses Modell, der in nachfolgenden Aufrufen von find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel verwendet wird. Im Gegensatz zu create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel müssen die Modellkomponenten mit train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents trainiert worden sein bevor create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel aufgerufen werden kann.

Die Parameter AngleStartAngleStartAngleStartAngleStartangleStart und AngleExtentAngleExtentAngleExtentAngleExtentangleExtent legen den Winkelbereich für die möglichen Rotationen des Komponentenmodells im Bild fest.

Im Wesentlichen wird intern für jede Modellkomponente ein separates Formmodell erzeugt (siehe create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel). Daher entsprechen die Parameter MinContrastCompMinContrastCompMinContrastCompMinContrastCompminContrastComp, MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp, NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp, AngleStepCompAngleStepCompAngleStepCompAngleStepCompangleStepComp, OptimizationCompOptimizationCompOptimizationCompOptimizationCompoptimizationComp, MetricCompMetricCompMetricCompMetricCompmetricComp und PregenerationCompPregenerationCompPregenerationCompPregenerationComppregenerationComp den Parametern in create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel mit den folgenden Unterschieden: Im Parameter OptimizationOptimizationOptimizationOptimizationoptimization von create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel kann neben einer möglichen Reduktion der Modellpunkte auch entschieden werden, ob das Formmodell vollständig vorab generiert wird oder nicht. Der Operator create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel bietet dagegen für die Vorabgenerierung der Formmodelle einen separaten Parameter PregenerationCompPregenerationCompPregenerationCompPregenerationComppregenerationComp. Ein zweiter Unterschied bezieht sich auf den Parameter MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp, der beim formbasierten Matching nicht bereits beim Vorbereiten des Modells mit create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel sondern erst bei der Suche mit find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModel übergeben wird. Beim Vorbereiten des Komponentenmodells ist es jedoch vorteilhaft, auftretende Rotationssymmetrien der Modellkomponenten und Ähnlichkeiten zwischen den Modellkomponenten zu analysieren und beim Aufbau des Komponentenmodells zu berücksichtigen. Diese Analyse kann jedoch nur dann zu sinnvollen Ergebnissen führen, wenn der zur Suche verwendete Wert für MinScoreCompMinScoreCompMinScoreCompMinScoreCompminScoreComp (siehe find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel) bereits annähernd bekannt ist. Die von find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel ermittelten Lagekoordinaten der Modellkomponenten in einem Suchbild beziehen sich auf deren Referenzpunkt. Der Referenzpunkt einer Modellkomponente ist festgelegt durch den Schwerpunkt der entsprechenden von train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents in ModelComponentsModelComponentsModelComponentsModelComponentsmodelComponents zurückgelieferten Region.

Die Parameter MinContrastCompMinContrastCompMinContrastCompMinContrastCompminContrastComp, NumLevelsCompNumLevelsCompNumLevelsCompNumLevelsCompnumLevelsComp, AngleStepCompAngleStepCompAngleStepCompAngleStepCompangleStepComp und OptimizationCompOptimizationCompOptimizationCompOptimizationCompoptimizationComp können jeweils durch die Angabe von 'auto'"auto""auto""auto""auto" automatisch ermittelt werden.

Alle komponentenspezifischen Eingabeparameter (Parameternamen enden jeweils auf Comp) müssen entweder genau ein Element enthalten oder dieselbe Anzahl von Elementen wie in ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID enthaltene Modellkomponenten. Im ersten Fall wird der Wert des Eingabeparameters für alle Modellkomponenten gleich verwendet. Im zweiten Fall wird das jeweilige Element des Eingabeparameters für die entsprechende Modellkomponente in ComponentTrainingIDComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingID verwendet.

Das Komponentenmodell enthält neben den einzelnen Formmodellen auch die Information über die Art und Weise, wie die einzelnen Modellkomponenten mit find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel relativ zueinander gesucht werden müssen, damit die Rechenzeit während der Suche minimal ist. Dabei werden die Komponenten durch eine Baumstruktur repräsentiert. Zunächst wird die Komponente, die an der Wurzel des Baumes (Wurzelkomponente) steht, gesucht. Anschließend werden die übrigen Komponenten jeweils relativ zur Lage ihres Vorgängers im Baum gesucht.

Die Wurzelkomponente kann bei der Suche mit find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel als Parameter übergeben werden. Inwiefern sich eine Modellkomponente als Wurzelkomponente eignet, hängt von verschiedenen Faktoren ab. Prinzipiell sollte eine Modellkomponente gewählt werden, die mit hoher Wahrscheinlichkeit im Bild wiedergefunden werden kann. Eine im Bild stark verdeckte oder fehlende Komponente eignet sind daher nur bedingt als Wurzelkomponente. Auch die mit der Wurzelkomponente verbundene Rechenzeit während der Suche kann als Auswahlkriterium herangezogen werden. Eine nach diesem Kriterium sortierte Rangfolge der Modellkomponenten wird im Parameter RootRankingRootRankingRootRankingRootRankingrootRanking zurückgeliefert. In diesem Parameter sind die Indizes der Modellkomponenten nach der mit ihnen verbundenen Rechenzeit aufsteigend sortiert, d.h. RootRankingRootRankingRootRankingRootRankingrootRanking[0] enthält den Index der Modellkomponente, die - als Wurzelkomponente gewählt - die schnellste Suche ermöglicht. Die in RootRankingRootRankingRootRankingRootRankingrootRanking ermittelte Reihenfolge stellt jedoch nur eine grobe Abschätzung dar. Die Abschätzung setzt außerdem voraus, dass sowohl die Bildgröße als auch der Wert des Systemparameters 'border_shape_models'"border_shape_models""border_shape_models""border_shape_models""border_shape_models" beim Aufruf von create_trained_component_modelcreate_trained_component_modelCreateTrainedComponentModelCreateTrainedComponentModelCreateTrainedComponentModel und find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel identisch sind.

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 liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

Beispiel (HDevelop)

* Get the model image.
read_image (ModelImage, 'model_image.tif')
* Define the regions for the initial components.
gen_rectangle2 (InitialComponentRegions, 212, 233, 0.62, 167, 29)
gen_rectangle2 (Rectangle2, 298, 363, 1.17, 162, 34)
gen_rectangle2 (Rectangle3, 63, 444, -0.26, 50, 27)
gen_rectangle2 (Rectangle4, 120, 473, 0, 33, 20)
concat_obj (InitialComponentRegions, Rectangle2, InitialComponentRegions)
concat_obj (InitialComponentRegions, Rectangle3, InitialComponentRegions)
concat_obj (InitialComponentRegions, Rectangle4, InitialComponentRegions)
* Get the training images.
gen_empty_obj (TrainingImages)
for i := 1 to 4 by 1
    read_image (TrainingImage, 'training_image-'+i+'.tif')
    concat_obj (TrainingImages, TrainingImage, TrainingImages)
endfor
* Extract the model components and train the relations.
train_model_components (ModelImage, InitialComponentRegions, \
                        TrainingImages, ModelComponents, 22, 60, 30, 0.65, \
                        0, 0, rad(60), 'speed', 'rigidity', 0.2, 0.4, \
                        ComponentTrainingID)
* Create the component model based on the training result.
create_trained_component_model (ComponentTrainingID, -rad(30), rad(60), 10, \
                                0.5, 'auto', 'auto', 'none', \
                                'use_polarity', 'false', ComponentModelID, \
                                RootRanking)
* Find the component model in a run-time image.
read_image (SearchImage, 'search_image.tif')
find_component_model (SearchImage, ComponentModelID, RootRanking, -rad(30), \
                      rad(60), 0.5, 0, 0.5, 'stop_search', 'prune_branch', \
                      'none', 0.55, 'least_squares', 0, 0.9, ModelStart, \
                      ModelEnd, Score, RowComp, ColumnComp, AngleComp, \
                      ScoreComp, ModelComp)

Ergebnis

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

Vorgänger

train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentsTrainModelComponents, read_training_componentsread_training_componentsReadTrainingComponentsReadTrainingComponentsReadTrainingComponents

Nachfolger

find_component_modelfind_component_modelFindComponentModelFindComponentModelFindComponentModel

Alternativen

create_component_modelcreate_component_modelCreateComponentModelCreateComponentModelCreateComponentModel

Siehe auch

create_shape_modelcreate_shape_modelCreateShapeModelCreateShapeModelCreateShapeModel, find_shape_modelfind_shape_modelFindShapeModelFindShapeModelFindShapeModel

Modul

Matching