Вступ
Aspose.OMR FOSS для Python — це бібліотека з відкритим кодом для створення OMR (optical mark recognition) форм — листів відповідей з множинним вибором, форм з прапорцями та опитувань — та розпізнавання позначок, які заповнює респондент на відсканованому або сфотографованому зображенні. Вона орієнтована на розробників, які автоматизують оцінювання іспитів, підрахунок результатів опитувань або збір даних за допомогою форм у Python.
Бібліотека імпортується як import omr і не має залежності від жодного комерційного пакету Aspose. Вона ліцензована за MIT і побудована на трьох залежностях: numpy, opencv-python та Pillow. Це ранній випуск (v0.1.0), який охоплює шари фундаменту, генерації та розпізнавання повної Aspose.OMR поверхні.
Що включено
Дерево шаблонів Code-First
Шаблон — це дерево конфігурацій елементів, коренем якого є 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 і ще не враховує поведінку переповнення — обидва питання відстежуються у дорожній карті upstream як ще не реалізовані.
Випрямлення та переналаштування
Розпізнавання виправляє спотворення сканування за допомогою кутових орієнтирних позначок (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()
Open Source та ліцензування
Aspose.OMR FOSS для Python має ліцензію MIT і розміщений на GitHub. Комерційне використання дозволено на тих самих умовах, що й будь-який проект під ліцензією MIT. Для корпоративних функцій та виробничої підтримки дивіться Aspose.OMR — Enterprise Product Family.