مقدمه

تولید یک فرم 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 یک ماتریس عددی را رندر می‌کند — تعداد ثابتی از بخش‌ها، هر کدام با حباب‌های گزینه ۰ تا ۹ — که به یک مقدار واحد ترکیب می‌شود و معمولاً برای شماره‌های شناسه استفاده می‌شود. CompositeGridConfig نسخهٔ انعطاف‌پذیرتر است: مجموعهٔ نمادهای سفارشی برای هر ستون، به‌طوری که علامت‌ها در ستون‌ها به یک مقدار ترکیب شوند.

محفظه‌های چیدمان

BlockConfig یک جعبه با حاشیه و پدینگ است؛ ContainerConfig بلوک‌های فرزند را به ستون‌ها یا پاورقی صفحه مرتب می‌کند؛ PositionedBlockConfig فرزندان را در مختصات مطلق XPosition/YPosition قرار می‌دهد به‌جای جریان طبیعی آن‌ها. BlockConfig و GlobalPageSettings همچنین یک ویژگی Overflow دارند (OverflowAction زیرکلاس‌های Clip/NoClip/Wrap) و LongWordHandling، اما این enumها به‌درستی تجزیه و اعتبارسنجی می‌شوند بدون اینکه هنوز توسط موتور رندر این نسخه احترام داده شود — رفتار سرریز هنوز قابل تنظیم نیست و در نقشهٔ راه بالا‌دستی پیگیری می‌شود.

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 مراجعه کنید.


شروع به کار

منابع مرتبط