deniz.in

Piyasalar

Hava durumu

Hava durumu yükleniyor

· kaynak dev.to (home feed)

FastMRZ 3 saf Python ile pasaport MRZ alanlarını okuyor, Tesseract'a gerek yok

FastMRZ 3, Tesseract'ın yerine 37 karakterlik MRZ alfabesiyle eğitilmiş, pakete dahil bir ONNX modeli getiriyor; ayrıca PDF girdisi, toplu işleme ve ICAO 9303 kontrol basamağı doğrulaması ekleniyor.

FastMRZ 3 saf Python ile pasaport MRZ alanlarını okuyor, Tesseract'a gerek yok

Pasaport, kimlik kartı ve vizelerdeki makine tarafından okunabilir alanı (MRZ) okumak için kullanılan açık kaynak Python kütüphanesi FastMRZ'nin 3. sürümü yayımlandı — ve en büyük değişiklik Tesseract'ın kaldırılmış olması. Kütüphanenin geliştiricisi Sivakumar Mahalingam'ın dev.to'daki yazısına göre FastMRZ 3, artık özellikle MRZ karakter setiyle eğitilmiş, kendi içindeki ONNX tabanlı metin tanıyıcısını içeriyor; böylece paket sıradan Python bağımlılıkları olarak kuruluyor ve ne sistem düzeyinde bir OCR motoru ne de yönetilmesi gereken traineddata dosyaları gerekiyor.

Ortadan kaldırdığı kurulum sorunu

MRZ, bir seyahat belgesinin alt kısmındaki, < karakterleriyle doldurulmuş iki ya da üç satırlık metin bloğudur. Dev.to yazısının açıkladığı gibi alfabesi çok küçüktür: 37 olası karakter (A–Z, 0–9 ve dolgu karakteri <), ICAO 9303 standardının tanımladığı sabit düzenlerde dizilmiş halde. Bu dar kapsama rağmen çoğu Python MRZ aracı tarihsel olarak Tesseract'ı sarmalamıştır; işletim sistemi düzeyinde kurulması ve özel bir MRZ traineddata dosyasıyla yapılandırılması gereken genel amaçlı bir OCR motoru. Yazar, bu kurulumun container imajlarında, serverless katmanlarında ve CI runner'larında tekrarlanması gerektiğini, üstelik yine de eğik, odaklanmamış ya da kötü ışıklandırılmış telefon fotoğraflarında sonuçların kötü olabileceğini belirtiyor.

FastMRZ'nin önceki sürümleri de perde arkasında Tesseract kullandığı için aynı zayıflığı taşıyordu. Sürüm 3 bunu tamamen bırakıyor.

Genel OCR motoru yerine dar kapsamlı bir tanıyıcı

Yazı, dört aşamalı bir pipeline tanımlıyor. İlk olarak, OpenCV kontur algılama ile bir ONNX modeli birlikte MRZ bölgesini buluyor; belge kare içinde tam hizalı olmasa bile. İkinci olarak şerit kırpılıyor, düzleştiriliyor ve normalize ediliyor. Üçüncü olarak küçük bir ONNX model karakterleri tanıyor — her dildeki her karakter yerine yalnızca OCR-B yazı tipiyle çizilmiş 37 sembolü ayırt etmek zorunda olduğu için daha küçük olabiliyor ve bu özel iş için daha güvenilir oluyor. Son olarak ICAO 9303 tarafından tanımlanan her kontrol basamağı doğrulanıyor ve alanlar yapılandırılmış çıktı olarak ayrıştırılıyor.

Her şey CPU'da yerel olarak çalışıyor, yani hiçbir belge görüntüsü makineden çıkmıyor — girdilerin çoğunlukla pasaport olduğu düşünüldüğünde yazarın üzerinde durduğu bir nokta bu. Bağımlılık listesi kısa: numpy, opencv-python-headless ve pymupdf; tek bir pip install fastmrz ile kuruluyor.

Girdiler, doğrulama ve toplu işleme

Kütüphane dosya yollarının ötesinde, kamera kareleri gibi NumPy dizilerini, Base64 dizelerini, ham baytları, taranmış PDF'leri ve önceden çıkarılmış MRZ metnini kabul ediyor; bunlar input_type parametresiyle seçiliyor. API'yi tamamlayan iki yardımcı fonksiyon var: yalnızca kontrol basamaklarını denetleyen validate_mrz ve denetim kayıtları ya da manuel inceleme için düzeltilmiş MRZ kırpımını döndüren get_mrz_image.

Ayrıştırılan sonuçlar bir status alanı taşıyor: Yalnızca biçim ve tüm ICAO 9303 kontrol basamakları geçerliyse SUCCESS, aksi halde ilk sorunu adlandıran bir status_message ile FAILURE. Yazılacak istisna işleme yok — görüntüde hiç MRZ yoksa yanıt bunu açıkça söylüyor.

Bu sürüm ayrıca get_details_batch ile toplu işleme getiriyor. Yazıya göre sonuçlar girdi sırasıyla dönüyor, işler paralel yürütülüyor ve worker sayısı varsayılan olarak CPU sayısına eşit (en fazla 8); 4 çekirdekli bir CPU'da verim düz bir döngünün yaklaşık 1,5 katı. Okunamayan bir dosya toplu işlemi durdurmuyor; yalnızca ilgili girdi hata olarak işaretlenmiş biçimde geri geliyor.

Desteklenen belge biçimleri yaygın seyahat belgesi düzenlerini kapsıyor: kimlik kartları için TD1, eski kimlik kartları ve bazı vizeler için TD2, pasaportlar için TD3 ile MRV-A ve MRV-B vize biçimleri.

FastMRZ 1.x veya 2.x sürümlerinden geçen ekipler için eski tesseract_path ve tessdata_path argümanları bir FutureWarning ile yok sayılıyor; böylece temizlik istenen hızda yapılabilir. Tesseract'a bağımlı bir başka MRZ kütüphanesi olan PassportEye'dan geçiş yolu da belgelenmiş durumda. Proje Apache-2.0 lisanslı, GitHub'da barındırılıyor ve PyPI'da yayımlanıyor; yazar ayrıca modeli geliştirmeye devam etmek için issue tracker üzerinden hassas bilgileri temizlenmiş hatalı örnekleri açıkça talep ediyor.

Neden önemli

Kimlik belgesi ayrıştırma, neredeyse her KYC onboarding akışının, otel veya havayolu check-in sisteminin ve vize işleme arka ofisinin içindeki sessiz bir altyapıdır ve Tesseract kurulum vergisi uzun zamandır bunun en kırılgan parçası olageldi — özellikle container ve serverless ortamlarında. Tanımayı 37 karakterlik, tek yazı tipili bir alfabeteye daraltarak FastMRZ 3, genellikle güvenilirlik ve dağıtılabilirlik pahasına bir takas yapıyor; OCR'ın kısıtlı bir alanla karşılaştığı her yerde karşılığını veren bir model bu. Tamamen yerel, yalnızca CPU kullanan pipeline, pasaport işleyen herkes için aynı zamanda bir gizlilik argümanı. Dar kapsamlı her tanıma modelindeki açık soru gerçek dünyadaki sağlamlık ve yazarın geliştiricileri tam da bunu test etmeye davet etmesi.

  • #python
  • #ocr
  • #open-source
  • #identity-verification
  • #developer-tools

İlgili yazılar