介绍
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。