Introdução
Aspose.OMR FOSS para o Python público API (omr.api) é intencionalmente pequeno: OmrEngine, TemplateProcessor, ImageCollection e o enum FormValidationLogic. Este post analisa o que cada um faz e como eles se conectam ao longo de um fluxo de trabalho gerar → reconhecer → exportar.
A biblioteca é importada como import omr, tem licença MIT e depende apenas de numpy, opencv-python e Pillow.
O que está incluído
OmrEngine — uma fábrica sem estado
OmrEngine não mantém estado entre chamadas. Generate(source, settings) aceita tanto uma fonte de texto markup-DSL quanto uma árvore TemplateConfig code-first, e retorna um GenerationResult — a(s) imagem(ns) da página mais um modelo de template .omr JSON descrevendo a localização de cada elemento. GetTemplateProcessor(templateSource, validationLogic) carrega um arquivo .omr salvo anteriormente (ou um descritor em memória) e retorna um TemplateProcessor vinculado a ele.
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 expõe ErrorCode, ErrorMessage, Template (o descritor .omr como uma string JSON), TemplateImage e — para modelos de várias páginas — MultipageTemplateImages. Save(folder, name) grava a imagem e o descritor no disco; SaveAsPdf() não está implementado nesta versão e gera NotImplementedError. MemoryGenerationResult encapsula os mesmos dados como fluxos em memória: GetImages() devolve uma lista de fluxos de imagem em memória, e GetOmr(encoding) devolve o descritor como um fluxo — útil quando o chamador não deseja tocar no sistema de arquivos.
TemplateProcessor — Reconhecendo digitalizações
TemplateProcessor.Recognize(source, recognitionThreshold) lê uma imagem digitalizada em relação ao modelo a partir do qual foi criado e devolve um RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) executa o mesmo reconhecimento em todas as imagens de uma pasta em uma única chamada, retornando uma lista de resultados — conveniente para o processamento em lote de um conjunto de digitalizações. Recalculate(result, recognitionThreshold) reavalia um resultado já reconhecido com um limiar diferente, sem reler a imagem de origem.
RecognitionResult — Lendo as Respostas
Cada elemento em RecognitionResult.OmrElements implementa IOmrElement, expondo GetAnswer() e GetCsv() por elemento, juntamente com QuestionName. No nível de resultado, GetCsv(encoding), GetJson(encoding) e GetXml(encoding) exportam o resultado completo, cada um com uma variante correspondente ...AsStream que devolve um BytesIO em vez de uma string simples.
ImageCollection — Incorporando imagens na marcação
ImageCollection é um mapa somente de acréscimo, sensível a maiúsculas e minúsculas, de um nome para bytes de imagem brutos. Add(name, image) registra uma imagem, Contains(name) verifica se um nome já está registrado, e as_dict() devolve o mapa subjacente. A marcação pode então referenciar uma imagem registrada pelo nome (?image=<name>) em vez de um caminho de sistema de arquivos — útil quando os bytes da imagem vêm de outro lugar que não o disco, como um upload web.
Início rápido
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()
Código Aberto e Licenciamento
Aspose.OMR FOSS para Python está licenciado sob MIT e hospedado em GitHub. O uso comercial é permitido sob os mesmos termos de qualquer projeto licenciado sob MIT. Para recursos empresariais e suporte de produção, veja Aspose.OMR — Enterprise Product Family.