บทนำ

การสร้างแบบฟอร์ม OMR ใน Aspose.OMR FOSS สำหรับ Python หมายถึงการสร้างต้นไม้ของการกำหนดค่าองค์ประกอบที่มีรากอยู่ที่ TemplateConfig แล้วส่งต้นไม้ดังกล่าวให้กับ OmrEngine.Generate() เครื่องยนต์จะเรนเดอร์ภาพหน้าและคำอธิบาย .omr ซึ่งขั้นตอนการจดจำภายหลังจะอ่านกลับ บทความนี้จะพาไปดูการกำหนดค่าองค์ประกอบที่ประกอบเป็นต้นไม้ดังกล่าว และ DSL ที่เป็นข้อความมาร์กอัปทางเลือกที่สร้างต้นไม้เดียวกันโดยไม่ต้องสร้างอ็อบเจกต์ Python โดยตรง.

ไลบรารีถูกนำเข้าเป็น import omr, มีสัญญาอนุญาต MIT, และขึ้นอยู่เพียงแค่ numpy, opencv-python และ Pillow.


สิ่งที่รวมอยู่

ต้นไม้เทมเพลต

TemplateConfig คือรากของเอกสาร; มันประกอบด้วยอ็อบเจกต์ PageConfig หนึ่งตัวหรือมากกว่า, หนึ่งต่อแต่ละหน้ากายภาพ ทุกองค์ประกอบที่อยู่ใต้หน้าเป็นคลาสย่อยของ BaseConfig, มีอย่างน้อย Name และตัวแยกประเภท 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]

องค์ประกอบคำถาม

ChoiceBoxConfig กำหนดคำถามเดียวที่มีชุดบับเบิ้ลตัวเลือกคงที่ (แต่ละอันเป็น ChoiceBoxAnswerConfig) และรองรับการเลือกหลายตัว; FormValidationLogic ซึ่งตั้งค่าเพียงครั้งต่อ TemplateProcessor สามารถเกิดขึ้นได้หากคำถามที่มีการปิดใช้งาน Multiselect รับเครื่องหมายมากกว่าหนึ่งครั้ง. AnswerSheetConfig จัดเรียงเมทริกซ์ตัวเลขของบับเบิ้ลคำตอบสำหรับแผ่นแบบสอบถาม, พร้อมกับ BubbleType ที่กำหนดค่าได้และ BubbleSize. CheckBoxConfig คือกลุ่มที่มีป้ายกำกับของกล่องว่างที่รับเครื่องหมายใด ๆ ได้, พร้อมเกณฑ์การเติมที่ปรับได้.

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

กริดและกริดเชิงประกอบ

GridConfig แสดงเมทริกซ์ตัวเลข — จำนวนส่วนคงที่, แต่ละส่วนมีบับเบิ้ลตัวเลือก 0–9 — รวมเป็นค่าเดียว, มักใช้สำหรับหมายเลขประจำตัว. CompositeGridConfig เป็นรูปแบบที่ยืดหยุ่นกว่า: ชุดสัญลักษณ์กำหนดเองต่อคอลัมน์, โดยเครื่องหมายข้ามคอลัมน์จะถูกรวมเป็นค่าเดียว.

คอนเทนเนอร์การจัดวาง

BlockConfig เป็นกล่องที่มีขอบและช่องว่าง; ContainerConfig จัดบล็อกลูกเป็นคอลัมน์หรือส่วนท้ายของหน้า; PositionedBlockConfig วางลูกที่พิกัด XPosition/YPosition แบบสัมบูรณ์แทนการไหลตามปกติ. BlockConfig และ GlobalPageSettings ยังมีคุณสมบัติ Overflow (OverflowAction เป็นคลาสย่อยของ Clip/NoClip/Wrap) และ LongWordHandling, แต่ enum เหล่านี้สามารถพาร์สและตรวจสอบความถูกต้องได้อย่างถูกต้องแม้ยังไม่ได้รับการสนับสนุนโดยเอนจิ้นการเรนเดอร์ของรุ่นนี้ — พฤติกรรม overflow ยังไม่สามารถกำหนดค่าได้, และกำลังถูกติดตามในโรดแมพของอัปสตรีม.

DSL การทำเครื่องหมาย

ต้นไม้เดียวกันสามารถเขียนเป็นข้อความธรรมดาแทนวัตถุ Python ได้. ?choicebox=... เปิดคำถามแบบกล่องเลือก, บรรทัดต่อไปแสดงรายการตัวเลือก, และ &choicebox ปิดมัน.

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)

เริ่มต้นอย่างเร็ว

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 สำหรับ Python มีใบอนุญาตแบบ MIT และโฮสต์บน GitHub. การใช้เชิงพาณิชย์ได้รับอนุญาตตามเงื่อนไขเดียวกับโครงการที่ใช้ใบอนุญาต MIT ใด ๆ. สำหรับคุณลักษณะระดับองค์กรและการสนับสนุนการผลิต ดูที่ Aspose.OMR — Enterprise Product Family.


เริ่มต้นใช้งาน

แหล่งข้อมูลที่เกี่ยวข้อง