KlassenKlassenKlassenKlassen | | | | Operatoren

inspect_shape_modelinspect_shape_modelInspectShapeModelinspect_shape_modelInspectShapeModelInspectShapeModel (Operator)

Name

inspect_shape_modelinspect_shape_modelInspectShapeModelinspect_shape_modelInspectShapeModelInspectShapeModel — Repräsentation eines Formmodells.

Signatur

inspect_shape_model(Image : ModelImages, ModelRegions : NumLevels, Contrast : )

Herror inspect_shape_model(const Hobject Image, Hobject* ModelImages, Hobject* ModelRegions, const Hlong NumLevels, const Hlong Contrast)

Herror T_inspect_shape_model(const Hobject Image, Hobject* ModelImages, Hobject* ModelRegions, const Htuple NumLevels, const Htuple Contrast)

Herror inspect_shape_model(Hobject Image, Hobject* ModelImages, Hobject* ModelRegions, const HTuple& NumLevels, const HTuple& Contrast)

HImageArray HImage::InspectShapeModel(HRegionArray* ModelRegions, const HTuple& NumLevels, const HTuple& Contrast) const

void InspectShapeModel(const HObject& Image, HObject* ModelImages, HObject* ModelRegions, const HTuple& NumLevels, const HTuple& Contrast)

HImage HImage::InspectShapeModel(HRegion* ModelRegions, Hlong NumLevels, const HTuple& Contrast) const

HImage HImage::InspectShapeModel(HRegion* ModelRegions, Hlong NumLevels, Hlong Contrast) const

void HOperatorSetX.InspectShapeModel(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*ModelImages, [out] IHUntypedObjectX*ModelRegions, [in] VARIANT NumLevels, [in] VARIANT Contrast)

IHImageX* HImageX.InspectShapeModel(
[out] IHRegionX*ModelRegions, [in] Hlong NumLevels, [in] VARIANT Contrast)

static void HOperatorSet.InspectShapeModel(HObject image, out HObject modelImages, out HObject modelRegions, HTuple numLevels, HTuple contrast)

HImage HImage.InspectShapeModel(out HRegion modelRegions, int numLevels, HTuple contrast)

HImage HImage.InspectShapeModel(out HRegion modelRegions, int numLevels, int contrast)

Beschreibung

inspect_shape_modelinspect_shape_modelInspectShapeModelinspect_shape_modelInspectShapeModelInspectShapeModel erzeugt eine Repräsentation eines Formmodells. Der Operator ist insbesondere dazu nützlich, um die Parameter NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels und ContrastContrastContrastContrastContrastcontrast, die bei create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel oder create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel verwendet werden, einfach und schnell zu bestimmen. Die Repräsentation des Modells wird auf mehreren Pyramidenebenen generiert, wobei die Anzahl der Pyramidenebenen durch NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels bestimmt wird. Im Gegensatz zu create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel und create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel wird das Modell nur in der im Eingabebild ImageImageImageImageImageimage vorliegenden Rotation und Skalierung, also 0° und 1, erzeugt. Als Ausgabe erzeugt inspect_shape_modelinspect_shape_modelInspectShapeModelinspect_shape_modelInspectShapeModelInspectShapeModel ein Bildobjekt ModelImagesModelImagesModelImagesModelImagesModelImagesmodelImages mit den Bildern der einzelnen Pyramidenstufen, sowie eine Region in ModelRegionsModelRegionsModelRegionsModelRegionsModelRegionsmodelRegions für jede Pyramidenstufe, die das Modell auf dieser Pyramidenstufe repräsentiert. Auf die einzelnen Objekte der jeweiligen Pyramidenstufe kann mit select_objselect_objSelectObjselect_objSelectObjSelectObj zugegriffen werden. Falls das Eingabebild ImageImageImageImageImageimage einen Kanal besitzt, wird zur Berechnung der Repräsentation des Modells das Verfahren verwendet, das auch bei create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel oder create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel für die Metriken 'use_polarity'"use_polarity""use_polarity""use_polarity""use_polarity""use_polarity", 'ignore_global_polarity'"ignore_global_polarity""ignore_global_polarity""ignore_global_polarity""ignore_global_polarity""ignore_global_polarity" und 'ignore_local_polarity'"ignore_local_polarity""ignore_local_polarity""ignore_local_polarity""ignore_local_polarity""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'"ignore_color_polarity""ignore_color_polarity""ignore_color_polarity""ignore_color_polarity""ignore_color_polarity" verwendet wird. Wie bei create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel oder create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel 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 ContrastContrastContrastContrastContrastcontrast sollte so gewählt werden, dass nur die signifikanten Merkmale des Musters für das Modell verwendet werden. ContrastContrastContrastContrastContrastcontrast 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_imageedges_imageEdgesImageedges_imageEdgesImageEdgesImage 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_thresholdhysteresis_thresholdHysteresisThresholdhysteresis_thresholdHysteresisThresholdHysteresisThreshold. Optional kann in ContrastContrastContrastContrastContrastcontrast 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 ContrastContrastContrastContrastContrastcontrast übergeben werden, von denen die ersten zwei auf denselben Wert gesetzt werden. In der normalen Verwendung wird inspect_shape_modelinspect_shape_modelInspectShapeModelinspect_shape_modelInspectShapeModelInspectShapeModel mehrmals interaktiv mit unterschiedlichen Werten für NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels und ContrastContrastContrastContrastContrastcontrast aufgerufen, bis ein zufriedenstellendes Modell entsteht. Hierauf werden create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel oder create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel mit den so bestimmten Parametern aufgerufen.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  (multichannel-)image objectHImageHImageHImageHImageXHobject (byte / uint2)

Eingabebild.

ModelImagesModelImagesModelImagesModelImagesModelImagesmodelImages (output_object)  (multichannel-)image-array objectHImageHImageHImageArrayHImageXHobject * (byte / uint2)

Bildpyramide des Eingagebildes.

ModelRegionsModelRegionsModelRegionsModelRegionsModelRegionsmodelRegions (output_object)  region-array objectHRegionHRegionHRegionArrayHRegionXHobject *

Model-Regionen-Pyramide.

NumLevelsNumLevelsNumLevelsNumLevelsNumLevelsnumLevels (input_control)  integer HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Anzahl von Pyramidenebenen.

Defaultwert: 4

Werteliste: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10

ContrastContrastContrastContrastContrastcontrast (input_control)  number(-array) HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

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

Ergebnis

Sind die Parameterwerte korrekt, dann liefert inspect_shape_modelinspect_shape_modelInspectShapeModelinspect_shape_modelInspectShapeModelInspectShapeModel den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

reduce_domainreduce_domainReduceDomainreduce_domainReduceDomainReduceDomain

Nachfolger

select_objselect_objSelectObjselect_objSelectObjSelectObj

Siehe auch

create_shape_modelcreate_shape_modelCreateShapeModelcreate_shape_modelCreateShapeModelCreateShapeModel, create_scaled_shape_modelcreate_scaled_shape_modelCreateScaledShapeModelcreate_scaled_shape_modelCreateScaledShapeModelCreateScaledShapeModel, create_aniso_shape_modelcreate_aniso_shape_modelCreateAnisoShapeModelcreate_aniso_shape_modelCreateAnisoShapeModelCreateAnisoShapeModel

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren