create_class_lut_svmT_create_class_lut_svmCreateClassLutSvmCreateClassLutSvmcreate_class_lut_svm (Operator)

Name

create_class_lut_svmT_create_class_lut_svmCreateClassLutSvmCreateClassLutSvmcreate_class_lut_svm — Erzeugen einer Look-Up-Table anhand einer Support-Vektor-Maschine zur Klassifizierung von Byte-Bildern.

Signatur

create_class_lut_svm( : : SVMHandle, GenParamName, GenParamValue : ClassLUTHandle)

Herror T_create_class_lut_svm(const Htuple SVMHandle, const Htuple GenParamName, const Htuple GenParamValue, Htuple* ClassLUTHandle)

void CreateClassLutSvm(const HTuple& SVMHandle, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* ClassLUTHandle)

HClassLUT HClassSvm::CreateClassLutSvm(const HTuple& GenParamName, const HTuple& GenParamValue) const

void HClassLUT::HClassLUT(const HClassSvm& SVMHandle, const HTuple& GenParamName, const HTuple& GenParamValue)

void HClassLUT::CreateClassLutSvm(const HClassSvm& SVMHandle, const HTuple& GenParamName, const HTuple& GenParamValue)

static void HOperatorSet.CreateClassLutSvm(HTuple SVMHandle, HTuple genParamName, HTuple genParamValue, out HTuple classLUTHandle)

HClassLUT HClassSvm.CreateClassLutSvm(HTuple genParamName, HTuple genParamValue)

public HClassLUT(HClassSvm SVMHandle, HTuple genParamName, HTuple genParamValue)

void HClassLUT.CreateClassLutSvm(HClassSvm SVMHandle, HTuple genParamName, HTuple genParamValue)

def create_class_lut_svm(svmhandle: HHandle, gen_param_name: Sequence[str], gen_param_value: Sequence[Union[str, int]]) -> HHandle

Beschreibung

create_class_lut_svmcreate_class_lut_svmCreateClassLutSvmCreateClassLutSvmCreateClassLutSvmcreate_class_lut_svm erzeugt eine Look-Up Table (LUT) ClassLUTHandleClassLUTHandleClassLUTHandleClassLUTHandleclassLUTHandleclass_luthandle anhand einer trainierten Support-Vector-Maschine (SVM) SVMHandleSVMHandleSVMHandleSVMHandleSVMHandlesvmhandle zur Klassifizierung von mehrkanaligen Byte-Bildern. Mit diesem SVM-basierten LUT Klassifikator kann der Operator classify_image_class_svmclassify_image_class_svmClassifyImageClassSvmClassifyImageClassSvmClassifyImageClassSvmclassify_image_class_svm, der für die spätere Klassifikation benötigt wird, durch den Operator classify_image_class_lutclassify_image_class_lutClassifyImageClassLutClassifyImageClassLutClassifyImageClassLutclassify_image_class_lut ersetzt werden. Die Klassifikation wird dadurch deutlich beschleunigt, weil die entsprechende Klasse nicht in jedem Bildpunkt extra berechnet werden muss, da alle möglichen Antworten der SVM in der LUT gespeichert sind. Für die Erzeugung der LUT sind die im zuvor aufgerufenen Operator create_class_svmcreate_class_svmCreateClassSvmCreateClassSvmCreateClassSvmcreate_class_svm definierten Parameter NumFeatures, Preprocessing und NumComponents von Bedeutung. In NumFeatures ist festgelegt, wie viele Kanäle die zu klassifizierenden Bilder haben dürfen. Über das Preprocessing (siehe create_class_svmcreate_class_svmCreateClassSvmCreateClassSvmCreateClassSvmcreate_class_svm) kann diese Anzahl auf NumComponents transformiert werden. NumComponents beschreibt schließlich die Größe des Merkmalsvektors, der vom Klassifikator classify_class_svmclassify_class_svmClassifyClassSvmClassifyClassSvmClassifyClassSvmclassify_class_svm intern verarbeitet wird. Aufgrund von Performance und Speicherverwaltung ist die LUT auf maximal 3 Dimensionen beschränkt. Da sie den Operator classify_class_svmclassify_class_svmClassifyClassSvmClassifyClassSvmClassifyClassSvmclassify_class_svm ersetzt, muss NumComponents <= 3 gelten. Findet keine Transformation mit Reduktion in den Bildkanälen statt (NumFeatures = NumComponents) werden beim Erzeugen der LUT alle möglichen Pixelwerte, die in einem Byte-Bild vorkommen können, mit classify_class_svmclassify_class_svmClassifyClassSvmClassifyClassSvmClassifyClassSvmclassify_class_svm klassifiziert und die resultierenden Klassen in der LUT gespeichert. Findet eine Transformation mit Reduktion der Bildkanäle statt (NumFeatures > NumComponents) werden die Vorverarbeitungsparameter der SVM in einer separaten Struktur der LUT gespeichert. Beim Erzeugen der LUT werden alle transformierten Pixelwerte mit classify_class_svmclassify_class_svmClassifyClassSvmClassifyClassSvmClassifyClassSvmclassify_class_svm klassifiziert und die resultierenden Klassen in der LUT gespeichert. Aufgrund der diskreten Struktur der LUT kann es dabei zu einem Genauigkeitsverlust gegenüber der Klassifizierung mit classify_image_class_svmclassify_image_class_svmClassifyImageClassSvmClassifyImageClassSvmClassifyImageClassSvmclassify_image_class_svm kommen. Über die Parameter 'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" und 'class_selection'"class_selection""class_selection""class_selection""class_selection""class_selection" kann die Klassifizierungsgenauigkeit, der Speicherbedarf und die Laufzeit zur Erzeugung der LUT angepasst werden.

Die folgenden Parameter des SVM-basierten LUT Klassifikators können mit GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value gesetzt werden:

'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth":

Anzahl der verwendeten Bits der Bildpixel. 'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" steuert den Speicherbedarf der LUT und ist durch die Bittiefe des Bildes beschränkt ('bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" <= 8). Ist die Bittiefe der LUT kleiner ('bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" < 8), werden die Klassen von mehreren Pixelkombinationen auf den selben Eintrag der LUT abgebildet, was die Klassifizierungsgenauigkeit verringern kann. Einer dieser Cluster enthält Pixelkombinationen, wobei NumComponents die in create_class_svmcreate_class_svmCreateClassSvmCreateClassSvmCreateClassSvmcreate_class_svm spezifizierte Dimension der LUT beschreibt. Für 'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" = 7, NumComponents = 3 werden beispielsweise die Klassen von 8 Pixelkombinationen auf den selben Eintrag der LUT abgebildet. Die LUT benötigt maximal Bytes vom Speicher. Für NumComponents = 3, 'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" = 8 und NumClasses < 16 (angegeben in create_class_svmcreate_class_svmCreateClassSvmCreateClassSvmCreateClassSvmcreate_class_svm) werden beispielsweise durch eine interne Speicheroptimierung nur 8 MB Speicher für die LUT benötigt. Gilt NumClasses = 1, benötigt die LUT bei voller Bittiefe nur 2 MB Speicher. Die Laufzeit der Klassifizierung in classify_image_class_lutclassify_image_class_lutClassifyImageClassLutClassifyImageClassLutClassifyImageClassLutclassify_image_class_lut wird minimal, falls die LUT in den Cache passt. Defaultwert ist 8, typische Werte sind [6,7,8]. Beschränkungen: 'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" >= 1, 'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" <= 8.

'class_selection'"class_selection""class_selection""class_selection""class_selection""class_selection":

Methode zur Klassenauswahl für die LUT. Kann angepasst werden um die spätere Klassifizierungsgenauigkeit und die Laufzeit zur Erzeugung der LUT zu steuern. Der Wert für 'class_selection'"class_selection""class_selection""class_selection""class_selection""class_selection" wird ignoriert, falls die Bittiefe der LUT maximal ist, also 'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" = 8 gilt. Ist die Bittiefe der LUT kleiner ('bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth" < 8), werden die Klassen von mehreren Pixelkombinationen auf den selben Eintrag der LUT abgebildet. Einer dieser Cluster enthält Pixelkombinationen, wobei NumComponents die in create_class_gmmcreate_class_gmmCreateClassGmmCreateClassGmmCreateClassGmmcreate_class_gmm spezifizierte Dimension der LUT beschreibt. Gilt 'class_selection'"class_selection""class_selection""class_selection""class_selection""class_selection" = 'best'"best""best""best""best""best", wird die Klasse gespeichert, die am häufigsten im Cluster vorkommt. Für 'class_selection'"class_selection""class_selection""class_selection""class_selection""class_selection" = 'fast'"fast""fast""fast""fast""fast" wird nur der Pixel im Cluster klassifiziert, der den kleinsten Wert (komponentenweise) hat, was jedoch die Genauigkeit bei der späteren Klassifizierung über die LUT verringern kann. Allerdings lässt sich dadurch die Laufzeit zur Erzeugung der LUT reduzieren. Sie verhält sich proportional zum maximal benötigten Speicherplatz der LUT, der mit definiert ist. Defaultwert ist 'fast'"fast""fast""fast""fast""fast", mögliche Werte sind ['fast'"fast""fast""fast""fast""fast", 'best'"best""best""best""best""best"].

Ausführungsinformationen

Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.

Parameter

SVMHandleSVMHandleSVMHandleSVMHandleSVMHandlesvmhandle (input_control)  class_svm HClassSvm, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle der SVM.

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name-array HTupleSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Namen der generischen Parameter, die für die Erzeugung des LUT Klassifikators angepasst werden können.

Defaultwert: []

Wertevorschläge: 'bit_depth'"bit_depth""bit_depth""bit_depth""bit_depth""bit_depth", 'class_selection'"class_selection""class_selection""class_selection""class_selection""class_selection"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control)  attribute.value-array HTupleSequence[Union[str, int]]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)

Werte der generischen Parameter, die für die Erzeugung des LUT Klassifikators angepasst werden können.

Defaultwert: []

Wertevorschläge: 8, 7, 6, 'fast'"fast""fast""fast""fast""fast", 'best'"best""best""best""best""best"

ClassLUTHandleClassLUTHandleClassLUTHandleClassLUTHandleclassLUTHandleclass_luthandle (output_control)  class_lut HClassLUT, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle des LUT Klassifikators.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert create_class_lut_svmcreate_class_lut_svmCreateClassLutSvmCreateClassLutSvmCreateClassLutSvmcreate_class_lut_svm den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Vorgänger

train_class_svmtrain_class_svmTrainClassSvmTrainClassSvmTrainClassSvmtrain_class_svm, read_class_svmread_class_svmReadClassSvmReadClassSvmReadClassSvmread_class_svm

Nachfolger

classify_image_class_lutclassify_image_class_lutClassifyImageClassLutClassifyImageClassLutClassifyImageClassLutclassify_image_class_lut

Alternativen

create_class_lut_gmmcreate_class_lut_gmmCreateClassLutGmmCreateClassLutGmmCreateClassLutGmmcreate_class_lut_gmm, create_class_lut_knncreate_class_lut_knnCreateClassLutKnnCreateClassLutKnnCreateClassLutKnncreate_class_lut_knn, create_class_lut_mlpcreate_class_lut_mlpCreateClassLutMlpCreateClassLutMlpCreateClassLutMlpcreate_class_lut_mlp

Siehe auch

classify_image_class_lutclassify_image_class_lutClassifyImageClassLutClassifyImageClassLutClassifyImageClassLutclassify_image_class_lut, clear_class_lutclear_class_lutClearClassLutClearClassLutClearClassLutclear_class_lut

Modul

Foundation