מבוא
Aspose.OMR FOSS עבור Python היא ספרייה קוד פתוח לעיצוב טפסי OMR (זיהוי סימון אופטי) — גיליונות תשובות מרובי-בחירה, טפסי תיבות סימון וסקרים — וזיהוי הסימנים שהמשיב ממלא בתמונה סרוקה או מצולמת. היא מיועדת למפתחים האוטומטיים את דירוג המבחנים, טבלאת הסקרים, או איסוף נתונים מבוסס טפסים ב-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).
Enum של מערכת כתיבה וגלישה
שכבת התבנית מגדירה מערכות כתיבה Arabic, Hebrew, Persian, Urdu ו-Bengali (לצד ברירת המחדל Western), וכן תתי-מחלקות LongWordHandling/OverflowAction (Clip, NoClip, Wrap) לגלישת טקסט. שני קבוצות ה-enum מפענחות ומאמתות כראוי עבור נאמנות API עם משטח Aspose.OMR, אך מנוע הרינדור של גרסה זו תומך רק ב-LTR/מערב ואין עדיין התחשבות בהתנהגות הגלישה — שני הנושאים מתועדים במפת הדרכים העליונה כלא מיושמים עדיין.
הסרת הטייה וכיול מחדש
הזיהוי מתקן הטייה בסריקה באמצעות סימני ייחוס בפינות (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.