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.