yushu-liu / chineseidcardocr Goto Github PK

#ChineseIDCardOCR

ChineseIDCardOCR是一个用swift写的framework，用来识别**二代身份证信息。修改自 Swift-OCR。

#如何运行Demo

项目将GPUImage作为submodule添加到项目中, 所以不能直接下载zip包需要按照下面的步骤clone代码

1. git clone https://github.com/KevinGong2013/ChineseIDCardOCR.git
2. cd ChineseIDCardOCR
3. git submodule update --init
4. cd Example
5. open Example.xcodeproj

注意scheme选择 Example. 另外模拟器只能测试读取识别本地图片，扫描识别需要用真机测试。

##功能

• 简洁易用的扫描界面
• 简洁的Train接口
• 身份证号码识别
• 身份证姓名、性别、地址识别
• 图片预处理逻辑优化
• 添加更多的识别模式 例如: 银行卡，护照，医保卡等等
• Unit Test Converage

Requirements

• iOS 9.0+
• Xcode 7.3+

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

CocoaPods 0.39.0+ is required to build ChineseIDCardOCR 3.0.0+.

To integrate ChineseIDCardOCR into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'ChineseIDCardOCR'
end

Then, run the following command:

$ pod install

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate ChineseIDCardOCR into your Xcode project using Carthage, specify it in your Cartfile:

github "KevinGong2013/ChineseIDCardOCR"

使用示例

扫描身份证

import ChineseIDCardOCR

let vc = ScannerViewController()
vc.didRecognizedHandler = { idcard in
	debugPrint(idcard) 
}
presentViewController(vc, animated: true, completion: nil)	

识别图片

import ChineseIDCardOCR

let ocrInstance = IDCardOCR()

let idCardImage = UIImage ... ...

ocrInstance.recognize { recoginzedResult in 
	debugPrint(recoginzedResult)
}
	

工作原理

ChineseIDCardOCR 会对传入的UIImage进行人脸检测，根据监测到的frame和身份证比例，计算出身份证号码所在的 Rect，然后截取图片。获取身份证号码图片以后, 利用GPUImage对图片进行一系列预处理，根据 Connected-component labeling理论，把身份证号码图片剪切成18个单独的小图片。然后利用前馈神经网络(FFNN)对每个图片进行识别。

FFNN 训练

在framework提供了OCR-Training.swift可以根据自己的特点提供单独的训练数据

Dependencies

• Swift-AI
• GPUImage
• Union-Find
• Swift-OCR

License

The code in this repository is licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

NOTE: This software depends on other packages that may be licensed under different open source licenses.