Fehlerbehebung

Im Bild ist nichts Lesbares: ein leerer Träger, ein falsch herum liegendes Teil oder ein Etikett außerhalb des Bildes. Das ist die normale Antwort, kein Fehler.

Die Kennzeichnung liegt außerhalb des Ausschnitts. Eine Kennzeichnung, die aus dem Ausschnitt herauswandert, wird als nichts gelesen.

Die Kennzeichnung ist nicht im Fokus oder steht nicht richtig herum.

input/min-score filtert alle Wörter heraus. words[] wird nach min-score gefiltert; text nicht.

Ein Farbbild, in dem ein Foto oder eine andere farbenfrohe Szene zusammen mit dem Text im Bild ist, siehe Problem: Das Leseergebnis ist leer, obwohl der Text in einem Farbbild deutlich sichtbar ist.

Wenn im Bild kein Text ist: Das ist ein gültiges Ergebnis. Entscheiden Sie anhand von word_count, nicht anhand des Statuscodes, ob ein Teil Text trug.

Wenn die Kennzeichnung außerhalb des Ausschnitts liegt: Machen Sie den Ausschnitt groß genug, um den ganzen Bereich abzudecken, den das Teil einnehmen kann, und lesen Sie erneut.

Wenn die Kennzeichnung unscharf ist oder nicht richtig herum steht: Korrigieren Sie den Kameraaufbau. Für Text, dessen Orientierung wirklich variiert, verwenden Sie ein Layout mit Orientierungserkennung (AUTO_OSD oder SPARSE_OSD).

Wenn input/min-score alle Wörter herausfiltert: Legen Sie den Schwellwert neu fest, wie unter Genau lesen, Schritt 5, beschrieben.

Die Engine reduziert ein Farbbild vor dem Lesen, und mit einer farbenfrohen Szene im Bild geht dabei der Text verloren. Die Größe des Textes ist nicht die Ursache. Kein input/layout und keine input/engine lösen diesen Fall.

Wenn ein Rechteck den Text von der Szene trennen kann: Schneiden Sie zuerst mit input/crop auf den Text zu. Das Zuschneiden löst diesen Fall in Farbe.

Wenn sich Text und Szene nicht durch ein Rechteck trennen lassen (zum Beispiel ein Etikett auf einem gemusterten Teil oder ein komplett fotografierter Bildschirm):

Ein unbekanntes Zeichen wird ersetzt statt abgelehnt, und der Standard von input/characters/mode, ALL_SYMBOLS, erlaubt jede Klasse.

Wenn der Zeichensatz nicht eingeschränkt ist: Setzen Sie input/characters/mode passend zur Kennzeichnung:

input/crop ist zu weit oder nicht gesetzt. Alles auf null liest das ganze Bild.

input/layout sucht nach mehr Struktur, als die Kennzeichnung hat.

input/min-score ist 0 (der Standard), was alles meldet.

Wenn der Ausschnitt zu weit ist: Verengen Sie input/crop um die Stelle, an der der Text stehen wird. Das ist die wirksamste Einstellung und macht das Lesen auch schneller.

Wenn das Layout nicht passt: Passen Sie input/layout an die Kennzeichnung an, zum Beispiel SINGLE_LINE für eine Druckzeile.

Wenn input/min-score zu niedrig ist:

An diesen Kennzeichnungen scheitert die LSTM-Engine häufiger als an gedrucktem Text.

Beleuchtung, Kontrast oder Fokus sind schlecht. Keine Einstellung behebt das.

Wenn die Engine die Ursache ist: Setzen Sie input/engine auf LEGACY und vergleichen Sie die Leseergebnisse.

Wenn die Bildqualität schlecht ist: Verbessern Sie Beleuchtung und Fokus.

Die Engine erhält zu viel Bild. Die Lesezeit hängt vor allem davon ab, wie viel Bild die Engine erhält.

Das Layout AUTO_OSD oder SPARSE_OSD wird verwendet. Diese Layouts laden ein zweites Modell und bestimmen zuerst die Orientierung.

Wenn die Engine zu viel Bild erhält: Verengen Sie input/crop um das Etikett. Ein enger Ausschnitt ist schneller und genauer als das ganze Bild.

Wenn ein _OSD-Layout verwendet wird: Verwenden Sie ein Layout ohne Orientierungserkennung, sofern die Orientierung nicht wirklich variiert.

Ein erforderlicher Knoten ist leer.

Ein unbekannter Wert in input/engine, input/layout, input/preprocess oder input/characters/mode.

Ein Wert außerhalb des Bereichs, zum Beispiel input/min-score außerhalb von 0 bis 1.

Ein leerer Zeichensatz: CUSTOM mit leerem allow oder ein deny, das alles entfernt, was der Modus ausgewählt hat.

Eine Sprache ohne installiertes Modell. Die Meldung nennt jedes durchsuchte Verzeichnis und was verfügbar ist, zum Beispiel error: invalid input: language 'fra' has no fra.traineddata in any model directory ('<tessdata-dir>', '<shipped dir>'); available: eng, osd. Upload fra.traineddata to '<tessdata-dir>' - the file name is the language code.

Ein Layout mit Orientierungserkennung ohne osd.traineddata neben dem Sprachmodell, siehe Problem: Ein Lesevorgang mit AUTO_OSD oder SPARSE_OSD wird abgelehnt ("also needs osd.traineddata beside …​").

Ein Ausschnitt, der nicht in das Bild passt. Er wird abgelehnt, nicht passend gekürzt.

Eine Bildadresse, die auf diese Anwendung selbst zeigt.

Bei system/set-tessdata-dir: input/tessdata-dir ist leer.

Wenn ein Wert unbekannt, außerhalb des Bereichs oder leer ist: Korrigieren Sie jeden in output/status-text genannten Knoten. Die zulässigen Werte sind in der Data-Layer-Referenz aufgelistet.

Wenn der Zeichensatz leer ist: Setzen Sie input/characters/allow, oder entfernen Sie Zeichen aus input/characters/deny, sodass der Zeichensatz nicht leer ist.

Wenn die Sprache kein Modell hat: Laden Sie <language>.traineddata ohne Umbenennen in das Verzeichnis hoch, das system/tessdata-dir nennt, oder setzen Sie input/language auf einen Code aus system/languages. Siehe Sprachmodelle.

Wenn der Ausschnitt nicht passt: Ändern Sie input/crop so, dass startX + width und startY + height innerhalb des Bildes liegen.

Wenn die Bildadresse auf diese Anwendung zeigt: Setzen Sie input/input-image-address auf den Bildknoten der Kameraanwendung.

Wenn input/tessdata-dir leer ist: Schreiben Sie ein Verzeichnis auf system/set-tessdata-dir/input/tessdata-dir und schreiben Sie dann auf system/set-tessdata-dir/execute.

Eine falsche Bildadresse in input/input-image-address. Das ist fast immer die Ursache.

Die Quellanwendung läuft nicht auf demselben Gerät, oder sie hat kein Bild aufgenommen.

Der Bildknoten fehlt, ist leer oder inkonsistent.

Das Bild verwendet ein nicht unterstütztes Pixelformat.

Wenn die Adresse falsch ist: Korrigieren Sie input/input-image-address und lesen Sie erneut.

Wenn die Quellanwendung nicht läuft oder kein Bild aufgenommen hat: Starten Sie sie auf demselben Gerät, nehmen Sie ein Bild auf und lesen Sie dann erneut.

Wenn der Bildknoten leer oder inkonsistent ist: Nehmen Sie mit der Quellanwendung ein neues Bild auf und lesen Sie dann erneut.

Wenn das Pixelformat nicht unterstützt wird: Verwenden Sie eine Bildquelle, die eines der unterstützten Pixelformate liefert.

Die OCR-Engine konnte nicht starten, meist wegen des Verzeichnisses der Sprachmodelle.

Ein Sprachmodell konnte nicht geladen werden, zum Beispiel ein Modell, dessen Upload noch läuft. Das passiert, wenn ein Lesevorgang direkt auf das Ersetzen eines Modells folgt.

Wenn ein Upload lief: Lesen Sie erneut, sobald der Upload abgeschlossen ist. Dieser Lesevorgang lädt das neue Modell.

Wenn der Grund das Verzeichnis der Sprachmodelle nennt: Prüfen Sie die Verzeichnisse auf system/tessdata-dirs anhand des Grundes in output/status-text. Haben Sie das Upload-Verzeichnis mit system/set-tessdata-dir geändert, prüfen Sie, ob es das Verzeichnis ist, das Ihre Modelle enthält.

Die Layouts AUTO_OSD und SPARSE_OSD brauchen osd.traineddata im selben Verzeichnis wie das Sprachmodell, nicht bloß irgendwo im Suchpfad. Tesseract löst pro Durchlauf ein Verzeichnis auf. Zum Beispiel wurde deu.traineddata allein hochgeladen.

Wenn Sie Orientierungserkennung benötigen: Laden Sie osd.traineddata in dasselbe Verzeichnis wie Ihr Modell hoch. Die Meldung nennt das mitgelieferte Verzeichnis, aus dem Sie es kopieren können. Lesen Sie dann erneut.

Wenn Sie keine Orientierungserkennung benötigen: Verwenden Sie ein Layout, das keine Orientierung erkennt, etwa den Standard SINGLE_BLOCK.

system/languages ist eine Auflistung. Sie wird nur beim Start, durch set-tessdata-dir und durch refresh-languages aktualisiert.

Die Datei liegt nicht in dem Verzeichnis, das system/tessdata-dir nennt, oder sie wurde umbenannt. Der Dateiname ist der Sprachcode.

Wenn die Auflistung nicht aktualisiert ist: Schreiben Sie auf system/refresh-languages/execute und lesen Sie dann system/languages. Zum Lesen brauchen Sie das nicht: Ein hochgeladenes Modell ist beim allernächsten read-text nutzbar.

Wenn die Datei in einem anderen Verzeichnis liegt oder umbenannt wurde: Laden Sie sie erneut, ohne Umbenennen, in das Verzeichnis hoch, das system/tessdata-dir nennt.

Das Sprachmodell ist zwischen der Sprachprüfung und dem Lesen verschwunden - jemand hat zum Beispiel den USB-Stick gezogen. Die Engine liest dann mit eng.

Wenn das Modell verschwunden ist: Stellen Sie das Modell in seinem Verzeichnis wieder bereit, stecken Sie zum Beispiel den USB-Stick wieder ein oder laden Sie das Modell erneut hoch. Ein hochgeladenes Modell ist beim allernächsten read-text nutzbar. Lesen Sie dann erneut und prüfen Sie language in output/result.

output/status-code ist -1 (Belegt);

der Schreibvorgang antwortet mit DL_TOO_MANY_OPERATIONS (ctrlX OS) oder TooManyOperations (PC);

nichts wird getan, und output/result behält seinen Wert.

Der Stream und read-text teilen sich die eine Erkennungs-Engine des Moduls und laufen auf einem Modul nie gleichzeitig. Bei einer streamenden Kamera passiert das oft.

Wenn Sie read-text benötigen, während der Stream läuft: Rufen Sie read-text/execute erneut auf, oder stoppen Sie zuerst den Stream:

Wenn Sie das Modul entfernen möchten: Stoppen Sie zuerst den Stream und rufen Sie dann system/remove-module/execute auf.

Das Sprachmodell ist zwischen der Sprachprüfung und dem Lesen verschwunden, die Engine hat also mit eng gelesen. read-text veröffentlicht ein solches Leseergebnis mit einem NOTE in seinem status-text, aber der Stream verwirft es, weil sein Einstellungs-Hash das angeforderte Modell nennt.

Wenn das Modell verschwunden ist: Stellen Sie das Modell für input/language in seinem Verzeichnis wieder bereit. Ein hochgeladenes Modell wird ab dem nächsten Bild verwendet. Halten Sie es verfügbar, solange der Stream läuft - ziehen Sie zum Beispiel nicht den USB-Stick, auf dem es liegt.

Die Modulliste wurde nicht mit system/save-current-modules gespeichert. Nichts überlebt einen Neustart, bis es gespeichert ist; die Modulliste und die Einstellungen jedes Moduls werden getrennt gespeichert.

Die Einstellungen des Moduls wurden nicht mit system/save-module-inputs gespeichert.

Modus und Quelle des Bild-Streams werden von control/subscribe/execute in der <module-id>.json des Moduls gespeichert, kommen aber nur zurück, wenn auch die Modulliste gespeichert ist.

<module-id>.json enthält Kommentare. Die Eingaben des Moduls werden dann beim Start nicht wiederhergestellt; das Protokoll meldet die Datei als nicht lesbar.

Eine Einstellung, deren Knoten nach einem Software-Update nicht mehr existiert, wird mit einem Protokolleintrag übersprungen.

Wenn die Einstellungen des Moduls nicht gespeichert wurden:

Wenn die Modulliste nicht gespeichert wurde: Schreiben Sie auf system/save-current-modules/execute. Modus und Quelle des Streams eines Moduls kommen nach einem Neustart nur zurück, wenn auch die Modulliste gespeichert ist.

Wenn <module-id>.json Kommentare enthält: Entfernen Sie die Kommentare aus der Datei. Von Hand an der Datei vorgenommene Änderungen wirken beim nächsten Start.