Введение
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.