Introduktion

Aspose.OMR FOSS för Python är ett open-source-bibliotek för att designa OMR-formulär (optical mark recognition) — flervals svarsblätter, kryssrutekort och undersökningar — och för att känna igen de markeringar en respondent fyller i från en skannad eller fotograferad bild. Det riktar sig till utvecklare som automatiserar betygsättning av prov, sammanställning av undersökningar eller formulärbaserad datainsamling i Python.

Biblioteket importeras som import omr och har ingen beroende av något Aspose kommersiellt paket. Det är licensierat under MIT och byggt på tre beroenden: numpy, opencv-python och Pillow. Detta är en tidig version (v0.1.0) som täcker grundläggande, genererings- och igenkänningslagren i hela Aspose.OMR-ytan.


Vad som ingår

Ett kod-först-mallträd

En mall är ett träd av elementkonfigurationer som har TemplateConfig som rot, med PageConfig för varje fysisk sida och elementkonfigurationer såsom ChoiceBoxConfig, CheckBoxConfig, GridConfig, CompositeGridConfig och AnswerSheetConfig för själva frågorna. BlockConfig och ContainerConfig tillhandahåller ramar med kantlinjer och kolumnlayouter, och PositionedBlockConfig placerar barn på absoluta koordinater.

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]

Ett text-markup-DSL

Samma elementträd kan byggas från ett kompakt textformat istället för Python-objekt — användbart för att manuellt skapa en mall snabbt eller generera en från en enklare datakälla.

from omr.api import OmrEngine

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

Identifiering och Export

TemplateProcessor.Recognize() läser en skannad bild mot en tidigare genererad mall och returnerar en RecognitionResult. Resultatet exporteras till CSV, JSON eller XML, var och en med en motsvarande in-memory-ström-variant (GetCsvAsStream, GetJsonAsStream, GetXmlAsStream).

Skrivsystem och Overflow-enum

Malllagret definierar skrivsystemen Arabic, Hebrew, Persian, Urdu och Bengali (bredvid standarden Western), samt LongWordHandling/OverflowAction underklasser (Clip, NoClip, Wrap) för text-overflow. Båda enum-grupperna parsas och valideras korrekt för API-fidelitet med Aspose.OMR-ytan, men denna releases renderingsmotor är endast LTR/Västlig och hanterar ännu inte overflow-beteende — båda spåras i den uppströms färdplanen som ännu ej implementerade.

De-Skevning och Omkalibrering

Identifiering korrigerar för skanningsskevhet med hjälp av hörnreferensmarkörer (ReferencePointsSettings). TemplateProcessor.Recalculate() återapplicerar ett annat identifieringströskelvärde på ett befintligt resultat utan att skanna om bilden.


Snabbstart

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()

Öppen källkod & licensiering

Aspose.OMR FOSS för Python är licensierad under MIT och hostas på GitHub. Kommersiell användning är tillåten under samma villkor som alla MIT-licensierade projekt. För företagsfunktioner och produktionsstöd, se Aspose.OMR — Enterprise Product Family.


Komma igång

Relaterade resurser