Giới thiệu

Aspose.OMR FOSS cho Python công khai API (omr.api) được thiết kế cố ý nhỏ: OmrEngine, TemplateProcessor, ImageCollection, và enum FormValidationLogic. Bài viết này xem xét chức năng của từng mục và cách chúng kết nối trong quy trình tạo → nhận dạng → xuất.

Thư viện được nhập dưới dạng import omr, có giấy phép MIT, và chỉ phụ thuộc vào numpy, opencv-python và Pillow.


Các thành phần bao gồm

OmrEngine — một Nhà máy không trạng thái

OmrEngine không giữ trạng thái nào giữa các lần gọi. Generate(source, settings) chấp nhận hoặc nguồn văn bản markup-DSL hoặc cây TemplateConfig code-first, và trả về một GenerationResult — hình ảnh trang (các) cộng với một mẫu .omr JSON mô tả vị trí của mọi phần tử. GetTemplateProcessor(templateSource, validationLogic) tải một tệp .omr đã lưu trước (hoặc một mô tả trong bộ nhớ) và trả về một TemplateProcessor được liên kết với nó.

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 và MemoryGenerationResult

GenerationResult cung cấp ErrorCode, ErrorMessage, Template (bộ mô tả .omr dưới dạng một chuỗi JSON), TemplateImage, và — đối với các mẫu đa trang — MultipageTemplateImages. Save(folder, name) ghi ảnh và bộ mô tả ra đĩa; SaveAsPdf() không được triển khai trong phiên bản này và gây ra NotImplementedError. MemoryGenerationResult bao bọc cùng dữ liệu dưới dạng các luồng trong bộ nhớ: GetImages() trả về danh sách các luồng ảnh trong bộ nhớ, và GetOmr(encoding) trả về bộ mô tả dưới dạng luồng — hữu ích khi người gọi không muốn chạm tới hệ thống tệp.

TemplateProcessor — Nhận dạng bản quét

TemplateProcessor.Recognize(source, recognitionThreshold) đọc một ảnh đã quét so với mẫu mà nó được tạo ra và trả về một RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) thực hiện cùng quá trình nhận dạng trên mọi ảnh trong một thư mục trong một lần gọi, trả về danh sách các kết quả — thuận tiện cho việc xử lý hàng loạt một đống bản quét. Recalculate(result, recognitionThreshold) tính lại điểm cho một kết quả đã được nhận dạng với ngưỡng khác, mà không cần đọc lại ảnh nguồn.

RecognitionResult — Đọc câu trả lời

Mỗi phần tử trong RecognitionResult.OmrElements thực thi IOmrElement, cung cấp GetAnswer() và GetCsv() cho mỗi phần tử, cùng với QuestionName. Ở mức độ kết quả, GetCsv(encoding), GetJson(encoding), và GetXml(encoding) xuất toàn bộ kết quả, mỗi cái có một biến thể ...AsStream tương ứng trả về một BytesIO thay vì một chuỗi thông thường.

ImageCollection — Nhúng hình ảnh trong đánh dấu

ImageCollection là một bản đồ chỉ-được-thêm, phân biệt chữ hoa chữ thường từ một tên tới các byte hình ảnh thô. Add(name, image) đăng ký một hình ảnh, Contains(name) kiểm tra xem tên đã được đăng ký chưa, và as_dict() trả về bản đồ nền. Đánh dấu sau đó có thể tham chiếu tới một hình ảnh đã đăng ký bằng tên (?image=<name>) thay vì đường dẫn hệ thống tệp — hữu ích khi các byte hình ảnh đến từ nơi khác ngoài đĩa, chẳng hạn như tải lên qua web.


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ở & Bản quyền

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ó 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