Введение
Создание 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.
Начало работы
- Начало работы
- Руководство разработчика
- Статьи базы знаний
- API Reference
- Aspose.OMR FOSS для Python на GitHub