inspect_shape_model — Repräsentation eines Formmodells.
inspect_shape_model(Image : ModelImages, ModelRegions : NumLevels, Contrast : )
inspect_shape_model erzeugt eine Repräsentation eines
Formmodells. Der Operator ist insbesondere dazu nützlich, um die
Parameter NumLevels und Contrast, die bei
create_shape_model, create_scaled_shape_model oder
create_aniso_shape_model verwendet werden, einfach und
schnell zu bestimmen. Die Repräsentation des Modells wird auf
mehreren Pyramidenebenen generiert, wobei die Anzahl der
Pyramidenebenen durch NumLevels bestimmt wird. Im
Gegensatz zu create_shape_model,
create_scaled_shape_model und
create_aniso_shape_model wird das Modell nur in der im
Eingabebild Image vorliegenden Rotation und Skalierung,
also 0° und 1, erzeugt. Als Ausgabe erzeugt
inspect_shape_model ein Bildobjekt ModelImages mit
den Bildern der einzelnen Pyramidenstufen, sowie eine Region in
ModelRegions für jede Pyramidenstufe, die das Modell auf
dieser Pyramidenstufe repräsentiert. Auf die einzelnen Objekte der
jeweiligen Pyramidenstufe kann mit select_obj zugegriffen
werden. Falls das Eingabebild Image einen Kanal besitzt,
wird zur Berechnung der Repräsentation des Modells das Verfahren
verwendet, das auch bei create_shape_model,
create_scaled_shape_model oder
create_aniso_shape_model für die Metriken
'use_polarity', 'ignore_global_polarity' und
'ignore_local_polarity' verwendet wird. Falls das
Eingabebild mehr als einen Kanal besitzt, wird das Verfahren
verwendet, das für die Metrik 'ignore_color_polarity'
verwendet wird. Wie bei create_shape_model,
create_scaled_shape_model oder
create_aniso_shape_model beschrieben, sollten die Anzahl der
Pyramidenebenen möglichst groß gewählt werden, wobei darauf zu
achten ist, dass das Modell auf der obersten Pyramidenstufe noch
erkennbar ist und genügend viele Punkte besitzt. Der Parameter
Contrast sollte so gewählt werden, dass nur die
signifikanten Merkmale des Musters für das Modell verwendet werden.
Contrast kann auch ein Tupel mit zwei Werten enthalten. In
diesem Fall wird bei der Segmentierung des Modells ein Verfahren,
das ähnlich zum Hysterese-Schwellenwert-Verfahren in
edges_image ist, eingesetzt. Dabei ist der erste Wert des
Tupels der untere Schwellenwert und der zweite Wert der obere
Schwellenwert. Für weitere Informationen über das
Hysterese-Schwellenwert-Verfahren siehe hysteresis_threshold.
Optional kann in Contrast auch ein dritter Wert als letztes
Element des Tupels übergeben werden. Dieser Wert dient zur
Selektion von signifikanten Komponenten des Modells basierend auf
der Größe der Komponenten, d.h. Komponenten, deren Anzahl von
Punkten kleiner ist als diese Mindestgröße, werden unterdrückt.
Da sich die Mindestgröße auf die Größe der Komponenten bezieht kann es
auch vorkommen, dass die daraus abgeleiteten Modellkonturen trotzdem
kleiner als die angegebene Mindestgröße sind.
Dieser Schwellenwert wird pro Pyramidenstufe halbiert. Falls eine
Unterdrückung von kleinen Modellkomponenten gewünscht ist, aber
keine Hysterese-Schwellenwert-Operation, müssen dennoch drei Werte in
Contrast übergeben werden, von denen die ersten zwei auf
denselben Wert gesetzt werden. In der normalen Verwendung wird
inspect_shape_model mehrmals interaktiv mit
unterschiedlichen Werten für NumLevels und
Contrast aufgerufen, bis ein zufriedenstellendes Modell
entsteht. Hierauf werden create_shape_model,
create_scaled_shape_model oder
create_aniso_shape_model mit den so bestimmten Parametern
aufgerufen.
Image (input_object) (multichannel-)image → object (byte / uint2)
Eingabebild.
ModelImages (output_object) (multichannel-)image-array → object (byte / uint2)
Bildpyramide des Eingabebildes.
ModelRegions (output_object) region-array → object
Model-Regionen-Pyramide.
NumLevels (input_control) integer → (integer)
Anzahl von Pyramidenebenen.
Defaultwert: 4
Werteliste: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10
Contrast (input_control) number(-array) → (integer)
Schwellenwert bzw. Hystereseschwellenwerte für den Kontrast des Objektes im Bild und optional Mindestgröße der Objektteile.
Defaultwert: 30
Wertevorschläge: 10, 20, 30, 40, 60, 80, 100, 120, 140, 160
Sind die Parameterwerte korrekt, dann liefert
inspect_shape_model den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Foundation