create_deep_ocr — Erstellen eines Deep OCR-Modells.
create_deep_ocr( : : GenParamName, GenParamValue : DeepOcrHandle)
create_deep_ocr erstellt aus vorab trainierten Komponenten ein Deep
OCR-Modell und gibt sein Handle in DeepOcrHandle zurück.
Das Handle beinhaltet alle zur Inferenz erforderlichen Parameter.
Ein Deep OCR-Modell besteht normalerweise aus zwei Komponenten,
die standardmäßig im Verzeichnis $HALCONROOT/dl/ gesucht werden:
'detection_model': Lokalisiert die Worte
(zusammenhängende Zeichen) im Bild.
'recognition_model': Erkennt das Wort innerhalb des
gefundenen Bildteils.
Mit GenParamName und entsprechendem GenParamValue sind
folgende Optionen setzbar:
Bestimmt den Modus und dadurch, welche Komponente ausgeführt wird. Es werden folgende Werte unterstützt:
Nur die Komponente zur Lokalisierung wird ausgeführt. Daher lokalisiert das Modell lediglich die Wortbereiche innerhalb des Bildes.
Nur die Komponente zum Erkennen der Worte wird ausgeführt. Das Modell erwartet einen engen Zuschnitt eines einzelnen Wortes als Eingabe. Bei eingeschalteteter Alignment-Unterstützung kann der Zuschnitt weiter und weniger präzise sein sowie Hintergrund beinhalten. Vor der eigentlichen Erkennung wendet die Alignment-Unterstützung einen Transformationsschritt an, um den Text genau zu positionieren.
Es werden beide Teile ausgeführt, die Lokalisierung und Erkennung der Worte.
Dieser Modus erstellt ein leeres Deep OCR-Modell.
Es werden weder eine Erkennungs- noch eine Lokalisierungskomponente
instanziiert.
Die Erkennungs- und Lokalisierungskomponente können später mit
set_deep_ocr_param gesetzt werden.
Default: 'auto'.
Der Zeichensatz, den das Modell über seine Erkennungskomponente erkennt,
kann mittels get_deep_ocr_param (mit 'recognition_alphabet')
abgerufen werden.
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.
GenParamName (input_control) attribute.name(-array) → (string)
Name des generischen Parameters.
Default: []
Werteliste: 'mode'
GenParamValue (input_control) attribute.value(-array) → (string / integer / real)
Wert des generischen Parameters.
Default: []
Werteliste: 'auto', 'detection', 'empty', 'recognition'
DeepOcrHandle (output_control) deep_ocr → (handle)
Handle des Deep OCR-Modells.
Sind die Parameterwerte korrekt, dann liefert
create_deep_ocr den Wert 2 (
H_MSG_TRUE)
. Gegebenenfalls wird eine
Fehlerbehandlung geworfen.
write_deep_ocr,
apply_deep_ocr,
get_deep_ocr_param,
set_deep_ocr_param
OCR/OCV