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_boxLearnNdimBoxLearnNdimBoxLearnNdimBoxlearn_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_boxLearnNdimBoxLearnNdimBoxLearnNdimBoxlearn_ndim_box trainiert den Klassifikator ClassifHandleClassifHandleClassifHandleClassifHandleclassifHandleclassif_handle mit den Bildpunkten des mehrkanaligen Eingabebildes der Region, die durch ForegroundForegroundForegroundForegroundforegroundforeground angegeben wird. Die Punkte in BackgroundBackgroundBackgroundBackgroundbackgroundbackground sollen von dem Klassifikator zurückgewiesen werden. Der so trainierte Klassifikator kann für class_ndim_boxclass_ndim_boxClassNdimBoxClassNdimBoxClassNdimBoxclass_ndim_box zur Segmentierung von Bildern verwendet werden. ForegroundForegroundForegroundForegroundforegroundforeground soll gefunden werden, BackgroundBackgroundBackgroundBackgroundbackgroundbackground sind die Bildteile, die nicht gefunden werden sollen.

Beim Trainingsvorgang wird jedes Pixel einmal trainiert. Für Bildpunkte aus ForegroundForegroundForegroundForegroundforegroundforeground wird die Klasse „0“, für BackgroundBackgroundBackgroundBackgroundbackgroundbackground die Klasse „1“ verwendet. Es wird abwechselnd mit einem Bildpunkt aus ForegroundForegroundForegroundForegroundforegroundforeground und einem aus BackgroundBackgroundBackgroundBackgroundbackgroundbackground trainiert. Falls eine Region kleiner ist, wird zyklisch von vorne begonnen, bis die andere abgearbeitet ist. learn_ndim_boxlearn_ndim_boxLearnNdimBoxLearnNdimBoxLearnNdimBoxlearn_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_normLearnNdimNormLearnNdimNormLearnNdimNormlearn_ndim_norm und learn_ndim_boxlearn_ndim_boxLearnNdimBoxLearnNdimBoxLearnNdimBoxlearn_ndim_box darin, dass bei letzterem die BackgroundBackgroundBackgroundBackgroundbackgroundbackground-Klasse den Klassifikationsprozess selbst mitsteuert. Hier wird eine Trennfläche zwischen ForegroundForegroundForegroundForegroundforegroundforeground- und BackgroundBackgroundBackgroundBackgroundbackgroundbackground-Klasse erzeugt, so dass keine Punkte im Merkmalsraum falsch klassifiziert werden. Bei learn_ndim_normlearn_ndim_normLearnNdimNormLearnNdimNormLearnNdimNormlearn_ndim_norm dagegen ist eine Überlappung von ForegroundForegroundForegroundForegroundforegroundforeground- und BackgroundBackgroundBackgroundBackgroundbackgroundbackground-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

ForegroundForegroundForegroundForegroundforegroundforeground (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Zu trainierende Vordergrundpunkte.

BackgroundBackgroundBackgroundBackgroundbackgroundbackground (input_object)  region(-array) objectHRegionHObjectHRegionHobject

Zu trainierende Hintergrundpunkte (Rückweisungsklasse).

MultiChannelImageMultiChannelImageMultiChannelImageMultiChannelImagemultiChannelImagemulti_channel_image (input_object)  (multichannel-)image(-array) objectHImageHObjectHImageHobject (byte / direction / cyclic / int1 / int2 / int4 / real)

Mehrkanaliges Bild.

ClassifHandleClassifHandleClassifHandleClassifHandleclassifHandleclassif_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_boxLearnNdimBoxLearnNdimBoxLearnNdimBoxlearn_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""no_object_result" und 'empty_region_result'"empty_region_result""empty_region_result""empty_region_result""empty_region_result""empty_region_result" einstellbar (siehe set_systemset_systemSetSystemSetSystemSetSystemset_system). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

create_class_boxcreate_class_boxCreateClassBoxCreateClassBoxCreateClassBoxcreate_class_box, draw_regiondraw_regionDrawRegionDrawRegionDrawRegiondraw_region

Nachfolger

class_ndim_boxclass_ndim_boxClassNdimBoxClassNdimBoxClassNdimBoxclass_ndim_box, descript_class_boxdescript_class_boxDescriptClassBoxDescriptClassBoxDescriptClassBoxdescript_class_box

Alternativen

learn_class_boxlearn_class_boxLearnClassBoxLearnClassBoxLearnClassBoxlearn_class_box, learn_ndim_normlearn_ndim_normLearnNdimNormLearnNdimNormLearnNdimNormlearn_ndim_norm

Modul

Foundation