Pengantar

Aspose.OMR FOSS untuk Python’s public API (omr.api) sengaja dibuat kecil: OmrEngine, TemplateProcessor, ImageCollection, dan enum FormValidationLogic. Posting ini melihat apa yang dilakukan masing-masing dan bagaimana mereka terhubung dalam alur kerja generate → recognize → export.

Pustaka diimpor sebagai import omr, berlisensi MIT, dan hanya bergantung pada numpy, opencv-python, dan Pillow.


Apa yang Disertakan

OmrEngine — sebuah Stateless Factory

OmrEngine tidak menyimpan state di antara panggilan. Generate(source, settings) menerima baik sumber teks markup-DSL maupun pohon TemplateConfig code-first, dan mengembalikan sebuah GenerationResult — citra halaman serta template .omr JSON yang menggambarkan lokasi setiap elemen. GetTemplateProcessor(templateSource, validationLogic) memuat file .omr yang sebelumnya disimpan (atau deskriptor dalam memori) dan mengembalikan sebuah TemplateProcessor yang terikat padanya.

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 dan MemoryGenerationResult

GenerationResult mengekspos ErrorCode, ErrorMessage, Template (deskriptor .omr sebagai string JSON), TemplateImage, dan — untuk templat multi-halaman — MultipageTemplateImages. Save(folder, name) menulis gambar dan deskriptor ke disk; SaveAsPdf() tidak diimplementasikan dalam rilis ini dan menghasilkan NotImplementedError. MemoryGenerationResult membungkus data yang sama sebagai aliran dalam memori: GetImages() mengembalikan daftar aliran gambar dalam memori, dan GetOmr(encoding) mengembalikan deskriptor sebagai aliran — berguna ketika pemanggil tidak ingin menyentuh sistem berkas sama sekali.

TemplateProcessor — Mengenali Pemindaian

TemplateProcessor.Recognize(source, recognitionThreshold) membaca satu gambar yang dipindai terhadap templat tempat ia dibuat dan mengembalikan RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) menjalankan pengenalan yang sama pada setiap gambar dalam sebuah folder dalam satu panggilan, mengembalikan daftar hasil — memudahkan pemrosesan batch tumpukan pemindaian. Recalculate(result, recognitionThreshold) menghitung ulang skor hasil yang sudah dikenali dengan ambang batas yang berbeda, tanpa membaca ulang gambar sumber.

RecognitionResult — Membaca Jawaban

Setiap elemen dalam RecognitionResult.OmrElements mengimplementasikan IOmrElement, mengekspos GetAnswer() dan GetCsv() per elemen, bersama dengan QuestionName. Pada tingkat hasil, GetCsv(encoding), GetJson(encoding), dan GetXml(encoding) mengekspor seluruh hasil, masing-masing dengan varian ...AsStream yang cocok yang mengembalikan BytesIO alih-alih string biasa.

ImageCollection — Menyematkan Gambar dalam Markup

ImageCollection adalah peta hanya-tambah, sensitif huruf, dari nama ke byte gambar mentah. Add(name, image) mendaftarkan sebuah gambar, Contains(name) memeriksa apakah sebuah nama sudah terdaftar, dan as_dict() mengembalikan peta dasar. Markup kemudian dapat merujuk gambar yang terdaftar dengan nama (?image=<name>) alih-alih jalur sistem berkas — berguna ketika byte gambar berasal dari tempat lain selain disk, seperti unggahan web.


Panduan Cepat

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

Sumber Terbuka & Lisensi

Aspose.OMR FOSS untuk Python berlisensi MIT dan dihosting di GitHub. Penggunaan komersial diizinkan dengan syarat yang sama seperti proyek berlisensi MIT mana pun. Untuk fitur enterprise dan dukungan produksi, lihat Aspose.OMR — Enterprise Product Family.


Memulai

Sumber Daya Terkait