Introducere

Aspose.OMR FOSS pentru Python’s public API (omr.api) este intenționat mic: OmrEngine, TemplateProcessor, ImageCollection, și enumul FormValidationLogic. Acest articol analizează ce face fiecare și cum se leagă printr-un flux de lucru de tip generează → recunoaște → exportă.

Biblioteca se importă ca import omr, are licență MIT și depinde numai de numpy, opencv-python și Pillow.


Ce este inclus

OmrEngine — o fabrică fără stare

OmrEngine nu păstrează stare între apeluri. Generate(source, settings) acceptă fie o sursă text markup-DSL, fie un arbore TemplateConfig code-first, și returnează un GenerationResult — imaginea(e) paginii plus un .omr șablon JSON care descrie locația fiecărui element. GetTemplateProcessor(templateSource, validationLogic) încarcă un fișier .omr salvat anterior (sau un descriptor în memorie) și returnează un TemplateProcessor legat de el.

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 și MemoryGenerationResult

GenerationResult expune ErrorCode, ErrorMessage, Template (descriptorul .omr ca un șir JSON), TemplateImage, și — pentru șabloane multi-pagină — MultipageTemplateImages. Save(folder, name) scrie imaginea și descriptorul pe disc; SaveAsPdf() nu este implementat în această versiune și generează NotImplementedError. MemoryGenerationResult înfășoară aceleași date ca fluxuri în memorie în schimb: GetImages() returnează o listă de fluxuri de imagini în memorie și GetOmr(encoding) returnează descriptorul ca un flux — util când un apelant nu dorește să atingă sistemul de fișiere deloc.

TemplateProcessor — Recunoașterea scanărilor

TemplateProcessor.Recognize(source, recognitionThreshold) citește o imagine scanată comparativ cu șablonul din care a fost creată și returnează un RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) rulează aceeași recunoaștere pentru fiecare imagine dintr-un folder într-un singur apel, returnând o listă de rezultate — convenabil pentru procesarea în lot a unui set de scanări. Recalculate(result, recognitionThreshold) recalibrează un rezultat deja recunoscut cu un prag diferit, fără a reciti imaginea sursă.

RecognitionResult — Citirea răspunsurilor

Fiecare element din RecognitionResult.OmrElements implementează IOmrElement, expunând GetAnswer() și GetCsv() pentru fiecare element, alături de QuestionName. La nivel de rezultat, GetCsv(encoding), GetJson(encoding) și GetXml(encoding) exportă întregul rezultat, fiecare având o variantă ...AsStream corespunzătoare care returnează un BytesIO în loc de un șir simplu.

ImageCollection — Încorporarea imaginilor în markup

ImageCollection este o hartă numai de adăugare, sensibilă la majuscule, de la un nume la octeți de imagine brută. Add(name, image) înregistrează o imagine, Contains(name) verifică dacă un nume este deja înregistrat și as_dict() returnează harta de bază. Markup poate apoi să facă referire la o imagine înregistrată prin nume (?image=<name>) în loc de o cale de sistem de fișiere — util când octeții imaginii provin din altă sursă decât discul, cum ar fi un încărcare web.


Start rapid

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

Open Source și Licențiere

Aspose.OMR FOSS pentru Python este licențiat sub MIT și găzduit pe GitHub. Utilizarea comercială este permisă în aceleași condiții ca orice proiect licențiat MIT. Pentru funcționalități enterprise și suport de producție, vedeți Aspose.OMR — Enterprise Product Family.


Începeți

Resurse conexe