Einleitung

Aspose.OMR FOSS für Python ist eine Open-Source-Bibliothek zum Erstellen von OMR (optical mark recognition)-Formularen — Multiple-Choice-Antwortbögen, Checkbox-Formularen und Umfragen — und zum Erkennen der Markierungen, die ein Befragter in einem gescannten oder fotografierten Bild ausfüllt. Sie richtet sich an Entwickler, die die Bewertung von Prüfungen, die Auswertung von Umfragen oder die formularbasierte Datenerfassung in Python automatisieren.

Die Bibliothek wird als import omr importiert und hat keine Abhängigkeit von einem kommerziellen Aspose-Paket. Sie ist unter der MIT-Lizenz veröffentlicht und basiert auf drei Abhängigkeiten: numpy, opencv-python und Pillow. Dies ist eine frühe Veröffentlichung (v0.1.0), die die Grund-, Erzeugungs- und Erkennungsschichten der vollständigen Aspose.OMR-Oberfläche abdeckt.


Was enthalten ist

Ein Code-First-Vorlagenbaum

Eine Vorlage ist ein Baum von Element-Konfigurationen, der bei TemplateConfig verwurzelt ist, mit PageConfig für jede physische Seite und Element-Konfigurationen wie ChoiceBoxConfig, CheckBoxConfig, GridConfig, CompositeGridConfig und AnswerSheetConfig für die eigentlichen Fragen. BlockConfig und ContainerConfig liefern umrandete Kästchen und Spaltenlayouts, und PositionedBlockConfig positioniert Kinder an absoluten Koordinaten.

from omr.generation.config import TemplateConfig
from omr.generation.config.elements.parents import PageConfig, CheckBoxConfig

tpl = TemplateConfig()
tpl.Name = "survey"
page = PageConfig()
cb = CheckBoxConfig()
cb.Name = "Q1"
page.Children = [cb]
tpl.Children = [page]

Eine Text-Markup-DSL

Der gleiche Elementbaum kann aus einem kompakten Textformat anstelle von Python-Objekten erstellt werden — nützlich, um schnell ein Template von Hand zu erstellen oder eines aus einer einfacheren Datenquelle zu generieren.

from omr.api import OmrEngine

markup = [
    "?choicebox=Rate it",
    "(1) Poor (2) Fair (3) Good",
    "&choicebox",
]
engine = OmrEngine()
result = engine.Generate(markup)

Erkennung und Export

TemplateProcessor.Recognize() liest ein gescanntes Bild anhand einer zuvor generierten Vorlage und gibt ein RecognitionResult zurück. Das Ergebnis wird nach CSV, JSON oder XML exportiert, jeweils mit einer passenden In-Memory-Stream-Variante (GetCsvAsStream, GetJsonAsStream, GetXmlAsStream).

Schriftsystem- und Überlauf-Enums

Die Vorlagenschicht definiert die Schreibsysteme Arabic, Hebrew, Persian, Urdu und Bengali (neben dem Standard Western) sowie die Unterklassen LongWordHandling/OverflowAction (Clip, NoClip, Wrap) für Textüberlauf. Beide Enum-Gruppen werden korrekt geparst und validiert, um API-Treue mit der Aspose.OMR-Oberfläche zu gewährleisten, jedoch ist die Render-Engine dieser Version nur LTR/Western und berücksichtigt das Überlaufverhalten noch nicht — beide Punkte sind im upstream roadmap als noch nicht implementiert vermerkt.

Entzerrung und Neukalibrierung

Die Erkennung korrigiert den Scan-Schiefstand mithilfe von Eck-Referenzmarken (ReferencePointsSettings). TemplateProcessor.Recalculate() wendet einen anderen Erkennungs-Schwellenwert auf ein bestehendes Ergebnis an, ohne das Bild erneut zu scannen.


Schnellstart

git clone https://github.com/aspose-omr-foss/Aspose.OMR-FOSS-for-Python.git
cd Aspose.OMR-FOSS-for-Python
pip install -e .
from omr.api import OmrEngine, FormValidationLogic

engine = OmrEngine()
gen = engine.Generate("final-exam.txt")          # or a code-first TemplateConfig
gen.Save("out", "final-exam")                    # -> out/final-exam.png + out/final-exam.omr
processor = engine.GetTemplateProcessor("out/final-exam.omr", FormValidationLogic.Ignore)
result = processor.Recognize("scan.png")         # -100 = auto-calibrated threshold
print(result.GetCsv())                           # also GetJson() / GetXml()

Open Source & Lizenzierung

Aspose.OMR FOSS für Python ist unter der MIT-Lizenz verfügbar und wird auf GitHub gehostet. Kommerzielle Nutzung ist unter denselben Bedingungen wie jedes MIT-lizenzierte Projekt gestattet. Für Unternehmensfunktionen und Produktionssupport siehe Aspose.OMR — Enterprise Product Family.


Erste Schritte

Verwandte Ressourcen