Введение

Aspose.OMR FOSS для публичного API Python (omr.api) намеренно небольшой: OmrEngine, TemplateProcessor, ImageCollection и перечисление FormValidationLogic. В этом посте рассматривается, что делает каждый из них и как они соединяются в процессе «generate → recognize → export».

Библиотека импортируется как import omr, имеет MIT-лицензию и зависит только от numpy, opencv-python и Pillow.


Что включено

OmrEngine — фабрика без состояния

OmrEngine не сохраняет состояние между вызовами. Generate(source, settings) принимает либо источник текста в виде разметочного DSL, либо дерево TemplateConfig в стиле code-first и возвращает GenerationResult — изображение(я) страницы плюс шаблон .omr JSON, описывающий расположение каждого элемента. GetTemplateProcessor(templateSource, validationLogic) загружает ранее сохранённый файл .omr (или дескриптор в памяти) и возвращает TemplateProcessor, привязанный к нему.

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 и MemoryGenerationResult

GenerationResult предоставляет ErrorCode, ErrorMessage, Template (дескриптор .omr как строку JSON), TemplateImage и — для многостраничных шаблонов — MultipageTemplateImages. Save(folder, name) записывает изображение и дескриптор на диск; SaveAsPdf() не реализован в этом выпуске и вызывает NotImplementedError. MemoryGenerationResult оборачивает те же данные в потоках в памяти: GetImages() возвращает список потоков изображений в памяти, а GetOmr(encoding) возвращает дескриптор в виде потока — полезно, когда вызывающая сторона не хочет обращаться к файловой системе.

TemplateProcessor — распознавание сканов

TemplateProcessor.Recognize(source, recognitionThreshold) читает одно отсканированное изображение по шаблону, из которого оно было создано, и возвращает RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) выполняет то же распознавание для каждого изображения в папке за один вызов, возвращая список результатов — удобно для пакетной обработки стопки сканов. Recalculate(result, recognitionThreshold) переоценивает уже распознанный результат с другим порогом, не перечитывая исходное изображение.

RecognitionResult — чтение ответов

Каждый элемент в RecognitionResult.OmrElements реализует IOmrElement, предоставляя GetAnswer() и GetCsv() для каждого элемента, а также QuestionName. На уровне результата GetCsv(encoding), GetJson(encoding) и GetXml(encoding) экспортируют весь результат, каждый с соответствующим вариантом ...AsStream, который возвращает BytesIO вместо обычной строки.

ImageCollection — встраивание изображений в разметку

ImageCollection — это карта только для добавления, чувствительная к регистру, отображающая имя в необработанные байты изображения. Add(name, image) регистрирует изображение, Contains(name) проверяет, зарегистрировано ли имя уже, а as_dict() возвращает базовую карту. Затем разметка может ссылаться на зарегистрированное изображение по имени (?image=<name>) вместо пути в файловой системе — полезно, когда байты изображения поступают не с диска, а, например, через веб-загрузку.


Быстрый старт

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()

Открытый исходный код и лицензирование

Aspose.OMR FOSS для Python имеет лицензию MIT и размещён на GitHub. Коммерческое использование разрешено на тех же условиях, что и любой проект с лицензией MIT. Для функций корпоративного уровня и поддержки в продакшене см. Aspose.OMR — Enterprise Product Family.


Начало работы

Связанные ресурсы