Giriş

Aspose.OMR FOSS for Python, taranmış veya fotoğraflanmış bir görüntüden yanıtlayanın işaretlediği işaretleri tanıyan — çoktan seçmeli cevap kağıtları, onay kutulu formlar ve anketler — OMR (optik işaret tanıma) formları tasarlamak ve tanımak için açık kaynaklı bir kütüphanedir. Python içinde sınav puanlamasını, anket toplama ya da form tabanlı veri toplama süreçlerini otomatikleştiren geliştiricileri hedefler.

Kütüphane import omr olarak içe aktarılır ve herhangi bir Aspose ticari paketine bağımlılığı yoktur. MIT lisanslıdır ve üç bağımlılık üzerine inşa edilmiştir: numpy, opencv-python ve Pillow. Bu, tam Aspose.OMR yüzeyinin temel, üretim ve tanıma katmanlarını kapsayan erken bir sürümdür (v0.1.0).


Neler Dahildir

Kod-İlk Şablon Ağacı

Bir şablon, TemplateConfig köküne sahip element yapılandırmalarının bir ağacıdır; her fiziksel sayfa için PageConfig ve sorular için ChoiceBoxConfig, CheckBoxConfig, GridConfig, CompositeGridConfig ve AnswerSheetConfig gibi element yapılandırmaları bulunur. BlockConfig ve ContainerConfig kenarlı kutular ve sütun düzenleri sağlar, PositionedBlockConfig ise çocukları mutlak koordinatlarda konumlandırır.

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]

Bir Metin-İşaretleme DSL

Aynı öğe ağacı, Python nesneleri yerine kompakt bir metin biçiminden oluşturulabilir — şablonu hızlıca elle oluşturmak veya daha basit bir veri kaynağından üretmek için kullanışlıdır.

from omr.api import OmrEngine

markup = [
    "?choicebox=Rate it",
    "(1) Poor (2) Fair (3) Good",
    "&choicebox",
]
engine = OmrEngine()
result = engine.Generate(markup)

Tanıma ve Dışa Aktarma

TemplateProcessor.Recognize(), taranmış bir görüntüyü önceden oluşturulmuş bir şablonla karşılaştırır ve bir RecognitionResult döndürür. Sonuç, CSV, JSON veya XML formatında dışa aktarılır; her biri eşleşen bellek içi akış varyantı (GetCsvAsStream, GetJsonAsStream, GetXmlAsStream) ile birlikte gelir.

Yazı Sistemi ve Taşma Enum’ları

Şablon katmanı, Arabic, Hebrew, Persian, Urdu ve Bengali yazı sistemlerini (Western varsayılanı ile birlikte) ve metin taşması için LongWordHandling/OverflowAction alt sınıflarını (Clip, NoClip, Wrap) tanımlar. Her iki enum grubu da API doğruluğu için Aspose.OMR yüzeyiyle doğru şekilde ayrıştırılır ve doğrulanır, ancak bu sürümün render motoru yalnızca LTR/Western destekli olup henüz taşma davranışını uygulamıyor — her ikisi de henüz uygulanmamış olarak üst yol haritasında izleniyor.

Eğrilik Düzeltme ve Yeniden Kalibrasyon

Tanıma, köşe referans işaretlerini (ReferencePointsSettings) kullanarak tarama eğriliğini düzeltir. TemplateProcessor.Recalculate(), görüntüyü yeniden taramadan mevcut sonuca farklı bir tanıma eşiği yeniden uygular.


Hızlı Başlangıç

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()

Açık Kaynak & Lisanslama

Aspose.OMR FOSS for Python MIT lisanslıdır ve GitHub üzerinde barındırılmaktadır. Ticari kullanım, herhangi bir MIT lisanslı proje ile aynı koşullar altında izin verilir. Kurumsal özellikler ve üretim desteği için Aspose.OMR — Enterprise Product Family bölümüne bakın.


Başlarken

İlgili Kaynaklar