مقدمة

Aspose.OMR FOSS لـ Python هي مكتبة مفتوحة المصدر لتصميم نماذج OMR (التعرف البصري على العلامات) — أوراق إجابات متعددة الخيارات، نماذج مربعات الاختيار، والاستطلاعات — وتعرف العلامات التي يملأها المستجيب من صورة ممسوحة أو مُصورة. تستهدف المطورين الذين ي automatis…المطورين الذين يقومون بأتمتة تصحيح الامتحانات، تجميع نتائج الاستطلاعات، أو جمع البيانات القائمة على النماذج في Python.

يتم استيراد المكتبة كـ import omr ولا تعتمد على أي حزمة تجارية Aspose. هي مرخصة تحت رخصة MIT ومبنية على ثلاثة تبعيات: numpy، opencv-python، وPillow. هذا إصدار مبكر (v0.1.0) يغطي طبقات الأساس، الإنشاء، والتعرف من السطح الكامل Aspose.OMR.


ما المتضمن

شجرة قالب برمجية أولى

القالب هو شجرة من تكوينات العناصر جذعها TemplateConfig، مع PageConfig لكل صفحة فعلية وتكوينات العناصر مثل ChoiceBoxConfig، CheckBoxConfig، GridConfig، CompositeGridConfig، وAnswerSheetConfig للأسئلة نفسها. يوفر BlockConfig وContainerConfig صناديق ذات حدود وتخطيطات أعمدة، ويضع PositionedBlockConfig الأطفال عند إحداثيات مطلقة.

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]

لغة توصيف نصية DSL

يمكن بناء شجرة العناصر نفسها من تنسيق نصي مضغوط بدلاً من كائنات Python — مفيد لإنشاء قالب يدويًا بسرعة أو توليده من مصدر بيانات أبسط.

from omr.api import OmrEngine

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

التعرف والتصدير

TemplateProcessor.Recognize() يقرأ صورة ممسوحة ضوئيًا مقابل قالب تم إنشاؤه مسبقًا ويعيد RecognitionResult. يتم تصدير النتيجة إلى CSV أو JSON أو XML، كل منها مع نسخة تدفق في الذاكرة المطابقة (GetCsvAsStream، GetJsonAsStream، GetXmlAsStream).

تعدادات نظام الكتابة وتعدادات الفائض

تعرف طبقة القالب أنظمة الكتابة Arabic، Hebrew، Persian، Urdu، وBengali (إلى جانب الافتراضي Western)، وتحت الفئات LongWordHandling/OverflowAction ( Clip، NoClip، Wrap) لتدفق النص. كلا مجموعتي التعداد تحللان وتتحققان بشكل صحيح من دقة API مع سطح Aspose.OMR، لكن محرك العرض في هذا الإصدار يدعم فقط LTR/Western ولا يطبق بعد سلوك الفائض — كلاهما متتبع في خارطة الطريق العليا كغير مُنفذ بعد.

إزالة الانحراف وإعادة المعايرة

يقوم التعرف بتصحيح انحراف المسح باستخدام علامات مرجعية في الزوايا (ReferencePointsSettings). TemplateProcessor.Recalculate() يعيد تطبيق عتبة تعريف مختلفة على نتيجة موجودة دون إعادة مسح الصورة.


البدء السريع

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.


البدء

الموارد ذات الصلة