EasyPR

	CPlateRecognize pr;
	pr.setResultShow(false);
	pr.setDetectType(PR_DETECT_CMSER);

	vector<CPlate> plateVec;
	Mat src = imread(filepath);
	int result = pr.plateRecognize(src, plateVec);

	pr.setResultShow(false);

pr.setDetectType(PR_DETECT_CMSER);

pr.setDetectType(PR_DETECT_COLOR | PR_DETECT_SOBEL);

pr.setLifemode(true);

pr.setMaxPlates(4);

vector<CPlate> plateVec;
Mat src = imread(filepath);
int result = pr.plateRecognize(src, plateVec);

plateMat представляет собой изображение номера автомобиля, rrect — ориентированное прямоугольное положение номера, а license — строковое представление номера, например "синий номер: SU EUK722".

Далее приведено объяснение того, как читается результат распознавания, показанный на следующем рисунке.

![Результаты распознавания EasyPR](resources/doc/res/one_image_detect.jpg)

Первая строка отражает имя файла изображения.

Вторая строка представляет собой GroundTruth номер автомобиля, помеченный суффиксом (g). Третья строка представляет собой распознанный номер автомобиля EasyPR, помеченный суффиксом (d). Эти два значения образуют пару, четвертая строка отражает различие между ними по символам.

Подобное повторяется далее. В данном изображении присутствует три номера автомобиля, поэтому имеются три таких пары. Последние метрики Recall и т.д. представляют общую оценку локализации для всего изображения, учитывающую результаты всех трех пар.

Иногда вместо распознанного номера используется "нет номера" и "No string". "Нет номера" означает "локализация не удалась", а "No string" — "локализация удалась, но разделение символов провалилось".

### Авторское право

Исходный код и тренировочные данные EasyPR распространяются под лицензией Apache v2.0.Изображения в папке `resources/image/general_test` распространяются под [лицензией GDSL](image/GDSL.txt) (общей лицензией на использование данных).

Пожалуйста, убедитесь, что вы ознакомились со всеми условиями вышеупомянутых лицензий перед использованием.

### Структура каталогов

Следующая таблица содержит описание всех каталогов данного проекта:

| Каталог | Описание |
| ------ | ----------|
| src | Все исходные файлы |
| include | Все заголовочные файлы |
| test | Программы тестирования |
| model | Модели машинного обучения |
| resources/text | Таблицы соответствия символов |
| resources/train | Тренировочные данные и их описание |
| resources/image | Изображения для тестирования |
| resources/doc | Соответствующие документы |
| tmp | Каталог для чтения тренировочных данных, требуется создать |

Следующая таблица содержит описание подкаталогов в каталоге `resources/image`:

| Каталог | Описание |
| ------ | ----------|
| general_test | GDTS (общий набор данных для тестирования) |
| native_test | NDTS (локальный набор данных для тестирования) |
| tmp | Каталог для вывода промежуточных изображений при режиме отладки, требуется создать |

Следующая таблица содержит описание подкаталогов в каталоге `src`:

| Каталог | Описание |
| ------ | ----------|
| core | Основные функции |
| preprocess | Предварительная подготовка для SVM |
| train | Каталог для тренировки моделей |
| util | Вспомогательные функции |

Ниже приведены таблицы с объяснением и связями некоторых ключевых файлов в директории src:|Файл| Описание|
|----|---------|
|plate_locate| Локация номерного знака автомобиля|
|plate_judge| Определение номерного знака автомобиля|
|plate_detect| Обнаружение номерного знака автомобиля, представляет собой сочетание функций локации и определения номерного знака|
|chars_segment| Разделение символов|
|chars_identify| Установка символов|
|chars_recognise| Распознавание символов, представляет собой сочетание функций разделения и установки символов|
|plate_recognize| Распознавание номерного знака автомобиля, является общим подклассом для обнаружения номерного знака и распознавания символов|
|feature| Возврат функции извлечения признаков|
|plate| Абстракция номерного знака автомобиля|
|core_func.h| Набор общих функций|

Ниже приведена таблица с объяснением файлов в директории test:

|Файл| Описание|
|----|---------|
|main.cpp| Главное окно командной строки|
|accuracy.hpp| Батч тестирования|
|chars.hpp| Файлы, связанные с распознаванием символов|
|plate.hpp| Файлы, связанные с распознаванием номерных знаков автомобилей|

Ниже приведена таблица с объяснением файлов в директории train:

|Файл| Описание|
|----|---------|
|ann_train.cpp| Обучение бинарных символов|
|annCh_train.hpp| Обучение серых символов китайского языка|
|svm_train.hpp| Обучение распознаванию номерных знаков автомобилей|
|create_data.hpp| Создание синтетических данных|

### ИспользованиеПожалуйста, обратитесь [сюда](Usage.md).

### Получение помощи

Подробное руководство по разработке и обучению доступно [здесь](http://www.cnblogs.com/subconscious/p/3979988.html).

Если вы столкнулись с какими-либо проблемами во время использования, сообщите нам [здесь](https://github.com/liuruoze/EasyPR/issues).

QQ группы EasyPR: первая группа — 366392603, вторая группа — 583022188, третья группа — 637614031, четвертая группа — 548362608. При добавлении укажите "EasyPR учебная группа".

### Контрибьюторы

* liuruoze: автор версий 1.0–1.2, 1.5
* 海豚嘎嘎(车主之家): алгоритмист версии 1.3, повысил точность локации номерного знака и распознавания символов
* Micooz: архитектор версий 1.3–1.4, поддержка Linux и Mac, OpenCV 3.0, UTF-8 кодировки
* jsxyhelu: версия deface 1
* zhoushiwei: версия deface 2
* ahccom: новый метод plateLocate
* 阿水: интегратор версии 1.3, работа по маркировке данных
* fan-wenjie: предоставитель версии 1.5 с интеграцией OpenCV
* Free: предоставитель данных версии 1.6

### Благодарности

taotao1233, Qiu Jinshan, Tang Daxia, jsxyhelu, если бы один день (zhoushiwei), учиться и трудиться, Yuan Chengzhi, Shengcheng Xiao Shijiang, GoldRiver, Micooz, мечты времени, Rain Wang, Ren Xue Ji, AhcCom, звездопад ночью, 海豚嘎嘎(车主之家), Liu Chao, Great God Free, а также все доброжелательные студенты, которые помогли данными для EasyPR.