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
- Guida introduttiva
- Guida per sviluppatori
- Articoli KB
- API Reference
- Aspose.OMR FOSS per Python su GitHub