get_dl_classifier_resultT_get_dl_classifier_resultGetDlClassifierResultGetDlClassifierResultget_dl_classifier_result (Operator)
Name
get_dl_classifier_resultT_get_dl_classifier_resultGetDlClassifierResultGetDlClassifierResultget_dl_classifier_result — Abrufen der Inferenz-Ergebnisse eines Deep Learning-basierten
Klassifikators.
Warnung
get_dl_classifier_resultget_dl_classifier_resultGetDlClassifierResultGetDlClassifierResultGetDlClassifierResultget_dl_classifier_result ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt.
Signatur
def get_dl_classifier_result(dlclassifier_result_handle: HHandle, index: Union[int, str], gen_result_name: MaybeSequence[str]) -> Sequence[Union[str, float, int]]
def get_dl_classifier_result_s(dlclassifier_result_handle: HHandle, index: Union[int, str], gen_result_name: MaybeSequence[str]) -> Union[str, float, int]
Beschreibung
get_dl_classifier_resultget_dl_classifier_resultGetDlClassifierResultGetDlClassifierResultGetDlClassifierResultget_dl_classifier_result ermöglicht den Abruf der
Inferenz-Resultate. Diese Resultate sind in
DLClassifierResultHandleDLClassifierResultHandleDLClassifierResultHandleDLClassifierResultHandleDLClassifierResultHandledlclassifier_result_handle gespeichert und wurden über
apply_dl_classifierapply_dl_classifierApplyDlClassifierApplyDlClassifierApplyDlClassifierapply_dl_classifier erhalten.
Die Eingabeparameter GenResultNameGenResultNameGenResultNameGenResultNamegenResultNamegen_result_name und IndexIndexIndexIndexindexindex geben an,
welche Ergebnisse für welches Bild zurückgegeben werden sollen.
Das entsprechende Ergebnis wird in GenResultValueGenResultValueGenResultValueGenResultValuegenResultValuegen_result_value gegeben.
GenResultNameGenResultNameGenResultNameGenResultNamegenResultNamegen_result_name kann folgende Werte annehmen:
- 'confidences'"confidences""confidences""confidences""confidences""confidences":
-
gibt die Konfidenzwerte passend zum
ausgewählten Bildindex IndexIndexIndexIndexindexindex zurück.
- 'predicted_classes'"predicted_classes""predicted_classes""predicted_classes""predicted_classes""predicted_classes":
-
gibt die Klassennamen passend
zum ausgewählten Bildindex IndexIndexIndexIndexindexindex zurück.
- 'predicted_class_indices'"predicted_class_indices""predicted_class_indices""predicted_class_indices""predicted_class_indices""predicted_class_indices":
gibt die Klassenindizes
passend zum ausgewählten Bildindex IndexIndexIndexIndexindexindex zurück. Dabei
geben die Klassenindizes die jeweiligen Positionen (von 0
startend) in dem Tupel der Klassen an.
Wenn der Parameter IndexIndexIndexIndexindexindex den Wert 'all'"all""all""all""all""all" annimmt, gibt
get_dl_classifier_resultget_dl_classifier_resultGetDlClassifierResultGetDlClassifierResultGetDlClassifierResultget_dl_classifier_result den Konfidenzwert, bzw. den Klassennamen,
des besten Kandidaten (Vorhersage mit größtem Konfidenzwert) eines jeden
Bildes.
Ansonsten muss IndexIndexIndexIndexindexindex eine Ganzzahl aus dem Intervall 0
bis Batchgröße minus eins sein und gibt an, für welches Bild des Batches
alle Konfidenzwerten, bzw. Klassennamen, zurückgegeben werden sollen.
Diese Rückgabewerte sind nach absteigendem
Konfidenzwert sortiert. Das ist z.B. nützlich bei der Bestimmung der besten
Kandidaten einer Menge an Bildern.
Das Konzept der Deep Learning-basierten Klassifikation ist in der Einleitung
zu Kapitel Deep Learning / Klassifikation beschrieben.
Der Ablauf mit diesem veralteten Operator ist im Kapitel
Legacy / DL Klassifikation beschrieben.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
DLClassifierResultHandleDLClassifierResultHandleDLClassifierResultHandleDLClassifierResultHandleDLClassifierResultHandledlclassifier_result_handle (input_control) dl_classifier_result → HDlClassifierResult, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle der Ergebnisse eines
Deep Learning-basierten Klassifikators.
IndexIndexIndexIndexindexindex (input_control) number → HTupleUnion[int, str]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Index des Bildes innerhalb des Batches.
Defaultwert:
'all'
"all"
"all"
"all"
"all"
"all"
GenResultNameGenResultNameGenResultNameGenResultNamegenResultNamegen_result_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name des generischen Parameters.
Defaultwert:
'predicted_classes'
"predicted_classes"
"predicted_classes"
"predicted_classes"
"predicted_classes"
"predicted_classes"
Werteliste: 'confidences'"confidences""confidences""confidences""confidences""confidences", 'predicted_class_indices'"predicted_class_indices""predicted_class_indices""predicted_class_indices""predicted_class_indices""predicted_class_indices", 'predicted_classes'"predicted_classes""predicted_classes""predicted_classes""predicted_classes""predicted_classes"
GenResultValueGenResultValueGenResultValueGenResultValuegenResultValuegen_result_value (output_control) attribute.value(-array) → HTupleSequence[Union[str, float, int]]HTupleHtuple (real / string / integer) (double / string / int / long) (double / HString / Hlong) (double / char* / Hlong)
Wert des generischen Parameters, entweder die
Konfidenzwerte, die Klassennamen oder Klassenindizes.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
get_dl_classifier_resultget_dl_classifier_resultGetDlClassifierResultGetDlClassifierResultGetDlClassifierResultget_dl_classifier_result den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Vorgänger
apply_dl_classifierapply_dl_classifierApplyDlClassifierApplyDlClassifierApplyDlClassifierapply_dl_classifier
Nachfolger
clear_dl_classifier_resultclear_dl_classifier_resultClearDlClassifierResultClearDlClassifierResultClearDlClassifierResultclear_dl_classifier_result
Modul
Deep Learning Inference