Wprowadzenie

Aspose.OMR FOSS dla publicznego API Python (omr.api) jest celowo małe: OmrEngine, TemplateProcessor, ImageCollection oraz wyliczenie FormValidationLogic. Ten wpis przygląda się, co każdy z nich robi i jak łączą się w przepływie pracy generuj → rozpoznaj → eksport.

Biblioteka importuje się jako import omr, jest licencjonowana na licencji MIT i zależy wyłącznie od numpy, opencv-python oraz Pillow.


Co jest w zestawie

OmrEngine — fabryka bezstanowa

OmrEngine nie przechowuje żadnego stanu pomiędzy wywołaniami. Generate(source, settings) przyjmuje albo źródło tekstowe markup-DSL, albo drzewo TemplateConfig tworzone w kodzie, i zwraca GenerationResult — obraz(y) strony plus szablon .omr JSON opisujący położenie każdego elementu. GetTemplateProcessor(templateSource, validationLogic) ładuje wcześniej zapisany plik .omr (lub deskryptor w pamięci) i zwraca TemplateProcessor powiązany z nim.

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 udostępnia ErrorCode, ErrorMessage, Template (deskryptor .omr jako ciąg JSON), TemplateImage oraz — dla szablonów wielostronicowych — MultipageTemplateImages. Save(folder, name) zapisuje obraz i deskryptor na dysk; SaveAsPdf() nie jest zaimplementowane w tym wydaniu i podnosi NotImplementedError. MemoryGenerationResult opakowuje te same dane jako strumienie w pamięci zamiast: GetImages() zwraca listę strumieni obrazów w pamięci, a GetOmr(encoding) zwraca deskryptor jako strumień — przydatne, gdy wywołujący nie chce w ogóle dotykać systemu plików.

TemplateProcessor — Rozpoznawanie skanów

TemplateProcessor.Recognize(source, recognitionThreshold) odczytuje jeden zeskanowany obraz względem szablonu, z którego został utworzony, i zwraca RecognitionResult. RecognizeFolder(folderPath, recognitionThreshold) uruchamia to samo rozpoznawanie dla każdego obrazu w folderze w jednym wywołaniu, zwracając listę wyników — wygodne przy przetwarzaniu wsadowym stosu skanów. Recalculate(result, recognitionThreshold) ponownie ocenia już rozpoznany wynik z innym progiem, bez ponownego odczytywania obrazu źródłowego.

RecognitionResult — Odczytywanie odpowiedzi

Każdy element w RecognitionResult.OmrElements implementuje IOmrElement, udostępniając GetAnswer() i GetCsv() dla każdego elementu, obok QuestionName. Na poziomie wyniku, GetCsv(encoding), GetJson(encoding) i GetXml(encoding) eksportują cały wynik, każdy z dopasowaną wariantą ...AsStream, która zwraca BytesIO zamiast zwykłego ciągu znaków.

ImageCollection — Osadzanie obrazów w znacznikach

ImageCollection jest mapą tylko do dopisywania, rozróżniającą wielkość liter, mapującą nazwę na surowe bajty obrazu. Add(name, image) rejestruje obraz, Contains(name) sprawdza, czy nazwa jest już zarejestrowana, a as_dict() zwraca bazową mapę. Znaczniki mogą wtedy odwoływać się do zarejestrowanego obrazu po nazwie (?image=<name>) zamiast ścieżki systemu plików — przydatne, gdy bajty obrazu pochodzą z innego źródła niż dysk, np. z przesłania przez sieć.


Szybki start

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 licencjonowanie

Aspose.OMR FOSS dla Python jest licencjonowane na licencji MIT i hostowane na GitHub. Komercyjne użycie jest dozwolone na tych samych warunkach, co każdy projekt na licencji MIT. Aby uzyskać informacje o funkcjach enterprise i wsparciu produkcyjnym, zobacz Aspose.OMR — Enterprise Product Family.


Rozpoczęcie

Powiązane zasoby