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

Functional UUIDs for Python.

python script to generate color coded resistor images

Deep Difference and search of any Python object/data.

A repository containing several general purpose Python scripts to automate daily and common tasks.

Fcpy: A Python package for high performance, fast convergence and high precision numerical fractional calculus computing.

Simple collection of GTPS Flood in Python.

We provide useful util functions. When adding a util function, please add a description of the util function.

Aggregating gridded data (xarray) to polygons

Python based tool to extract forensic info from EventTranscript.db (Windows Diagnostic Data)

NFT-Generator is the best way to generate thousands of NFTs quick and easily with 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.

Small project to interact with python, C, HTML, JavaScript, PHP.

A fast Python implementation of Ac Auto Mechine

Patch the pclntable from Go binaries

New time-based UUID formats which are suited for use as a database key

✨ Un pierre feuille ciseaux totalement fait en Python par moi, et en français.

Abstraction of a Unit, includes convertions and basic operations.

A simple and easy to use Spam Bot made in Python!

An URL checking python module

Python @deprecat decorator to deprecate old python classes, functions or methods.