介绍

Aspose.OMR FOSS 用于 Python 的公共 API(omr.api)刻意保持精简:OmrEngine、TemplateProcessor、ImageCollection,以及 FormValidationLogic 枚举。本文将探讨每个部分的功能以及它们在生成 → 识别 → 导出 工作流中的连接方式。

该库以 import omr 形式导入,采用 MIT 许可证,仅依赖于 numpy、opencv-python 和 Pillow。


包含内容

OmrEngine — 无状态工厂

OmrEngine 在调用之间不保持任何状态。Generate(source, settings) 接受标记 DSL 文本源或代码优先的 TemplateConfig 树,并返回一个 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 for Python采用 MIT 许可证并托管在 GitHub 上。商业使用在与任何 MIT 许可证项目相同的条款下被允许。有关企业功能和生产支持,请参阅 Aspose.OMR — Enterprise Product Family。


快速入门

相关资源