Класс VDT.FaceRecognition.SDK.Recognizer

Интерфейсный объект для создания и сравнения шаблонов. Подробнее...

Классы
class	MatchResult
	Результат сравнения шаблонов. Подробнее...
class	SearchResult
	Результат поиска запросного шаблона (Template) в индексе (TemplatesIndex). Подробнее...

Открытые типы
enum	SearchAccelerationType { SearchAccelerationType.NO_SEARCH_ACCELERATION = 0, SearchAccelerationType.SEARCH_ACCELERATION_1 = 1 }
	Типы ускорения поиска. Подробнее...

Открытые члены
String	getMethodName ()
	Получить имя метода. Потокобезопасный. Подробнее...
MatchResult	getROCCurvePointByDistanceThreshold (double distance_threshold)
	Получить точку на ROC-кривой с заданным порогом расстояния. Потокобезопасный. Подробнее...
MatchResult	getROCCurvePointByFAR (double desired_far)
	Получить точку на ROC-кривой с заданным false acceptance rate (FAR). Потокобезопасный. Подробнее...
MatchResult	getROCCurvePointByFRR (double desired_frr)
	Получить точку на ROC-кривой с заданным false rejection rate (FRR). Потокобезопасный. Подробнее...
MatchResult	getROCCurvePointByScoreThreshold (double score_threshold)
	Получить точку на ROC-кривой с заданным порогом значения сходства. Потокобезопасный. Подробнее...
Template	processing (RawSample sample)
	Создать шаблон. Подробнее...
Template	loadTemplate (Stream binary_stream)
	Загрузить шаблон. Формат платформонезависимый. Загружать можно только шаблоны, созданные этим же методом (т.е. с таким же конфигурационным файлом). Подробнее...
MatchResult	verifyMatch (Template template1, Template template2)
	Сравнить два шаблона. Порядок шаблонов не важен. Сравнивать можно только шаблоны, созданные этим же методом (т.е. с таким же конфигурационным файлом). Подробнее...
TemplatesIndex	createIndex (List< Template > templates, int search_threads_count, int reserve_queries_count=0)
	Создать индекс (TemplatesIndex) для выполнения быстрого поиска. Суммарный размер всех индексов ограничен лицензией. Подробнее...
List< SearchResult >	search (Template query_template, TemplatesIndex templates_index, int k, SearchAccelerationType acceleration)
	Поиск k ближайших шаблонов в индексе. Время поиска зависит от значения k и от размеров индекса. Подробнее...
List< List< SearchResult > >	search (List< Template > queries_templates, TemplatesIndex templates_index, long k, SearchAccelerationType acceleration)
	Поиск k ближайших шаблонов в индексе. Время поиска зависит от значения k и от размеров индекса. Подробнее...
List< int >	chooseRepresentativeTemplatesSet (int set_size, List< Template > templates, List< int > inviolable_templates_indexes=null)
	Выбрать набор шаблонов, представляющий оригинальные шаблоны наилучшим образом. Подробнее...
Открытые члены унаследованные от VDT.FaceRecognition.SDK.IDisposableObject
virtual void	Dispose ()
	Освободить внутренний объект.

Дополнительные унаследованные члены
Свойства унаследованные от VDT.FaceRecognition.SDK.IDisposableObject
bool	isDisposed [get]
	True если внутренний объект освобожден.

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

Интерфейсный объект для создания и сравнения шаблонов.

Перечисления

enum VDT.FaceRecognition.SDK.Recognizer.SearchAccelerationType

Типы ускорения поиска.

Элементы перечислений
NO_SEARCH_ACCELERATION	Без ускорения, стандартный линейный поиск. Результат идентичен N вызовам Recognizer.verifyMatch.
SEARCH_ACCELERATION_1	Эвристически ускоренный линейный поиск. Эвристика уменьшает TAR (true acceptance rate) на тесте 1:N не более чем на 0.1%.

Методы

List<int> VDT.FaceRecognition.SDK.Recognizer.chooseRepresentativeTemplatesSet ( int  set_size, List< Template >  templates, List< int >  inviolable_templates_indexes = null  )

inline

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

Аргументы

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

Возвращает

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

TemplatesIndex VDT.FaceRecognition.SDK.Recognizer.createIndex ( List< Template >  templates, int  search_threads_count, int  reserve_queries_count = 0  )

inline

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

Аргументы

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

Возвращает

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

String VDT.FaceRecognition.SDK.Recognizer.getMethodName ( )

inline

Получить имя метода. Потокобезопасный.

Возвращает

Имя метода.

MatchResult VDT.FaceRecognition.SDK.Recognizer.getROCCurvePointByDistanceThreshold ( double  distance_threshold )

inline

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

Возвращает

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

MatchResult VDT.FaceRecognition.SDK.Recognizer.getROCCurvePointByFAR ( double  desired_far )

inline

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

Возвращает

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

MatchResult VDT.FaceRecognition.SDK.Recognizer.getROCCurvePointByFRR ( double  desired_frr )

inline

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

Возвращает

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

MatchResult VDT.FaceRecognition.SDK.Recognizer.getROCCurvePointByScoreThreshold ( double  score_threshold )

inline

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

Возвращает

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

Template VDT.FaceRecognition.SDK.Recognizer.loadTemplate ( Stream  binary_stream )

inline

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

Аргументы

[in]

binary_stream

Объект потока ввода.

Возвращает

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

Template VDT.FaceRecognition.SDK.Recognizer.processing ( RawSample  sample )

inline

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

Аргументы

[in]

sample

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

Возвращает

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

List<SearchResult> VDT.FaceRecognition.SDK.Recognizer.search ( Template  query_template, TemplatesIndex  templates_index, int  k, SearchAccelerationType  acceleration  )

inline

Поиск k ближайших шаблонов в индексе. Время поиска зависит от значения k и от размеров индекса.

Аргументы

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

Возвращает

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

List<List<SearchResult> > VDT.FaceRecognition.SDK.Recognizer.search ( List< Template >  queries_templates, TemplatesIndex  templates_index, long  k, SearchAccelerationType  acceleration  )

inline

Поиск k ближайших шаблонов в индексе. Время поиска зависит от значения k и от размеров индекса.

Аргументы

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

Возвращает

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

MatchResult VDT.FaceRecognition.SDK.Recognizer.verifyMatch ( Template  template1, Template  template2  )

inline

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

Аргументы

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

Возвращает

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