Вступ

Створення 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.


Початок роботи

Пов’язані ресурси