set_shape_model_param — Setzen ausgewählter Formmodellparameter.
set_shape_model_param( : : ModelID, GenParamName, GenParamValue : )
Der Operator set_shape_model_param setzt ausgewählte Parameter im
Formmodell ModelID. Die folgenden Parameter können modifiziert
werden:
'min_contrast'
Setzt im Formmodell ModelID den minimalen Kontrast des Objekts in
den Suchbildern. Damit wird der Wert 'min_contrast',
der ursprünglich z.B. mit create_shape_model
gesetzt wurde, überschrieben. Falls das Formmodell ModelID aus einer
Datei eingelesen wurde und diese Datei geändert werden soll, muss das
Formmodell ModelID nochmals in die Datei geschrieben werden, nachdem
der Operator set_shape_model_param ausgeführt wurde.
'timeout'
Setzt die maximale Laufzeit der Operatoren die verwendet werden um das
Formmodell ModelID zu finden (z.B. find_shape_model).
Dies ist dann besonders nützlich, wenn eine maximale Zykluszeit
sichergestellt werden muss. Der 'timeout' muss in Millisekunden
angegeben werden. Die zeitliche Genauigkeit des Timeouts hängt von vielen
Faktoren ab, darunter ist die Größe des Modells, die Geschwindigkeit des
Rechners und der 'timer_mode' der über set_system
gesetzt wurde. Beachten Sie, dass sich die Laufzeit der Modellsuche bei
aktiviertem Timeout um bis zu 10 Prozent erhöht.
Um den Timeout zu deaktivieren, können Sie entweder einen negativen
Wert oder 'false' angeben.
'border_shape_models'
Legt für die Operatoren, die verwendet werden um das
Formmodell ModelID zu finden (z.B. find_shape_model),
fest, ob die gesuchten Modelle teilweise außerhalb des Bildes liegen
dürfen (also den Bildrand überschreiten dürfen).
Teilweise bedeutet, dass der Ursprung des Modells noch innerhalb
des Bildes liegen muss. Ein eventuell mit set_shape_model_origin
anders gesetzter Ursprung wird nicht berücksichtigt.
Der Wert von 'border_shape_models' ist entweder 'true',
'false' oder 'system'. Wenn der Wert auf den Standardwert
'system' gesetzt ist, wird der systemweite Wert verwendet,
der zuletzt mit set_system für 'border_shape_models'
gesetzt wurde.
'use_clutter'
Deaktiviert oder aktiviert die Nutzung von Störparametern für das
Formmodell ModelID, welche zuvor mit
set_shape_model_clutter gesetzt wurden.
Der Wert von 'use_clutter' kann 'true' oder
'false' sein. Es ist zu beachten, dass der Wert von
'use_clutter' die Anzahl erwarteter Einträge für den Parameter
MinScore beeinflusst. Für weitere Informationen, siehe die
Referenz der entsprechenden Operatoren, wie beispielsweise
find_shape_model.
Für neu generierte Formmodelle ist die Nutzung von Störparametern
deaktiviert. Nach dem Aufruf von set_shape_model_clutter ist die
Nutzung von Störparametern aktiviert. Störparameter sowie der
Wert von 'use_clutter' können mit get_shape_model_clutter
abgefragt werden.
'model_cache'
Schaltet einen internen Cache, der auf temporärem Speicher basiert und der
von dem Formmodell bei z.B. find_shape_model verwendet wird, ein
oder aus.
Die Größe des Caches hängt davon ab, wie groß der Parameterraum ist und wie
viele Diskretisierungsschritte der Suchoperator benötigt.
Das bedeutet, dass der Speicherverbrauch sowohl durch kleine Schrittweiten in
AngleStep und ScaleStep als auch durch die Festlegung
eines großen Parameterraums mittels AngleExtent sowie
ScaleMin und ScaleMax erhöht wird. Wenn man
'model_cache' ausschaltet
(durch Setzen auf 'false'), führt das manchmal zu einer leicht
längerer Laufzeit, aber konstant kleinem Speicherverbrauch, was besonders
für Anwendungen auf Embedded-Systemen wichtig ist. Standardmäßig ist der
Cache eingeschaltet ('true').
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.
ModelID (input_control, Zustand wird modifiziert) shape_model → (handle)
Handle des Modells.
GenParamName (input_control) attribute.name-array → (string)
Parameternamen.
Werteliste: 'border_shape_models', 'min_contrast', 'model_cache', 'timeout', 'use_clutter'
GenParamValue (input_control) attribute.value-array → (real / integer / string)
Parameterwerte.
Werteliste: 'false', 'system', 'true'
Sind die Parameterwerte korrekt, dann liefert
set_shape_model_param den Wert 2 (
H_MSG_TRUE)
. Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
create_shape_model_xld,
create_scaled_shape_model_xld,
create_aniso_shape_model_xld
find_shape_model,
find_scaled_shape_model,
find_aniso_shape_model
create_shape_model_xld,
create_scaled_shape_model_xld,
create_aniso_shape_model_xld,
set_shape_model_clutter,
get_shape_model_clutter
Matching