Giới thiệu

Aspose.OMR FOSS cho Python là một thư viện mã nguồn mở để thiết kế các mẫu OMR (optical mark recognition) — phiếu trả lời trắc nghiệm, mẫu hộp kiểm và khảo sát — và nhận dạng các dấu mà người trả lời điền vào từ hình ảnh đã quét hoặc chụp. Nó hướng tới các nhà phát triển tự động hoá chấm điểm kỳ thi, tổng hợp khảo sát, hoặc thu thập dữ liệu dựa trên biểu mẫu trong Python.

Thư viện được nhập dưới dạng import omr và không phụ thuộc vào bất kỳ gói thương mại Aspose nào. Nó được cấp phép MIT và được xây dựng dựa trên ba phụ thuộc: numpy, opencv-python, và Pillow. Đây là phiên bản phát hành sớm (v0.1.0) bao phủ các lớp nền tảng, sinh và nhận dạng của toàn bộ bề mặt Aspose.OMR.


Những gì được bao gồm

Cây mẫu Code-First

Một mẫu là một cây cấu hình phần tử có gốc tại TemplateConfig, với PageConfig cho mỗi trang vật lý và các cấu hình phần tử như ChoiceBoxConfig, CheckBoxConfig, GridConfig, CompositeGridConfig, và AnswerSheetConfig cho chính các câu hỏi. BlockConfig và ContainerConfig cung cấp các khung có viền và bố cục cột, và PositionedBlockConfig đặt các phần tử con tại các tọa độ tuyệt đối.

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]

Một DSL Đánh dấu Văn bản

Cây phần tử giống nhau có thể được xây dựng từ một định dạng văn bản gọn gàng thay vì các đối tượng Python — hữu ích cho việc tự tay tạo mẫu nhanh chóng hoặc tạo ra một mẫu từ nguồn dữ liệu đơn giản hơn.

from omr.api import OmrEngine

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

Nhận dạng và Xuất khẩu

TemplateProcessor.Recognize() đọc một hình ảnh đã quét so với mẫu đã tạo trước và trả về một RecognitionResult. Kết quả được xuất ra CSV, JSON, hoặc XML, mỗi loại có một biến thể luồng trong bộ nhớ tương ứng (GetCsvAsStream, GetJsonAsStream, GetXmlAsStream).

Enum Hệ thống Viết và Tràn

Lớp mẫu định nghĩa các hệ thống viết Arabic, Hebrew, Persian, Urdu, và Bengali (cùng với mặc định Western), và các lớp con LongWordHandling/OverflowAction (Clip, NoClip, Wrap) cho hiện tượng tràn văn bản. Cả hai nhóm enum đều phân tích và xác thực đúng cho độ trung thực API với bề mặt Aspose.OMR, nhưng động cơ render của phiên bản này chỉ hỗ trợ LTR/Tây và chưa thực hiện hành vi tràn — cả hai đang được theo dõi trong lộ trình upstream như chưa được triển khai.

Bù nghiêng và Tái hiệu chuẩn

Nhận dạng điều chỉnh độ nghiêng của quét bằng cách sử dụng các dấu tham chiếu góc (ReferencePointsSettings). TemplateProcessor.Recalculate() áp dụng lại một ngưỡng nhận dạng khác cho kết quả hiện có mà không cần quét lại hình ảnh.


Bắt đầu nhanh

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

Mã nguồn mở & Giấy phép

Aspose.OMR FOSS cho Python được cấp phép MIT và được lưu trữ trên GitHub. Việc sử dụng thương mại được phép theo các điều khoản giống như bất kỳ dự án nào có giấy phép MIT. Đối với các tính năng doanh nghiệp và hỗ trợ sản xuất, xem Aspose.OMR — Enterprise Product Family.


Bắt đầu

Tài Nguyên Liên Quan