Introduktion

Att generera ett OMR-formulär i Aspose.OMR FOSS för Python innebär att bygga ett träd av elementkonfigurationer med rot i TemplateConfig, och sedan överlämna det trädet till OmrEngine.Generate(). Motorn renderar en sidavbild plus en .omr-beskrivare som ett senare igenkänningspass läser tillbaka. Detta inlägg går igenom de elementkonfigurationer som utgör det trädet, och det alternativa text-markup DSL som bygger samma träd utan att konstruera Python-objekt direkt.

Biblioteket importeras som import omr, har MIT-licens och är endast beroende av numpy, opencv-python och Pillow.


Vad som ingår

Mallträdet

TemplateConfig är dokumentroten; den innehåller ett eller flera PageConfig-objekt, ett per fysisk sida. Varje element under en sida är en subklass av BaseConfig, som minst bär en Name och en Type-diskriminator (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]

Frågeelement

ChoiceBoxConfig definierar en enskild fråga med en fast uppsättning alternativbubblor (varje en ChoiceBoxAnswerConfig) och stöder multival; FormValidationLogic, som sätts en gång per TemplateProcessor, kan utlösa ett fel om en fråga med Multiselect inaktiverad får mer än en markering. AnswerSheetConfig lägger upp en numrerad matris av svarsbubblor för provliknande blad, med en konfigurerbar BubbleType och BubbleSize. CheckBoxConfig är en märkt grupp av tomma rutor som accepterar vilken markering som helst, med ett justerbart fyllnadströskelvärde.

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

Rutnät och sammansatta rutnät

GridConfig renderar en siffrumatris — ett fast antal sektioner, var och en med 0–9 alternativbubblor — sammanslagen till ett enda värde, vanligen använt för ID-nummer. CompositeGridConfig är den mer flexibla varianten: en anpassad symboluppsättning per kolumn, där markeringar över kolumner sammanslås till ett värde.

Layoutbehållare

BlockConfig är en kantad, vadderad låda; ContainerConfig ordnar barnblock i kolumner eller en sidfot; PositionedBlockConfig placerar barn på absoluta XPosition/YPosition-koordinater istället för att flöda dem. BlockConfig och GlobalPageSettings har också en Overflow-egenskap (OverflowAction underklasser Clip/NoClip/Wrap) och LongWordHandling, men dessa enums parsas och valideras korrekt utan att ännu tas i beaktning av detta releases renderingsmotor — överflödesbeteende är ännu inte konfigurerbart, och följs på den uppströms färdplanen.

Markup DSL

Samma träd kan skrivas som ren text istället för Python-objekt. ?choicebox=... öppnar en valboxfråga, de följande raderna listar dess alternativ, och &choicebox stänger den.

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)

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 MIT-licensierad 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