Introduzione

Generare un modulo OMR in Aspose.OMR FOSS per Python significa costruire un albero di configurazioni di elementi con radice in TemplateConfig, quindi passare quell’albero a OmrEngine.Generate(). Il motore genera un’immagine di pagina più un descrittore .omr che una successiva fase di riconoscimento legge. Questo post esamina le configurazioni di elementi che compongono quell’albero e il DSL di markup testuale alternativo che costruisce lo stesso albero senza creare oggetti Python direttamente.

La libreria viene importata come import omr, è sotto licenza MIT e dipende solo da numpy, opencv-python e Pillow.


Cosa è incluso

L’albero del Template

TemplateConfig è la radice del documento; contiene uno o più oggetti PageConfig, uno per pagina fisica. Ogni elemento sotto una pagina è una sottoclasse di BaseConfig, che possiede almeno un Name e un discriminatore Type (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]

Elementi di domanda

ChoiceBoxConfig definisce una singola domanda con un insieme fisso di bolle di opzione (ognuna è un ChoiceBoxAnswerConfig) e supporta la selezione multipla; FormValidationLogic, impostato una volta per TemplateProcessor, può sollevare un errore se una domanda con Multiselect disabilitato riceve più di un segno. AnswerSheetConfig dispone una matrice numerata di bolle di risposta per fogli in stile esame, con un BubbleType configurabile e BubbleSize. CheckBoxConfig è un gruppo etichettato di caselle vuote che accetta qualsiasi segno, con una soglia di riempimento regolabile.

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

Griglie e Griglie Composite

GridConfig rende una matrice di cifre — un numero fisso di sezioni, ciascuna con bolle di opzione da 0 a 9 — fuse in un unico valore, comunemente usata per numeri di identificazione. CompositeGridConfig è la variante più flessibile: un set di simboli personalizzato per colonna, con segni attraverso le colonne che si fondono in un unico valore.

Contenitori di Layout

BlockConfig è una scatola con bordo e imbottitura; ContainerConfig dispone i blocchi figli in colonne o in un piè di pagina; PositionedBlockConfig posiziona i figli a coordinate assolute XPosition/YPosition invece di farli fluire. BlockConfig e GlobalPageSettings includono anche una proprietà Overflow (OverflowAction sottoclassi Clip/NoClip/Wrap) e LongWordHandling, ma questi enum vengono analizzati e convalidati correttamente senza essere ancora rispettati dal motore di rendering di questa versione — il comportamento di overflow non è ancora configurabile, ed è monitorato nella roadmap upstream.

Il DSL di markup

Lo stesso albero può essere scritto come testo semplice invece di oggetti Python. ?choicebox=... apre una domanda a scelta multipla, le righe successive elencano le sue opzioni, e &choicebox la chiude.

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)

Avvio rapido

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 e Licenze

Aspose.OMR FOSS per Python è con licenza MIT e ospitato su GitHub. L’uso commerciale è consentito alle stesse condizioni di qualsiasi progetto con licenza MIT. Per le funzionalità enterprise e il supporto in produzione, vedere Aspose.OMR — Enterprise Product Family.


Guida introduttiva

Risorse correlate