Recognizer

Классы
class	face_sdk.modules.recognizer.MatchResult
	Интерфейсный объект для создания и сравнения шаблонов. Подробнее...
class	face_sdk.modules.recognizer.SearchResult
	Результат поиска запросного шаблона (Template) в индексе (TemplatesIndex). Подробнее...
class	face_sdk.modules.recognizer.SearchAccelerationType
	Типы ускорения поиска. Подробнее...
class	face_sdk.modules.recognizer.Recognizer
	Интерфейсный объект для создания и сравнения шаблонов. Подробнее...

Функции
def	face_sdk.modules.recognizer.Recognizer.processing
	Создать шаблон. Подробнее...
def	face_sdk.modules.recognizer.Recognizer.verify_match
	Сравнить два шаблона. Подробнее...
def	face_sdk.modules.recognizer.Recognizer.create_index
	Создать индекс (TemplatesIndex) для выполнения быстрого поиска. Подробнее...
def	face_sdk.modules.recognizer.Recognizer.get_method_name
	Получить имя метода. Подробнее...
def	face_sdk.modules.recognizer.Recognizer.search
	Поиск k ближайших шаблонов в индексе. Подробнее...
def	face_sdk.modules.recognizer.Recognizer.load_template
	Загрузить шаблон. Подробнее...
def	face_sdk.modules.recognizer.Recognizer.choose_representative_templates_set
	Выбрать набор шаблонов, представляющий оригинальные шаблоны наилучшим образом. Подробнее...
def	face_sdk.modules.recognizer.Recognizer.get_roc_curve_point_by_distance_threshold
	Получить точку на ROC-кривой с заданным порогом расстояния. Подробнее...
def	face_sdk.modules.recognizer.Recognizer.get_roc_curve_point_by_far
	Получить точку на ROC-кривой с заданным false acceptance rate (FAR). Подробнее...
def	face_sdk.modules.recognizer.Recognizer.get_roc_curve_point_by_frr
	Получить точку на ROC-кривой с заданным false rejection rate (FRR). Подробнее...
def	face_sdk.modules.recognizer.Recognizer.get_roc_curve_point_by_score_threshold
	Получить точку на ROC-кривой с заданным порогом значения сходства. Подробнее...

Подробное описание

Функции

def face_sdk.modules.recognizer.Recognizer.choose_representative_templates_set	(		self,
			set_size
	)

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

Аргументы

[in]	set_size	Требуемый размер набора.
[in]	templates	Оригинальные шаблоны.
[in]	inviolable_templates_indexes	Индексы шаблонов, которых необходимо включить в набор.

Возвращает

Индексы шаблонов, составляющих результирующий набор.

def face_sdk.modules.recognizer.Recognizer.create_index	(		self,
			templates
	)

Создать индекс (TemplatesIndex) для выполнения быстрого поиска.

Суммарный размер всех индексов ограничен лицензией.

Аргументы

[in]	templates	Вектор шаблонов для построения индекса.
[in]	search_threads_count	Количество потоков для использования во время поиска в этом индексе.
[in]	reserve_queries_count	Целое число, передаваемое в метод TemplatesIndex.reserve_search_memory, вызванный от созданного индекса.

Возвращает

Созданный индекс.

def face_sdk.modules.recognizer.Recognizer.get_method_name	(		self,
			str
	)

Получить имя метода.

Потокобезопасный.

Возвращает

Имя метода.

def face_sdk.modules.recognizer.Recognizer.get_roc_curve_point_by_distance_threshold	(		self,
			distance_threshold
	)

Получить точку на ROC-кривой с заданным порогом расстояния.

Потокобезопасный.

Возвращает

Точка на ROC-кривой в виде структуры MatchResult.

def face_sdk.modules.recognizer.Recognizer.get_roc_curve_point_by_far	(		self,
			desired_far
	)

Получить точку на ROC-кривой с заданным false acceptance rate (FAR).

Потокобезопасный.

Возвращает

Точка на ROC-кривой в виде структуры MatchResult.

def face_sdk.modules.recognizer.Recognizer.get_roc_curve_point_by_frr	(		self,
			desired_frr
	)

Получить точку на ROC-кривой с заданным false rejection rate (FRR).

Потокобезопасный.

Возвращает

Точка на ROC-кривой в виде структуры MatchResult.

def face_sdk.modules.recognizer.Recognizer.get_roc_curve_point_by_score_threshold	(		self,
			score_threshold
	)

Получить точку на ROC-кривой с заданным порогом значения сходства.

Потокобезопасный.

Возвращает

Точка на ROC-кривой в виде структуры MatchResult.

def face_sdk.modules.recognizer.Recognizer.load_template	(		self,
			binary_stream
	)

Загрузить шаблон.

Формат платформонезависимый. Загружать можно только шаблоны, созданные этим же методом (т.е. с таким же конфигурационным файлом).

Аргументы

[in]

binary_stream

Объект потока. Поток файла (std::ifstream) необходимо открывать с флагом std::ios_base::binary.

Возвращает

Загруженный шаблон.

def face_sdk.modules.recognizer.Recognizer.processing	(		self,
			sample
	)

Создать шаблон.

Аргументы

[in]

sample

Образец лица. На данный момент все методы могут работать только с фронтальными образцами.

Возвращает

Созданный шаблон.

def face_sdk.modules.recognizer.Recognizer.search	(		self,
			queries_templates
	)

Поиск k ближайших шаблонов в индексе.

Время поиска зависит от значения k и от размеров индекса.

Аргументы

[in]	query_template	Запросный шаблон.
[in]	templates_index	Индекс для поиска.
[in]	k	Количество ближайших шаблонов для поиска.
[in]	acceleration	Тип ускорения поиска.

Возвращает

Вектор с min(k, templates_index.size()) элементами в порядке возрастания расстояния до запросного шаблона.

def face_sdk.modules.recognizer.Recognizer.verify_match	(		self,
			template1
	)

Сравнить два шаблона.

Порядок шаблонов не важен. Сравнивать можно только шаблоны, созданные этим же методом (т.е. с таким же конфигурационным файлом).

Аргументы

[in]	template1	Шаблон, созданный таким же методом.
[in]	template2	Шаблон, созданный таким же методом.

Возвращает

Результат сравнения.