Giới thiệu
Việc tạo một mẫu OMR trong Aspose.OMR FOSS cho Python có nghĩa là xây dựng một cây cấu hình phần tử có gốc tại TemplateConfig, sau đó chuyển cây này cho OmrEngine.Generate(). Engine tạo ra một hình ảnh trang cùng với một mô tả .omr mà lần nhận dạng sau này sẽ đọc lại. Bài viết này đi qua các cấu hình phần tử tạo nên cây đó, và DSL đánh dấu văn bản thay thế xây dựng cùng một cây mà không tạo trực tiếp các đối tượng Python.
Thư viện được nhập dưới dạng import omr, được cấp phép MIT, và chỉ phụ thuộc vào numpy, opencv-python, và Pillow.
Những gì được bao gồm
Cây mẫu
TemplateConfig là gốc tài liệu; nó chứa một hoặc nhiều đối tượng PageConfig, mỗi đối tượng cho một trang vật lý. Mỗi phần tử dưới một trang là một lớp con của BaseConfig, chứa tối thiểu một Name và một bộ phân biệt Type (ConfigType).
from omr.generation.config import TemplateConfig
from omr.generation.config.elements.parents import PageConfig
tpl = TemplateConfig()
tpl.Name = "quiz"
page = PageConfig()
page.Children = []
tpl.Children = [page]
Các phần tử câu hỏi
ChoiceBoxConfig định nghĩa một câu hỏi duy nhất với một bộ tùy chọn bong bóng cố định (mỗi bong bóng là ChoiceBoxAnswerConfig) và hỗ trợ chọn đa lựa chọn; FormValidationLogic, được thiết lập một lần cho mỗi TemplateProcessor, có thể phát sinh nếu một câu hỏi với Multiselect bị vô hiệu hoá nhận được nhiều hơn một dấu. AnswerSheetConfig bố trí một ma trận số có các bong bóng trả lời cho các tờ thi dạng đề, với BubbleType và BubbleSize có thể cấu hình. CheckBoxConfig là một nhóm có nhãn các hộp trống chấp nhận bất kỳ dấu nào, với ngưỡng lấp đầy có thể điều chỉnh.
from omr.generation.config.elements import AnswerSheetConfig
sheet = AnswerSheetConfig()
sheet.Name = "answers"
sheet.AnswersCount = 4 # bubbles per question (e.g. A-D)
sheet.ElementsCount = 20 # number of questions
Lưới và Lưới Tổng hợp
GridConfig hiển thị một ma trận chữ số — một số lượng cố định các phần, mỗi phần có các bong bóng tùy chọn 0–9 — được hợp nhất thành một giá trị duy nhất, thường được dùng cho số ID. CompositeGridConfig là biến thể linh hoạt hơn: một bộ ký hiệu tuỳ chỉnh cho mỗi cột, với các dấu trên các cột hợp nhất thành một giá trị.
Bộ chứa Bố cục
BlockConfig là một hộp có viền, có đệm; ContainerConfig sắp xếp các khối con thành cột hoặc chân trang; PositionedBlockConfig đặt các phần tử con tại các tọa độ tuyệt đối XPosition/YPosition thay vì để chúng chảy tự nhiên. BlockConfig và GlobalPageSettings cũng mang thuộc tính Overflow (OverflowAction là các lớp con của Clip/NoClip/Wrap) và LongWordHandling, nhưng các enum này được phân tích và xác thực đúng mà chưa được công cụ render của phiên bản này tôn trọng — hành vi tràn chưa thể cấu hình, và đang được theo dõi trong lộ trình upstream.
DSL Đánh dấu
Cây tương tự có thể được viết dưới dạng văn bản thuần thay vì các đối tượng Python. ?choicebox=... mở một câu hỏi dạng hộp lựa chọn, các dòng tiếp theo liệt kê các tùy chọn của nó, và &choicebox đóng lại.
import json
from omr.api import OmrEngine
markup = [
"?choicebox=Rate it",
"(1) Poor (2) Fair (3) Good",
"&choicebox",
]
engine = OmrEngine()
result = engine.Generate(markup)
desc = json.loads(result.Template)
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ở & Cấp 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ùng các điều khoản như bất kỳ dự án nào được cấp 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.