Введение

Создание 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.


Начало работы

Связанные ресурсы