read_dl_model — Lesen eines Deep Learning-Modells aus einer Datei.
read_dl_model( : : FileName : DLModelHandle)
Der Operator read_dl_model liest ein Deep Learning-Modell, welches
mit write_dl_model geschrieben wurde.
Als Ergebnis wird das Handle DLModelHandle zurückgegeben.
Das Modell wird aus der Datei FileName geladen.
Die Datei wird hierbei sowohl im Verzeichnis $HALCONROOT/dl/, als
auch im aktuell genutzten Verzeichnis gesucht.
Zu beachten ist, dass der laufzeitspezifische Parameter 'gpu' des
Modells nicht aus der Datei gelesen wird. Stattdessen wird er mit
seinem Standardwert (siehe get_dl_model_param) initialisiert.
HALCON stellt Neuronale Netzwerke für die Klassifikation und semantische
Segmentierung bereit, welche auf einem großen Datensatz vortrainiert wurden.
Diese Neuronalen Netzwerke sind gute Ausgangspunkte, um damit eigene
Neuronale Netze für ein individuelles Problem zu trainieren.
Man beachte, dass Netzwerke für die Klassifikation nur mit Hilfe des
Operators read_dl_classifier gelesen werden können.
Für die Objektdetektion werden vortrainierte Klassifikations-Netzwerke beim
Einlesen durch weitere Elemente ergänzt, hierfür steht der Operator
create_dl_model_detection zur Verfügung.
Folgende vortainierte Netzwerke stehen für die semantischen Segmentierung zur Verfügung:
Dieses Neuronale Netzwerk ist besonders für feine Strukturen geeigenet und ist effizient bezüglich des Speicherverbrauchs und der Laufzeit.
Die Netzwerkarchitektur erlaubt Änderungen der Bilddimensionen, verlangt aber eine minimale Bildbreite 'image_width' von 21 Pixeln und eine minimale Bildhöhe von 'image_height' 21 Pixeln.
Dieses Neuronale Netzwerk hat mehr verborgene Layer als 'pretrained_dl_segmentation_compact.hdl' und ist daher für Segmentierungsaufgaben in komplexeren Szenarien besser geeignet.
Die Netzwerkarchitektur erlaubt Änderungen der Bilddimensionen, verlangt aber eine minimale Bildbreite 'image_width' von 81 Pixeln und eine minimale Bildhöhe von 'image_height' 81 Pixeln.
Für weitere Informationen zu Deep Learning-Modellen in HALCON siehe das Kapitel Deep Learning / Modell.
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.
FileName (input_control) filename.read → (string)
Dateiname
Defaultwert: 'pretrained_dl_segmentation_compact.hdl'
Werteliste: 'pretrained_dl_segmentation_compact.hdl', 'pretrained_dl_segmentation_enhanced.hdl'
Dateiendung: .hdl
DLModelHandle (output_control) dl_model → (handle)
Handle des Deep Learning-Modells.
Sind die Parameterwerte korrekt, dann liefert
read_dl_model den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
set_dl_model_param,
get_dl_model_param,
apply_dl_model,
train_dl_model_batch
Deep Learning Training