train_generic_shape_model — Trainieren eines Formmodells für das Matching.
Der Operator train_generic_shape_model trainiert das Formmodell
ModelID um das in Template übergebene Trainingsmuster
finden zu können.
Für Template können folgende Typen als Trainingsmuster übergeben
werden:
Die Domäne des in Template übergebenen Bildes bestimmt die
ROI des Modells. Welche Kanäle eines mehrkanaligen Bildes genutzt werden
hängt vom Modellparameter 'metric' (siehe
set_generic_shape_model_param) ab.
Der Ursprung des Modells (Referenzpunkt) wird durch den Schwerpunkt der
Bilddomäne definiert. Der Ursprung kann mittels
set_generic_shape_model_param verändert werden.
Die in Template ü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_param
verändert werden.
Eigenschaften des Modells ModelID können mit
get_generic_shape_model_param abgefragt und mit
set_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_param).
Hinzugefügte Trainings-Samples:
Falls Samples hinzugefügt wurden, werden diese bei einem erfolgreichen
Aufruf von train_generic_shape_model aus dem Modell entfernt.
Dieser Operator unterstützt Cancel-Timeouts und Interrupts.
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.
Template (input_object) (multichannel-)object(-array) → object
Trainingsbild oder -XLD.
ModelID (input_control, Zustand wird modifiziert) shape_model → (handle)
Handle des Formmodells.
Sind die Parameterwerte korrekt, dann liefert
train_generic_shape_model den Wert 2 (
H_MSG_TRUE)
.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
create_generic_shape_model,
set_generic_shape_model_param
Matching