介绍

Aspose.OMR FOSS 用于 Python 是一个开源库,用于设计 OMR(光学标记识别)表单——选择题答卷、复选框表单和调查问卷——并从扫描或拍摄的图像中识别受访者填写的标记。它面向在 Python 中自动化考试评分、调查统计或基于表单的数据收集的开发者。

该库以 import omr 导入,且不依赖任何 Aspose 商业包。它采用 MIT 许可证,并基于三项依赖:numpy、opencv-python 和 Pillow。这是一个早期版本(v0.1.0),涵盖完整 Aspose.OMR 表面的基础、生成和识别层。


包含内容

代码优先模板树

模板是一个以 TemplateConfig 为根的元素配置树,每个物理页面使用 PageConfig,并且为题目本身提供诸如 ChoiceBoxConfig、CheckBoxConfig、GridConfig、CompositeGridConfig 和 AnswerSheetConfig 的元素配置。BlockConfig 和 ContainerConfig 提供带边框的盒子和列布局,PositionedBlockConfig 则将子元素放置在绝对坐标上。

from omr.generation.config import TemplateConfig
from omr.generation.config.elements.parents import PageConfig, CheckBoxConfig

tpl = TemplateConfig()
tpl.Name = "survey"
page = PageConfig()
cb = CheckBoxConfig()
cb.Name = "Q1"
page.Children = [cb]
tpl.Children = [page]

文本标记 DSL

相同的元素树可以从紧凑的文本格式而非 Python 对象构建 —— 对于快速手工编写模板或从更简单的数据源生成模板非常有用。

from omr.api import OmrEngine

markup = [
    "?choicebox=Rate it",
    "(1) Poor (2) Fair (3) Good",
    "&choicebox",
]
engine = OmrEngine()
result = engine.Generate(markup)

识别与导出

TemplateProcessor.Recognize() 将扫描图像与先前生成的模板进行比对并返回一个 RecognitionResult。结果可导出为 CSV、JSON 或 XML,每种格式都有相应的内存流变体(GetCsvAsStream、GetJsonAsStream、GetXmlAsStream)。

书写系统与溢出枚举

模板层定义了 Arabic、Hebrew、Persian、Urdu 和 Bengali 书写系统(以及默认的 Western),以及用于文本溢出的 LongWordHandling/OverflowAction 子类(Clip、NoClip、Wrap)。这两个枚举组能够正确解析并验证 API 的保真度,配合 Aspose.OMR 表面使用,但本次发布的渲染引擎仅支持 LTR/西方语言,尚未实现溢出行为 —— 这两项已在上游路线图中标记为未实现。

去倾斜与重新校准

识别使用角落参考标记 (ReferencePointsSettings) 校正扫描倾斜。TemplateProcessor.Recalculate() 在不重新扫描图像的情况下,对已有结果重新应用不同的识别阈值。


快速入门

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。


快速入门

相关资源