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-Schwellwert-Verfahren in
edges_image
ist, eingesetzt. Dabei ist der erste Wert des
Tupels der untere Schwellwert und der zweite Wert der obere
Schwellwert. Für weitere Informationen über das
Hysterese-Schwellwert-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.
Dieser Schwellwert wird pro Pyramidenstufe halbiert. Falls eine
Unterdrückung von kleinen Modellkomponenten gewünscht ist, aber
keine Hysterese-Schwellwert-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 Eingagebildes.
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)
Schwellwert bzw. Hystereseschwellwerte 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.
create_shape_model
,
create_scaled_shape_model
,
create_aniso_shape_model
Foundation