מבוא

Aspose.OMR FOSS עבור Python’s הציבורי API (omr.api) הוא קטן בכוונה: OmrEngine, TemplateProcessor, ImageCollection, וה-enum של FormValidationLogic. פוסט זה בוחן מה עושה כל אחד מהם וכיצד הם מתחברים בתהליך של generate → recognize → export.

הספרייה מיובאת כ-import omr, בעלת רישיון MIT, ותלויה רק ב-numpy, opencv-python ו-Pillow.


מה נכלל

OmrEngine — Factory ללא מצבים

OmrEngine אינו מחזיק במצב בין קריאות. Generate(source, settings) מקבל מקור טקסט markup-DSL או עץ TemplateConfig code-first, ומחזיר GenerationResult — את תמונת(ות) הדף בתוספת תבנית .omr JSON המתארת את מיקום כל אלמנט. GetTemplateProcessor(templateSource, validationLogic) טוען קובץ .omr שנשמר מראש (או מתאר בזיכרון) ומחזיר TemplateProcessor המקושר אליו.

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 ו-MemoryGenerationResult

GenerationResult חושף את ErrorCode, ErrorMessage, Template (התיאור של .omr כמחרוזת JSON), TemplateImage, ו — עבור תבניות מרובות דפים — MultipageTemplateImages. Save(folder, name) כותב את התמונה והתיאור אל הכונן; SaveAsPdf() אינו מיושם במהדורה זו ומעלה NotImplementedError. MemoryGenerationResult עוטף את אותם הנתונים כזרמים בזיכרון במקום זאת: GetImages() מחזיר רשימת זרמי תמונה בזיכרון, ו-GetOmr(encoding) מחזיר את התיאור כזרם — שימושי כאשר המתקשר אינו רוצה לגעת במערכת הקבצים בכלל.

TemplateProcessor — זיהוי סריקות

TemplateProcessor.Recognize(source, recognitionThreshold) קורא תמונה סרוקה אחת מול התבנית שממנה נוצרה ומחזיר RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) מריץ את הזיהוי הזה על כל תמונה בתיקייה בקריאה אחת, ומחזיר רשימת תוצאות — נוח לעיבוד אצווה של ערימת סריקות. Recalculate(result, recognitionThreshold) מחשב מחדש ציון של תוצאה שכבר זוהתה עם סף שונה, ללא קריאת תמונת המקור מחדש.

RecognitionResult — קריאת התשובות

כל רכיב ב-RecognitionResult.OmrElements מממש את IOmrElement, חושף GetAnswer() ו-GetCsv() לכל רכיב, לצד QuestionName. ברמת התוצאה, GetCsv(encoding), GetJson(encoding), ו-GetXml(encoding) מייצאים את כל התוצאה, כל אחד עם גרסת ...AsStream תואמת שמחזירה BytesIO במקום מחרוזת רגילה.

ImageCollection — הטמעת תמונות במרקאפ

ImageCollection הוא מפת הוספה בלבד, רגישת רישיות, שממפה שם לבייטים גולמיים של תמונה. Add(name, image) רושמת תמונה, Contains(name) בודקת האם שם כבר רשום, ו-as_dict() מחזירה את המפה התומכת. המרקאפ יכול אז להתייחס לתמונה רשומה לפי שם (?image=<name>) במקום נתיב קובץ — שימושי כאשר בייטי התמונה מגיעים ממקור שאינו דיסק, כגון העלאה מהאינטרנט.


התחלה מהירה

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.


התחלה

משאבים קשורים