Giriş

Aspose.OMR FOSS, Python’ın genel API (omr.api) için kasıtlı olarak küçüktür: OmrEngine, TemplateProcessor, ImageCollection ve FormValidationLogic enum’ı. Bu yazı, her birinin ne yaptığını ve bir üret → tanı → dışa aktar iş akışı boyunca nasıl bağlandıklarını inceliyor.

Kütüphane import omr olarak içe aktarılır, MIT lisanslıdır ve yalnızca numpy, opencv-python ve Pillow‘a bağımlıdır.


Neler Dahil

OmrEngine — Durumsuz Bir Fabrika

OmrEngine çağrılar arasında hiçbir durum tutmaz. Generate(source, settings), ya bir markup-DSL metin kaynağını ya da kod-öncelikli TemplateConfig ağacını kabul eder ve bir GenerationResult döndürür — sayfa görüntüsü(leri) ve her öğenin konumunu tanımlayan bir .omr şablon JSON. GetTemplateProcessor(templateSource, validationLogic), daha önce kaydedilmiş bir .omr dosyasını (veya bellek içi tanımlayıcıyı) yükler ve ona bağlı bir TemplateProcessor döndürür.

from omr.api import OmrEngine, FormValidationLogic

engine = OmrEngine()
gen = engine.Generate("final-exam.txt")
gen.Save("out", "final-exam")
processor = engine.GetTemplateProcessor("out/final-exam.omr", FormValidationLogic.Ignore)

GenerationResult ve MemoryGenerationResult

GenerationResult, ErrorCode, ErrorMessage, Template (.omr tanımlayıcısını bir JSON dizesi olarak), TemplateImage ve — çok sayfalı şablonlar için — MultipageTemplateImages öğelerini ortaya çıkarır. Save(folder, name) görüntüyü ve tanımlayıcıyı diske yazar; SaveAsPdf() bu sürümde uygulanmamıştır ve NotImplementedError hatasını yükseltir. MemoryGenerationResult aynı veriyi bellek içi akışlar olarak sarar: GetImages() bellek içi görüntü akışlarının bir listesini döndürür ve GetOmr(encoding) tanımlayıcıyı bir akış olarak döndürür — çağıranın dosya sistemine hiç dokunmak istemediği durumlarda faydalıdır.

TemplateProcessor — Taramaları Tanıma

TemplateProcessor.Recognize(source, recognitionThreshold), oluşturulduğu şablona karşı tek bir taranmış görüntüyü okur ve bir RecognitionResult döndürür. RecognizeFolder(folderPath, recognitionThreshold), bir klasördeki her görüntü üzerinde aynı tanıma işlemini tek bir çağrıda çalıştırır ve bir sonuç listesi döndürür — tarama yığınına toplu işlem uygulamak için uygundur. Recalculate(result, recognitionThreshold), kaynak görüntüyü yeniden okumadan, farklı bir eşik değeriyle zaten tanınmış bir sonucu yeniden puanlar.

RecognitionResult — Yanıtları Okuma

RecognitionResult.OmrElements içindeki her öğe IOmrElement uygular, her öğe için GetAnswer() ve GetCsv() öğelerini, QuestionName ile birlikte ortaya çıkarır. Sonuç düzeyinde, GetCsv(encoding), GetJson(encoding) ve GetXml(encoding) tüm sonucu dışa aktarır; her biri, yalın bir dize yerine bir BytesIO döndüren eşleşen bir ...AsStream varyantına sahiptir.

ImageCollection — İşaretlemede Görüntü Gömme

ImageCollection, bir isimden ham görüntü baytlarına ekleme sadece, büyük/küçük harfe duyarlı bir haritadır. Add(name, image), bir görüntüyü kaydeder, Contains(name), bir ismin zaten kaydedilip kaydedilmediğini kontrol eder ve as_dict(), arka plan haritasını döndürür. İşaretleme daha sonra kayıtlı bir görüntüyü isim (?image=<name>) ile, dosya sistemi yolunun yerine referans alabilir — görüntü baytları disk dışı bir kaynaktan, örneğin bir web yüklemesinden geldiğinde faydalıdır.


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ı şartlar 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