Вступ
Створення 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 відображає матрицю цифр — фіксовану кількість секцій, кожна з 0–9 бульбашок-опцій — об’єднаних в одне значення, зазвичай використовується для ідентифікаційних номерів. CompositeGridConfig — більш гнучкий варіант: індивідуальний набір символів для кожного стовпця, при чому позначки в різних стовпцях об’єднуються в одне значення.
Контейнери розмітки
BlockConfig — це коробка з рамкою та відступами; ContainerConfig розташовує дочірні блоки у стовпці або у нижньому колонтитулі сторінки; PositionedBlockConfig розміщує дочірні елементи за абсолютними координатами XPosition/YPosition замість їх поточного потоку. BlockConfig і GlobalPageSettings також мають властивість Overflow (OverflowAction підкласи Clip/NoClip/Wrap) та LongWordHandling, але ці перерахування правильно аналізуються та валідуються, хоча ще не підтримуються рушієм рендерингу цього випуску — поведінка переповнення ще не налаштовується і відстежується в дорожній карті upstream.
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.