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.