learn_ndim_boxT_learn_ndim_boxLearnNdimBoxLearnNdimBoxlearn_ndim_box (Operator)

Name

learn_ndim_boxT_learn_ndim_boxLearnNdimBoxLearnNdimBoxlearn_ndim_box — Trainieren eines Klassifikators mit mehrkanaligen Bildern.

Warnung

learn_ndim_boxlearn_ndim_boxLearnNdimBoxLearnNdimBoxlearn_ndim_box ist veraltet und wird nur aus Gründen der Rückwärtskompatibilität zur Verfügung gestellt.

Signatur

learn_ndim_box(Foreground, Background, MultiChannelImage : : ClassifHandle : )

Herror T_learn_ndim_box(const Hobject Foreground, const Hobject Background, const Hobject MultiChannelImage, const Htuple ClassifHandle)

void LearnNdimBox(const HObject& Foreground, const HObject& Background, const HObject& MultiChannelImage, const HTuple& ClassifHandle)

void HImage::LearnNdimBox(const HRegion& Foreground, const HRegion& Background, const HClassBox& ClassifHandle) const

void HRegion::LearnNdimBox(const HRegion& Background, const HImage& MultiChannelImage, const HClassBox& ClassifHandle) const

void HClassBox::LearnNdimBox(const HRegion& Foreground, const HRegion& Background, const HImage& MultiChannelImage) const

static void HOperatorSet.LearnNdimBox(HObject foreground, HObject background, HObject multiChannelImage, HTuple classifHandle)

void HImage.LearnNdimBox(HRegion foreground, HRegion background, HClassBox classifHandle)

void HRegion.LearnNdimBox(HRegion background, HImage multiChannelImage, HClassBox classifHandle)

void HClassBox.LearnNdimBox(HRegion foreground, HRegion background, HImage multiChannelImage)

def learn_ndim_box(foreground: HObject, background: HObject, multi_channel_image: HObject, classif_handle: HHandle) -> None

Beschreibung

learn_ndim_boxlearn_ndim_boxLearnNdimBoxLearnNdimBoxlearn_ndim_box trainiert den Klassifikator ClassifHandleClassifHandleClassifHandleclassifHandleclassif_handle mit den Bildpunkten des mehrkanaligen Eingabebildes der Region, die durch ForegroundForegroundForegroundforegroundforeground angegeben wird. Die Punkte in BackgroundBackgroundBackgroundbackgroundbackground sollen von dem Klassifikator zurückgewiesen werden. Der so trainierte Klassifikator kann für class_ndim_boxclass_ndim_boxClassNdimBoxClassNdimBoxclass_ndim_box zur Segmentierung von Bildern verwendet werden. ForegroundForegroundForegroundforegroundforeground soll gefunden werden, BackgroundBackgroundBackgroundbackgroundbackground sind die Bildteile, die nicht gefunden werden sollen.

Beim Trainingsvorgang wird jedes Pixel einmal trainiert. Für Bildpunkte aus ForegroundForegroundForegroundforegroundforeground wird die Klasse „0“, für BackgroundBackgroundBackgroundbackgroundbackground die Klasse „1“ verwendet. Es wird abwechselnd mit einem Bildpunkt aus ForegroundForegroundForegroundforegroundforeground und einem aus BackgroundBackgroundBackgroundbackgroundbackground trainiert. Falls eine Region kleiner ist, wird zyklisch von vorne begonnen, bis die andere abgearbeitet ist. learn_ndim_boxlearn_ndim_boxLearnNdimBoxLearnNdimBoxlearn_ndim_box akzeptiert später bei der Segmentierung nur die Bildpunkte, die der Klasse „0“ zugeordnet werden.

Aus Anwendersicht besteht der wesentliche Unterschied zwischen learn_ndim_normlearn_ndim_normLearnNdimNormLearnNdimNormlearn_ndim_norm und learn_ndim_boxlearn_ndim_boxLearnNdimBoxLearnNdimBoxlearn_ndim_box darin, dass bei letzterem die BackgroundBackgroundBackgroundbackgroundbackground-Klasse den Klassifikationsprozess selbst mitsteuert. Hier wird eine Trennfläche zwischen ForegroundForegroundForegroundforegroundforeground- und BackgroundBackgroundBackgroundbackgroundbackground-Klasse erzeugt, so dass keine Punkte im Merkmalsraum falsch klassifiziert werden. Bei learn_ndim_normlearn_ndim_normLearnNdimNormLearnNdimNormlearn_ndim_norm dagegen ist eine Überlappung von ForegroundForegroundForegroundforegroundforeground- und BackgroundBackgroundBackgroundbackgroundbackground-Klasse erlaubt. Dies schlägt sich dann im Rückgabewert Quality nieder: Je größer die Überlappung, desto kleiner die Güte der Klassifikation.

Achtung

Alle Kanäle müssen von dem gleichen Typ sein.

Ausführungsinformationen

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.

Parameter

ForegroundForegroundForegroundforegroundforeground (input_object)  region(-array) objectHRegionHObjectHObjectHobject

Zu trainierende Vordergrundpunkte.

BackgroundBackgroundBackgroundbackgroundbackground (input_object)  region(-array) objectHRegionHObjectHObjectHobject

Zu trainierende Hintergrundpunkte (Rückweisungsklasse).

MultiChannelImageMultiChannelImageMultiChannelImagemultiChannelImagemulti_channel_image (input_object)  (multichannel-)image(-array) objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / int4 / real)

Mehrkanaliges Bild.

ClassifHandleClassifHandleClassifHandleclassifHandleclassif_handle (input_control, Zustand wird modifiziert)  class_box HClassBox, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des Klassifikators.

Komplexität

Sei N die Anzahl der erzeugten Hyperquader und A die Fläche der größeren Eingaberegion. Dann ist die Laufzeitkomplexität O(N * A).

Ergebnis

learn_ndim_boxlearn_ndim_boxLearnNdimBoxLearnNdimBoxlearn_ndim_box liefert den Wert 2 ( H_MSG_TRUE) , falls die Parameter korrekt sind und ein Klassifikator aktiv ist. Für das Verhalten bzgl. der Eingabebilder sind die Flags 'no_object_result'"no_object_result""no_object_result""no_object_result""no_object_result" und 'empty_region_result'"empty_region_result""empty_region_result""empty_region_result""empty_region_result" einstellbar (siehe set_systemset_systemSetSystemSetSystemset_system). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_class_boxcreate_class_boxCreateClassBoxCreateClassBoxcreate_class_box, draw_regiondraw_regionDrawRegionDrawRegiondraw_region

Nachfolger

class_ndim_boxclass_ndim_boxClassNdimBoxClassNdimBoxclass_ndim_box, descript_class_boxdescript_class_boxDescriptClassBoxDescriptClassBoxdescript_class_box

Alternativen

learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxlearn_class_box, learn_ndim_normlearn_ndim_normLearnNdimNormLearnNdimNormlearn_ndim_norm

Modul

Foundation