Einleitung

Das Erstellen eines OMR-Formulars in Aspose.OMR FOSS für Python bedeutet, einen Baum von Elementkonfigurationen zu bauen, der bei TemplateConfig wurzelt, und diesen Baum dann an OmrEngine.Generate() zu übergeben. Die Engine rendert ein Seitenbild plus einen .omr-Deskriptor, den ein späterer Erkennungslauf ausliest. Dieser Beitrag führt durch die Elementkonfigurationen, aus denen dieser Baum besteht, und die alternative textbasierte DSL, die denselben Baum erstellt, ohne direkt Python-Objekte zu konstruieren.

Die Bibliothek wird als import omr importiert, ist unter der MIT-Lizenz veröffentlicht und hängt nur von numpy, opencv-python und Pillow ab.


Was enthalten ist

Der Vorlagenbaum

TemplateConfig ist die Dokumentwurzel; sie enthält ein oder mehrere PageConfig-Objekte, jeweils eines pro physischer Seite. Jedes Element unterhalb einer Seite ist eine Unterklasse von BaseConfig und trägt mindestens ein Name sowie einen Type-Discriminator (ConfigType).

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

tpl = TemplateConfig()
tpl.Name = "quiz"
page = PageConfig()
page.Children = []
tpl.Children = [page]

Frageelemente

ChoiceBoxConfig definiert eine einzelne Frage mit einem festen Satz von Optionsblasen (jeweils eine ChoiceBoxAnswerConfig) und unterstützt Mehrfachauswahl; FormValidationLogic, einmal pro TemplateProcessor festgelegt, kann ausgelöst werden, wenn eine Frage mit deaktiviertem Multiselect mehr als eine Markierung erhält. AnswerSheetConfig stellt eine nummerierte Matrix von Antwortblasen für prüfungsähnliche Bögen bereit, mit einem konfigurierbaren BubbleType und BubbleSize. CheckBoxConfig ist eine beschriftete Gruppe leerer Kästchen, die jede Markierung akzeptieren, mit einem einstellbaren Füllschwellenwert.

from omr.generation.config.elements import AnswerSheetConfig

sheet = AnswerSheetConfig()
sheet.Name = "answers"
sheet.AnswersCount = 4    # bubbles per question (e.g. A-D)
sheet.ElementsCount = 20  # number of questions

Raster und zusammengesetzte Raster

GridConfig rendert eine Ziffernmatrix — eine feste Anzahl von Abschnitten, jeweils mit 0–9 Optionsblasen — die zu einem einzigen Wert zusammengeführt werden, häufig verwendet für ID-Nummern. CompositeGridConfig ist die flexiblere Variante: ein benutzerdefiniertes Symbolset pro Spalte, wobei Markierungen über Spalten hinweg zu einem Wert zusammengeführt werden.

Layout-Container

BlockConfig ist ein umrandeter, gepolsterter Kasten; ContainerConfig ordnet Kindblöcke in Spalten oder in eine Seitenfußzeile; PositionedBlockConfig platziert Kinder an absoluten XPosition/YPosition-Koordinaten anstatt sie fließen zu lassen. BlockConfig und GlobalPageSettings besitzen zudem eine Overflow-Eigenschaft (OverflowAction Unterklassen Clip/NoClip/Wrap) und LongWordHandling, aber diese Enums werden korrekt geparst und validiert, obwohl sie von der Render-Engine dieser Veröffentlichung noch nicht berücksichtigt werden — das Überlaufverhalten ist noch nicht konfigurierbar und wird im Upstream-Roadmap verfolgt.

Die Markup DSL

Der gleiche Baum kann als Klartext anstelle von Python-Objekten geschrieben werden. ?choicebox=... öffnet eine Auswahl-Box-Frage, die folgenden Zeilen listen ihre Optionen auf, und &choicebox schließt sie.

import json
from omr.api import OmrEngine

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

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 bei jedem MIT-lizenzierten Projekt gestattet. Für Unternehmensfunktionen und Produktionssupport siehe Aspose.OMR — Enterprise Product Family.


Erste Schritte

Verwandte Ressourcen