train_generic_shape_modelT_train_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model (Operator)
Name
train_generic_shape_modelT_train_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model — Trainieren eines Formmodells für das Matching.
Signatur
Herror T_train_generic_shape_model(const Hobject Template, const Htuple ModelID)
Beschreibung
Der Operator train_generic_shape_modeltrain_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model trainiert das Formmodell
ModelIDModelIDModelIDModelIDmodelIDmodel_id um das in TemplateTemplateTemplateTemplatetemplatetemplate übergebene Trainingsmuster
finden zu können.
Für TemplateTemplateTemplateTemplatetemplatetemplate können folgende Typen als Trainingsmuster übergeben
werden:
- Bild:
-
Die Domäne des in TemplateTemplateTemplateTemplatetemplatetemplate übergebenen Bildes bestimmt die
ROI des Modells.
Der Ursprung des Modells (Referenzpunkt) wird durch den Schwerpunkt der
Bilddomäne definiert. Der Ursprung kann mittels
set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param verändert werden.
- XLD-Kontur:
-
Die in TemplateTemplateTemplateTemplatetemplatetemplate übergebene XLD-Kontur sollte den Grauwertkanten
des gesuchten Musters entsprechen.
Der Ursprung des Modells (Referenzpunkt) wird durch den Schwerpunkt des
kleinsten achsenparallelen Rechtecks, das die Konturen umschließt,
definiert. Der Ursprung kann mittels set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param
verändert werden.
Eigenschaften des Modells ModelIDModelIDModelIDModelIDmodelIDmodel_id können mit
get_generic_shape_model_paramget_generic_shape_model_paramGetGenericShapeModelParamGetGenericShapeModelParamGetGenericShapeModelParamget_generic_shape_model_param abgefragt und mit
set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param angepasst werden.
Es ist zu beachten, dass die Veränderung bestimmter Parameter dazu führt,
dass das Modell (erneut) trainiert werden muss (siehe
set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param).
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:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
Parameter
TemplateTemplateTemplateTemplatetemplatetemplate (input_object) (multichannel-)object(-array) → objectHObjectHObjectHObjectHobject
Trainingsbild oder -XLD.
ModelIDModelIDModelIDModelIDmodelIDmodel_id (input_control, Zustand wird modifiziert) shape_model → HShapeModel, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Formmodells.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
train_generic_shape_modeltrain_generic_shape_modelTrainGenericShapeModelTrainGenericShapeModelTrainGenericShapeModeltrain_generic_shape_model den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_generic_shape_modelcreate_generic_shape_modelCreateGenericShapeModelCreateGenericShapeModelCreateGenericShapeModelcreate_generic_shape_model,
set_generic_shape_model_paramset_generic_shape_model_paramSetGenericShapeModelParamSetGenericShapeModelParamSetGenericShapeModelParamset_generic_shape_model_param
Nachfolger
find_generic_shape_modelfind_generic_shape_modelFindGenericShapeModelFindGenericShapeModelFindGenericShapeModelfind_generic_shape_model
Modul
Matching