Introduzione

Aspose.OMR FOSS per il Python pubblico API (omr.api) è intenzionalmente piccolo: OmrEngine, TemplateProcessor, ImageCollection e l’enum FormValidationLogic. Questo post esamina cosa fa ciascuno e come si collegano in un flusso di lavoro genera → riconosci → esporta.

La libreria si importa come import omr, è rilasciata con licenza MIT e dipende solo da numpy, opencv-python e Pillow.


Cosa è incluso

OmrEngine — una Factory senza stato

OmrEngine non conserva alcuno stato tra le chiamate. Generate(source, settings) accetta sia una sorgente di testo markup-DSL sia un albero TemplateConfig code-first, e restituisce un GenerationResult — l’immagine/e della pagina più un modello .omr JSON che descrive la posizione di ogni elemento. GetTemplateProcessor(templateSource, validationLogic) carica un file .omr precedentemente salvato (o un descrittore in memoria) e restituisce un TemplateProcessor associato ad esso.

from omr.api import OmrEngine, FormValidationLogic

engine = OmrEngine()
gen = engine.Generate("final-exam.txt")
gen.Save("out", "final-exam")
processor = engine.GetTemplateProcessor("out/final-exam.omr", FormValidationLogic.Ignore)

GenerationResult e MemoryGenerationResult

GenerationResult espone ErrorCode, ErrorMessage, Template (il descrittore .omr come stringa JSON), TemplateImage, e — per i modelli a più pagine — MultipageTemplateImages. Save(folder, name) scrive l’immagine e il descrittore su disco; SaveAsPdf() non è implementato in questa versione e genera NotImplementedError. MemoryGenerationResult avvolge gli stessi dati come stream in memoria invece: GetImages() restituisce un elenco di stream di immagini in memoria, e GetOmr(encoding) restituisce il descrittore come stream — utile quando il chiamante non vuole toccare affatto il filesystem.

TemplateProcessor — Riconoscimento delle scansioni

TemplateProcessor.Recognize(source, recognitionThreshold) legge un’immagine scansionata rispetto al modello da cui è stato creato e restituisce un RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) esegue lo stesso riconoscimento su ogni immagine in una cartella in una sola chiamata, restituendo un elenco di risultati — comodo per l’elaborazione batch di una pila di scansioni. Recalculate(result, recognitionThreshold) ricalcola il punteggio di un risultato già riconosciuto con una soglia diversa, senza rileggere l’immagine di origine.

RecognitionResult — Lettura delle risposte

Ogni elemento in RecognitionResult.OmrElements implementa IOmrElement, esponendo GetAnswer() e GetCsv() per elemento, insieme a QuestionName. A livello di risultato, GetCsv(encoding), GetJson(encoding) e GetXml(encoding) esportano l’intero risultato, ognuno con una variante corrispondente ...AsStream che restituisce un BytesIO invece di una semplice stringa.

ImageCollection — Incorporare immagini nel markup

ImageCollection è una mappa solo-append, sensibile al maiuscolo/minuscolo, da un nome a byte di immagine grezzi. Add(name, image) registra un’immagine, Contains(name) verifica se un nome è già registrato, e as_dict() restituisce la mappa di supporto. Il markup può quindi fare riferimento a un’immagine registrata per nome (?image=<name>) invece di un percorso del filesystem — utile quando i byte dell’immagine provengono da una fonte diversa dal disco, come un upload web.


Guida rapida

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 è rilasciato sotto 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