Inleiding

Een OMR-formulier genereren in Aspose.OMR FOSS voor Python betekent het bouwen van een boom van element-configuraties met wortel TemplateConfig, waarna die boom wordt doorgegeven aan OmrEngine.Generate(). De engine rendert een pagina-afbeelding plus een .omr descriptor die later door een herkenningspass wordt gelezen. Deze post loopt door de element-configuraties die die boom vormen, en de alternatieve text-markup DSL die dezelfde boom opbouwt zonder direct Python-objecten te construeren.

De bibliotheek wordt geïmporteerd als import omr, heeft een MIT-licentie, en hangt alleen af van numpy, opencv-python en Pillow.


Wat er inbegrepen is

De sjabloonboom

TemplateConfig is de documentroot; het bevat één of meer PageConfig-objecten, één per fysieke pagina. Elk element onder een pagina is een subklasse van BaseConfig, die minimaal een Name en een Type discriminator (ConfigType) draagt.

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]

Vraag-elementen

ChoiceBoxConfig definieert een enkele vraag met een vaste set keurbubbels (elk een ChoiceBoxAnswerConfig) en ondersteunt multi-select; FormValidationLogic, eenmaal per TemplateProcessor ingesteld, kan een fout geven als een vraag met Multiselect uitgeschakeld meer dan één markering ontvangt. AnswerSheetConfig legt een genummerde matrix van antwoordbubbels voor examenbladen vast, met een configureerbare BubbleType en BubbleSize. CheckBoxConfig is een gelabelde groep lege vakken die elke markering accepteren, met een instelbare vuldrempel.

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

Rasters en samengestelde rasters

GridConfig rendert een cijfermatrix — een vast aantal secties, elk met 0–9 keurbubbels — samengevoegd tot één waarde, vaak gebruikt voor ID-nummers. CompositeGridConfig is de flexibelere variant: een aangepaste symbolenset per kolom, waarbij markeringen over kolommen heen samensmelten tot één waarde.

Lay-outcontainers

BlockConfig is een doos met rand en opvulling; ContainerConfig rangschikt kindblokken in kolommen of een paginavoettekst; PositionedBlockConfig plaatst kinderen op absolute XPosition/YPosition coördinaten in plaats van ze te laten vloeien. BlockConfig en GlobalPageSettings dragen ook een Overflow eigenschap (OverflowAction subklassen Clip/NoClip/Wrap) en LongWordHandling, maar deze enums worden correct geparseerd en gevalideerd zonder dat ze nog worden gerespecteerd door de renderengine van deze release — overflow-gedrag is nog niet configureerbaar, en wordt gevolgd op de upstream roadmap.

De Markup-DSL

Dezelfde boom kan worden geschreven als platte tekst in plaats van Python objecten. ?choicebox=... opent een keuzebox-vraag, de volgende regels sommen de opties op, en &choicebox sluit deze.

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)

Snelstart

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 & licenties

Aspose.OMR FOSS voor Python is gelicentieerd onder de MIT-licentie en gehost op GitHub. Commercieel gebruik is toegestaan onder dezelfde voorwaarden als elk MIT-gelicentieerd project. Voor enterprise-functies en productiesupport, zie Aspose.OMR — Enterprise Product Family.


Aan de slag

Gerelateerde bronnen