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.