About Library for extract infomation from thai personal identity card.

Last update: Nov 15, 2022

Overview

ThaiPersonalCardExtract

Library for extract infomation from thai personal identity card. imprement from easyocr and tesseract

New Feature v1.3.2 🎁

Increase performance.
Support Thai Government Lottery สกัดข้อมูลจากลอตเตอร์รี่ ใช้ได้ดีกับรูปภาพที่ได้จากเครื่องแสกน (16 Aug. 2021)
Refactor Output Structure.
Support Thai Driving License (Beta) สามารถสกัดข้อมูลจากภาพถ่ายใบขับขี่ได้บางรูปแบบ เนื่องจาก กรมทางขนส่งทางบก มีรูปแบบบัตรหลากหลายรูปแบบ และแต่ละรูปแบบมีตำแหน่งข้อมูลที่แตกต่างกัน จึงทำให้ประสิทธิภาพต่ำ

Examples

Example image file.

wrapPerpective image crop.

keypoint of image detected.

Resutls of library extract region of interest

Identification Number	FullNameTH
NameEN	LastNameEN
BirthdayTH	BirthdayEN
Religion	Address
DateOfIssueTH	DateOfIssueEN
DateOfExpiryTH	DateOfExpiryEN

Identification Number

FullNameTH

NameEN

LastNameEN

BirthdayTH

BirthdayEN

Religion

Address

DateOfIssueTH

DateOfIssueEN

DateOfExpiryTH

DateOfExpiryEN

Recommend ⚠

Image quality lowest should be 600x350
Images with minimal reflections should be used. for good results
Identity Card should be size in the image about 75%, if the image doesn't cropped that to be left only Identity Card area.
For faster, please resize image and usage CUDA GPU.

Installation

Install using pip for stable release,

pip install thai-personal-card-extract

For latest development release,

pip install git+git://github.com/ggafiled/ThaiPersonalCardExtrac.git

Note 1: for Windows, please install tesseract first by following the official instruction here https://medium.com/@navapat.tpb/734dae2fb4d3 On medium website, be sure to setup already.

Note 2: for Linux os, please install tesseract by following the official instruction https://github.com/tesseract-ocr/tesseract

Usage

# With build-in Config Options. 

import ThaiPersonalCardExtract as card
reader = card.PersonalCard(
    lang=card.THAI,
    provider=card.DEFAULT,
    tesseract_cmd="D:/Program Files/Tesseract-OCR/tesseract",
    save_extract_result=True,
    path_to_save="D:/dev/ThaiPersonalCardExtract/examples/extract")
result = reader.extractInfo('examples/card.jpg')
print(result)


# With free-style ตัวอย่างการเรียกใช้งานคลาส PersonalCard เพื่อสกัดข้อมูลบัตรประจำตัวประชาชน 

from ThaiPersonalCardExtract import PersonalCard
reader = PersonalCard(lang="mix", tesseract_cmd="D:/Program Files/Tesseract-OCR/tesseract") # for windows need to pass tesseract_cmd parameter to setup your tesseract command path.
result = reader.extractInfo('examples/card.jpg')
print(result)


# With free-style ตัวอย่างการเรียกใช้งานคลาส DrivingLicense เพื่อสกัดข้อมูลใบอนุญาตขับขี่

from ThaiPersonalCardExtract import DrivingLicense
reader = DrivingLicense(lang="mix", tesseract_cmd="D:/Program Files/Tesseract-OCR/tesseract") # for windows need to pass tesseract_cmd parameter to setup your tesseract command path.
result = reader.extractInfo('examples/card.jpg')
print(result)


# With free-style ตัวอย่างการเรียกใช้งานคลาส ThaiGovernmentLottery เพื่อสกัดข้อมูลลอตเตอร์รี่

from ThaiPersonalCardExtract import ThaiGovernmentLottery
reader = ThaiGovernmentLottery(save_extract_result=True, path_to_save="D:/dev/ThaiPersonalCardExtract/examples/extract/thai_government_lottery") # for windows need to pass tesseract_cmd parameter to setup your tesseract command path.
result = reader.extractInfo("../examples/card7.jpg")
print(result)

Output will be in list format, each item represents result of library can extract, respectively. type of namedtuple ผลลัพธ์ที่ได้จะเป็นประเภท namedtuple สามารถศึกษาเพิ่มเติมเพื่อใช้งานได้จากที่นี่ คลิก

#Output of PersonalCard
    Card(Identification_Number='9999999999999', FullNameTH='นาย อายุมฺมุราเสะ', PrefixTH='นาย', NameTH='อายุมฺมุราเสะ', LastNameTH='อายุมฺมุราเสะ', PrefixEN='.Mr.Shoyo', NameEN='', LastNameEN='Hinatao', BirthdayTH='21 มี.ย. 2539', BirthdayEN='21 Jun..1996', Religion='พุทธ', Address='ท8ปฺ` 99/1 มิซีโฮะ เขตฮานามิกาวา อำเภอชิบ', DateOfIssueTH='11 ส.ค. 2554', DateOfIssueEN='11 Ang. 2021', DateOfExpiryTH='11 ส.ค. 2574', DateOfExpiryEN='11 Aug. 2031,')

#Output of DrivingLicense
    Card(License_Number='98765432', IssueDateTH='ผังทาทม', ExpiryDateTH='', IssueDateEN='14 August 2664', ExpiryDateEN='14 August 2574', NameTH='า? โนบกะ โนบี', NameEN='MRONOREAUMANE', BirthDayTH='', BirthDayEN='wa hs OKRA', Identity_Number='', Province='นคาราชศีมา')

#Output of ThaiGovernmentLottery
    Lottery(LotteryNumber='424603', LessonNumber='08', SetNumber='23', Year='2564') #type namedtuple 
    
 สามารถเข้าถึงตัวแปรได้ตามรูปแบบนี้
 print(result.LotteryNumber)
 print(result.LessonNumber)
 print(result.SetNumber)
 print(result.Year)

For set lang attribute to tha

from ThaiPersonalCardExtract import PersonalCard
reader = PersonalCard(lang="tha", tesseract_cmd="D:/Program Files/Tesseract-OCR/tesseract") # for windows need to pass tesseract_cmd parameter to setup your tesseract command path.
result = reader.extractInfo('examples/card.jpg')
print(result)

Output will be in list format, each item represents result of library can extract, respectively.

{
   "Identification_Number": "9999999999999",
   "FullNameTH": "นาย อายุมฺมุราเสะ",
   "PrefixTH": "นาย",
   "NameTH": "อายุมฺมุราเสะ",
   "LastNameTH": "อายุมฺมุราเสะ",
   "BirthdayTH": "21 มี.ย. 2539",
   "Religion": "พุทธ",
   "Address": "ท๒ 99/1 มิชีโฮะ เขตฮานามิกาวา อำเภอชิบ;",
   "DateOfIssueTH": "11 ส.ค. 2554",
   "DateOfExpiryTH": "11 ส.ค. 2574"
}

And you can set ocr provider following below default #used both easyocr and tesseract **Recommend Or easyocr Or tesseract

from ThaiPersonalCardExtract import PersonalCard
reader = PersonalCard(lang="tha", provider="default", tesseract_cmd="D:/Program Files/Tesseract-OCR/tesseract") # for windows need to pass tesseract_cmd parameter to setup your tesseract command path.
result = reader.extractInfo('examples/card.jpg')
print(result)

Config Options

you can set options to Instance by below keyword

Parameter name	Value Type	Example
lang	String	Expected Results Language `bash mix #get all area both tha and eng` Or `bash tha` Or `bash eng` Default is 'mix' สำหรับ DrivingLicense, PersonalCard*
provider	String	OCR Provider have `bash default #used both easyocr and tesseract *Recommend` Or `bash easyocr` Or `bash tesseract` Default is 'default' สำหรับ DrivingLicense, PersonalCard
template_threshold	Double	Rate to cals similarity of template *Default is 0.7
sift_rate	Int	Feature Keypoint rate *Default is 25,000
tesseract_cmd	String	Path of your tesseract command **For windows only.
save_extract_result	Boolean	Set True if you want to save extracted image *Default is False
path_to_save	String	Path that you given it save extracted image, relative with save_extract_result=True

Donate Me ☕

Mr.Nattapol Krobklang

extract gene TSS/TES site form gencode/ensembl/gencode database GTF file and export bed format file.

GetTsite python Package extract gene TSS/TES site form gencode/ensembl/gencode database GTF file and export bed format file. Install $ pip install Get

7 Nov 21, 2022

A functional standard library for Python.

Toolz A set of utility functions for iterators, functions, and dictionaries. See the PyToolz documentation at https://toolz.readthedocs.io LICENSE New

4.1k Dec 30, 2022

🔩 Like builtins, but boltons. 250+ constructs, recipes, and snippets which extend (and rely on nothing but) the Python standard library. Nothing like Michael Bolton.

Boltons boltons should be builtins. Boltons is a set of over 230 BSD-licensed, pure-Python utilities in the same spirit as — and yet conspicuously mis

6k Jan 4, 2023

Retrying library for Python

Tenacity Tenacity is an Apache 2.0 licensed general-purpose retrying library, written in Python, to simplify the task of adding retry behavior to just

4.3k Jan 5, 2023

Retrying is an Apache 2.0 licensed general-purpose retrying library, written in Python, to simplify the task of adding retry behavior to just about anything.

Retrying Retrying is an Apache 2.0 licensed general-purpose retrying library, written in Python, to simplify the task of adding retry behavior to just

1.9k Dec 29, 2022

isort is a Python utility / library to sort imports alphabetically, and automatically separated into sections and by type.

isort is a Python utility / library to sort imports alphabetically, and automatically separated into sections and by type. It provides a command line utility, Python library and plugins for various editors to quickly sort all your imports.

5.5k Jan 8, 2023

A Python library for reading, writing and visualizing the OMEGA Format

A Python library for reading, writing and visualizing the OMEGA Format, targeted towards storing reference and perception data in the automotive context on an object list basis with a focus on an urban use case.

Institut für Kraftfahrzeuge, RWTH Aachen, ika

12 Sep 1, 2022

RapidFuzz is a fast string matching library for Python and C++

RapidFuzz is a fast string matching library for Python and C++, which is using the string similarity calculations from FuzzyWuzzy

1.7k Jan 4, 2023

pydsinternals - A Python native library containing necessary classes, functions and structures to interact with Windows Active Directory.

pydsinternals - Directory Services Internals Library A Python native library containing necessary classes, functions and structures to interact with W

36 Dec 14, 2022

Comments

'PersonalCard' object has no attribute 'extractInfo'

AttributeError Traceback (most recent call last) /var/folders/cc/d15mjmhn5c5fscqfwq3fql5h0000gp/T/ipykernel_6920/1182933257.py in ----> 1 result = reader.extractInfo('ThaiPersonalCardExtract/examples/extract/image_scan.jpg') 2 print(result)

AttributeError: 'PersonalCard' object has no attribute 'extractInfo'

opened by suwika 0

Releases(v1.3.4)

v1.3.4(Sep 2, 2021)
New Feature v1.3.4 🎁

Support Thai identity card laser code extract. (02 Sep. 2021)

Fix bug dataset folder not import thai_government_lottery resource. (23 Aug. 2021) #1

Increase performance.

Support Thai Government Lottery สกัดข้อมูลจากลอตเตอร์รี่ ใช้ได้ดีกับรูปภาพที่ได้จากเครื่องแสกน (16 Aug. 2021)

Refactor Output Structure.

Support Thai Driving License (Beta) สามารถสกัดข้อมูลจากภาพถ่ายใบขับขี่ได้บางรูปแบบ เนื่องจาก กรมทางขนส่งทางบก มีรูปแบบบัตรหลากหลายรูปแบบ และแต่ละรูปแบบมีตำแหน่งข้อมูลที่แตกต่างกัน จึงทำให้ประสิทธิภาพต่ำ

Source code(tar.gz)
Source code(zip)
v1.3.1(Aug 16, 2021)

New Feature v1.3.1 🎁 Increase performance. Support Thai Driving License (Beta) สามารถสกัดข้อมูลจากภาพถ่ายใบขับขี่ได้บางรูปแบบ เนื่องจาก กรมทางขนส่งทางบก มีรูปแบบบัตรหลากหลายรูปแบบ และแต่ละรูปแบบมีตำแหน่งข้อมูลที่แตกต่างกัน จึงทำให้ประสิทธิภาพต่ำ Support Thai Government Lottery (16 Aug. 2021)
Source code(tar.gz)
Source code(zip)
v1.3.0(Aug 14, 2021)

Increase performance. Support Thai Driving License (Beta) สามารถสกัดข้อมูลจากภาพถ่ายใบขับขี่ได้บางรูปแบบ เนื่องจาก กรมทางขนส่งทางบก มีรูปแบบบัตรหลากหลายรูปแบบ และแต่ละรูปแบบมีตำแหน่งข้อมูลที่แตกต่างกัน จึงทำให้ประสิทธิภาพต่ำ ปรับเปลี่ยนรูปแบบไฟล์ระบบ
Source code(tar.gz)
Source code(zip)
v1.2.1(Aug 13, 2021)
New Feature 🎁

More arae extract.

lang : attribute : get only area of given language.

provider : attribute : set ocr provider now support easyocr and tesseract.

Source code(tar.gz)
Source code(zip)
v1.0-beta(Aug 11, 2021)

Support Thai, English Detect. Imprement from easyocr and tesseract Accuracy wrap and transform image 75%
Source code(tar.gz)
Source code(zip)

About Library for extract infomation from thai personal identity card.

Related tags

Overview

ThaiPersonalCardExtract

New Feature v1.3.2 🎁

Examples

Example image file.

wrapPerpective image crop.

keypoint of image detected.

Recommend ⚠

Installation

Usage

Config Options

Donate Me ☕

Mr.Nattapol Krobklang

You might also like...

extract gene TSS/TES site form gencode/ensembl/gencode database GTF file and export bed format file.

A functional standard library for Python.

🔩 Like builtins, but boltons. 250+ constructs, recipes, and snippets which extend (and rely on nothing but) the Python standard library. Nothing like Michael Bolton.

Retrying library for Python

Retrying is an Apache 2.0 licensed general-purpose retrying library, written in Python, to simplify the task of adding retry behavior to just about anything.

isort is a Python utility / library to sort imports alphabetically, and automatically separated into sections and by type.

A Python library for reading, writing and visualizing the OMEGA Format

RapidFuzz is a fast string matching library for Python and C++

pydsinternals - A Python native library containing necessary classes, functions and structures to interact with Windows Active Directory.

Comments

'PersonalCard' object has no attribute 'extractInfo'

Releases(v1.3.4)

v1.3.4(Sep 2, 2021)

v1.3.1(Aug 16, 2021)

v1.3.0(Aug 14, 2021)

v1.2.1(Aug 13, 2021)

New Feature 🎁

v1.0-beta(Aug 11, 2021)

Owner

ggafiled

Python based utilities for interacting with digital multimeters that are built on the FS9721-LP3 chipset.

ULID implementation for Python

✨ Une calculatrice totalement faite en Python par moi, et en français.

Link-tree - Script that iterate over the links found in each page

SH-PUBLIC is a python based cloning script. You can clone unlimited UID facebook accounts by using this tool.

A Python package for floating-point binary fractions. Do math in base 2!

Airspy-Utils is a small software collection to help with firmware related operations on Airspy HF+ devices.

More routines for operating on iterables, beyond itertools

This repository contains some utilities for playing with PKINIT and certificates.

WindowsDebloat - Windows Debloat with python

Deep Difference and search of any Python object/data.

Report Bobcat Status to Google Sheets

Casefy (/keɪsfaɪ/) is a lightweight Python package to convert the casing of strings

Simple Python tool that generates a pseudo-random password with numbers, letters, and special characters in accordance with password policy best practices.

A collection of resources/tools and analyses for the angr binary analysis framework.

Lark is a parsing toolkit for Python, built with a focus on ergonomics, performance and modularity.

iOS Snapchat parser for chats and cached files

The git for the Python Story Utility Package library.

A fixture that allows runtime xfail

This code renames subtitle file names to your video files names, so you don't need to rename them manually.