Introducere

Aspose.OMR FOSS pentru Python este o bibliotecă open-source pentru proiectarea formularelor OMR (recunoaștere optică a marcajelor) — foi de răspuns cu opțiuni multiple, formulare cu căsuțe de bifare și sondaje — și recunoașterea marcajelor pe care un respondent le completează dintr-o imagine scanată sau fotografiată. Se adresează dezvoltatorilor care automatizează notarea examenelor, tabularea sondajelor sau colectarea de date pe bază de formulare în Python.

Biblioteca se importă ca import omr și nu are nicio dependență de niciun pachet comercial Aspose. Este licențiată sub MIT și este construită pe trei dependențe: numpy, opencv-python și Pillow. Aceasta este o versiune timpurie (v0.1.0) care acoperă straturile de bază, generare și recunoaștere ale suprafeței complete Aspose.OMR.


Ce este inclus

Un arbore de șabloane Code-First

Un șablon este un arbore de configurații de elemente cu rădăcina la TemplateConfig, cu PageConfig pentru fiecare pagină fizică și configurații de elemente precum ChoiceBoxConfig, CheckBoxConfig, GridConfig, CompositeGridConfig și AnswerSheetConfig pentru întrebările în sine. BlockConfig și ContainerConfig oferă casete cu margini și aranjamente în coloane, iar PositionedBlockConfig plasează copiii la coordonate absolute.

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]

Un DSL de marcare a textului

Același arbore de elemente poate fi construit dintr-un format text compact în loc de obiecte Python — util pentru a crea manual un șablon rapid sau pentru a genera unul dintr-o sursă de date mai simplă.

from omr.api import OmrEngine

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

Recunoaștere și Export

TemplateProcessor.Recognize() citește o imagine scanată în raport cu un șablon generat anterior și returnează un RecognitionResult. Rezultatul se exportă în CSV, JSON, sau XML, fiecare având o variantă corespunzătoare de flux în memorie (GetCsvAsStream, GetJsonAsStream, GetXmlAsStream).

Enumerări pentru Sistemul de Scriere și Depășire

Stratul de șablon definește sistemele de scriere Arabic, Hebrew, Persian, Urdu și Bengali (împreună cu Western implicit), și subclasele LongWordHandling/OverflowAction (Clip, NoClip, Wrap) pentru depășirea textului. Ambele grupuri de enumerări analizează și validează corect pentru fidelitatea API cu suprafața Aspose.OMR, dar motorul de randare al acestei versiuni este doar LTR/Western și nu respectă încă comportamentul de depășire — ambele sunt urmărite în foaia de parcurs a upstream-ului ca neimplementate încă.

Corecție de Înclinare și Recalibrare

Recunoașterea corectează înclinarea scanării folosind marcajele de referință din colț (ReferencePointsSettings). TemplateProcessor.Recalculate() reaplică un prag de recunoaștere diferit la un rezultat existent fără a scana din nou imaginea.


Început Rapid

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 & Licențiere

Aspose.OMR FOSS pentru Python este licențiat sub MIT și găzduit pe GitHub. Utilizarea comercială este permisă în aceleași condiții ca orice proiect licențiat MIT. Pentru funcționalități enterprise și suport în producție, vedeți Aspose.OMR — Enterprise Product Family.


Începeți

Resurse conexe