Оцениваемые данные#

В данном разделе перечислены основные параметры лиц, тел и изображений, оцениваемые LUNA PLATFORM 5, и способы их получения.

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

Извлечение пола и возраста из изображения лица. Пол и возраст принадлежат понятию базовые атрибуты.

Для извлечения базовых атрибутов по изображению лица используются ресурсы "/extractor", "/sdk" и политики "extract_policy" ресурсов "/handlers" и "/verifiers".

Для извлечения этих параметров с помощью ресурса "/extractor" необходимо предварительно создать биометрический образец изображения с помощью ресурса "/detector". В ответ на запрос к ресурсу "/extractor" будут выданы пол и возраст человека. Извлеченные данные имеют TTL (время существования) и удалятся из базы данных по истечении указанного периода.

См. подробное описание извлечения базовых атрибутов в разделе "Извлечение биометрических шаблонов и создание атрибутов".

При оценивании параметров с помощью ресурса "/sdk" нужно отправить исходное изображение в LUNA PLATFORM 5 и указать в параметрах запроса параметр "estimate_basic_attributes". В ответ на запрос будут получены пол и возраст человека. Данные параметры не будут сохранены в базу данных.

Для извлечения базовых атрибутов лица с помощью запросов "/handlers" и "/verifiers" необходимо использовать параметр "extract_basic_attributes" политики "extract_policy".

Оценка пола и возраста человека также доступна по изображению тела. Такой способ проверки не является точным и выполняется с помощью оценки параметров тела (см. ниже "Выполнение оценки параметров тела").
Выполнение оценки параметров лица и изображения.

Для оценивания параметров используются различные ресурсы. В основном используются ресурсы "/detector", "/sdk", "/handlers" и "/verifiers".

При оценивании параметров с помощью ресурса "/detector" нужно отправить исходное изображение в LUNA PLATFORM 5 и указать в параметрах запроса оценивание необходимых параметров лица или изображения. В ответ на запрос будет создан биометрический образец лица и выданы указанные параметры. Оцененные параметры не будут сохранены в базу данных.

Способ получения параметров с помощью ресурса "/sdk" аналогичен вышеописанному способу, однако биометрический образец не будет создан. Оцененные параметры также не сохранятся в базу данных.

Для оценивания параметров с помощью ресурсов "/handlers" и "/verifiers" необходимо использовать политику "detect_policy" с указанием необходимых параметров.
Выполнение оценки параметров тела.

Возможность выполнения оценки параметров тела регулируется особым параметром в лицензионном ключе LUNA PLATFORM 5.

Для оценивания параметров тела используются ресурсы "/sdk" и "/handlers". Использование данных ресурсов аналогично выполнению оценки параметров лица и изображения (см. выше).
Выполнение проверки параметров лица и изображения на соответствие стандарту ISO/IEC 19794-5:2011 или по нестандартным условиям.

Возможность выполнения таких проверок регулируется особым параметром в лицензионном ключе LUNA PLATFORM 5.

Для выполнения проверки используются ресурсы "/iso", "/detector" (параметр "estimate_face_quality") и группа проверок "face_quality", политики "detect_policy", запросов "/handlers" и "/verifiers".

В ответах на запросы отображается общий результат прохождения всех проверок ("0" или "1"), а также результаты каждой проверки.

См. подробное описание данной функциональности в разделе "Проверка изображений".
Выполнение оценки Liveness.

Возможность выполнения такой оценки регулируется особым параметром в лицензионном ключе LUNA PLATFORM 5.
Выполнение оценки количества людей на изображении

Все возвращаемые значения и формат ответа зависят от ресурса, где выполняется оценка.

Пол и возраст по изображению лица#

Данная оценка позволяет определить базовые атрибуты (пол и возраст человека) на изображении лица.

Ресурсы, в которых выполняется оценка:

"/extractor"

Название оценки — "extract_basic_attributes".
"/handlers"

Название оценки — "policies" > "extract_policy" > "extract_basic_attributes".
"/verifiers"

Название оценки — "policies" > "extract_policy" > "extract_basic_attributes".
"/sdk"

Название оценки — "estimate_basic_attributes".

Параметры лиц#

Атрибуты глаз#

Данная оценка определяет следующие положения для каждого глаза:

"open" (открытый);
"closed" (закрытый);
"occluded" (чем-то перекрыт).

Изображения низкого качества или изображения, на которых перекрыты глаза (например, очки, волосы, перекрытие руками), попадают в категорию "occluded".

Также определяются контрольные точки радужной оболочки. Для каждого глаза выдается массив из 34 контрольных точек.

В ресурсах "/iso", "/detector" (средство проверки изображения) и "detect_policy" > "face_quality" также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Ресурсы, в которых выполняется оценка:

"/detector"

Название оценки — "estimate_eyes_attributes".
"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_eyes_attributes".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_eyes_attributes".
"/sdk"

Название оценки — "estimate_eyes_attributes".

Определение атрибутов глаз с помощью средств для проверки изображения:

"/iso" и "/detector" (см. разделы "7.2.3 Expression", пункт "a", "7.2.11 Visibility of pupils and irises" и "7.2.13 Eye patches" в стандарте ISO/IEC 19794-5:2011)

Названия проверок — "left_eye", "right_eye".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "left_eye", "right_eye".

Допустимые значения прохождения проверок:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"left_eye" > "threshold"	["open"]
"right_eye" > "threshold"	["open"]

Контрольные точки лица#

Существует две оценки контрольных точек лица:

оценка по 5 контрольным точкам лица
оценка по 68 контрольным точкам лица

Оценка по 5 контрольным точкам лица (слева), оценка по 68 контрольным точкам лица (справа)

Контрольные точки используются в различных целях, например, при создании биометрического образца, при извлечении биометрического шаблона и др. См. более подробное описание контрольных точек лица в документации SDK.

"/detector"

Название оценки — "detect_landmarks68".
"/handlers"

Название оценки — "policies" > "detect_policy" > "detect_landmarks68".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "detect_landmarks68".
"/sdk"

Название оценки — "estimate_landmarks5".

Название оценки — "estimate_landmarks68".

Расстояние между центрами глаз#

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

Доступна возможность оценить расстояние между центрами глаз в пикселях. Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Такую оценку можно выполнить только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "5.6.5 Eye and nostril centre Landmark Points" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "eye_distance".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "eye_distance".

Допустимый диапазон прохождения проверки:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимый диапазон
"eye_distance" > "threshold"	[90...inf]

Эффект «красных глаз»#

Данная оценка определяет наличие эффекта "красных глаз", где:

"0" — на изображении лица нет эффекта "красных глаз";
"1" — на изображении лица присутствует эффект "красных глаз".

Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Требования к изображению:

Для корректных результатов проверки должны быть выполнены нижеописанные требования.

В таблице ниже приведены требования к параметрам качества:

Параметр	Требуемый диапазон
"illumination"	[0.61...1]
"specularity"	[0.57...1]
"blurriness"	[0.5...1]
"dark"	[0.1...1]
"light"	[0.1...1]

В таблице ниже приведено требование к естественности освещения:

Параметр	Требуемый диапазон
"natural_light"	[0.5...1]

Ресурсы, в которых выполняется оценка:

Оценка эффекта "красных глаз" доступна только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.3.4 Unnatural colour" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "red_eyes".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "red_eyes".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"red_eyes" > "threshold"	"1"

Направление взгляда#

Данная оценка определяет направление взгляда. Направление взгляда определяется следующими параметрами:

угол наклона взгляда вверх/вниз (pitch);
угол поворота взгляда вправо/влево (yaw);

Положительное значение угла pitch означает направление взгляда вверх, а отрицательное значение — направление взгляда вниз.

Положительное значение угла yaw означает направление взгляда вправо, а отрицательное значение — направление взгляда влево.

Нулевое положение соответствует направлению взгляда, перпендикулярному плоскости лица, где ось симметрии параллельна вертикальной оси камеры.

Направление взгляда: pitch = 31.5, yaw = 31.17

В ресурсах "/iso" и "detect_policy" > "face_quality" также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Ресурсы, в которых выполняется оценка:

"/detector"

Название оценки — "estimate_gaze".
"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_gaze".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_gaze".
"/sdk"

Название оценки — "estimate_gaze".

Определение направления взгляда с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.2.3 Expression" пункт "e" в стандарте ISO/IEC 19794-5:2011)

Названия проверок — "gaze_yaw", "gaze_pitch".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "gaze_yaw", "gaze_pitch".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"gaze_yaw" > "threshold"	[-5...5]
"gaze_pitch" > "threshold"	[-5...-5]

Очки#

Данная оценка определяет наиболее вероятное состояние очков из следующих состояний:

"sun_glasses" (солнечные очки);
"glasses" (обычные очки);
"no_glasses" (очков нет).

В ресурсах "/iso" и "detect_policy" > "face_quality" также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Ресурсы, в которых выполняется оценка:

"/sdk"

Название оценки — "estimate_glasses".

Определение состояния очков с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.2.9 Eye glasses" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "glasses".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "glasses".

Допустимые значения прохождения проверок:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимые значения
"glasses" > "threshold"	["no_glasses", "eyeglasses"]

Брови#

Данная оценка определяет наиболее вероятное состояние бровей из следующих состояний:

"neutral" — брови находятся в обычном положении;
"raised" — брови подняты;
"squinting" — глаза прищурены, брови опущены;
"frowning" — брови нахмурены.

Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

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

Слева направо — "neutral", "raised", "squinting", "frowning"

Требования к изображению:

Для корректных результатов проверки должны быть выполнены нижеописанные требования.

В таблице ниже приведены требования к положению головы:

Параметр	Требуемый диапазон
"pitch"	[-20...20]
"roll"	[-20...20]
"yaw"	[-20...20]

В таблице ниже приведено требование к ширине лица:

Параметр	Требуемый диапазон
"face_width"	> 80

Ресурсы, в которых выполняется оценка:

Определение состояния бровей доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.2.3 Expression", пункты "d", "f" и "g" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "eyebrows_state".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "eyebrows_state".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"eyebrows_state" > "threshold"	["neutral"]

Атрибуты рта#

Данная оценка определяет вероятностную оценку для каждого нижеперечисленного параметра в диапазоне [0..1]:

"opened" (рот открыт);
"smile" (улыбка);
"occluded" (рот чем-то перекрыт).

Кроме того, определяется степень достоверности обнаружения рта.

В ресурсах "/iso" и "detect_policy" > "face_quality" также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Ресурсы, в которых выполняется оценка:

"/detector"

Название оценки — "estimate_mouth_attributes".
"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_mouth_attributes".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_mouth_attributes".
"/sdk"

Название оценки — "estimate_mouth_attributes".

Определение атрибутов рта с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.2.3 Expression" пункты "a", "b" и "c" в стандарте ISO/IEC 19794-5:2011)

Названия проверок — "mouth_smiling", "mouth_occluded", "mouth_open".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "mouth_smiling", "mouth_occluded", "mouth_open".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"mouth_occluded" > "threshold"	[0...0.5]
"mouth_smiling" > "threshold"	[0...0.5]
"mouth_opened" > "threshold"	[0...0.5]

Состояние улыбки#

Данная оценка определяет наиболее вероятное состояние улыбки из следующих состояний:

"none" — улыбки не найдено, поэтому дополнительные параметры не определяются
"smile_lips" — обычная улыбка со сомкнутыми губами
"smile_teeth" — улыбка с открытыми зубами

Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

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

Требования к изображению:

Для корректных результатов проверки должны быть выполнены нижеописанные требования.

В таблице ниже приведены требования к положению головы:

Параметр	Требуемый диапазон
"pitch"	[-20...20]
"roll"	[-10...10]
"yaw"	[-25...25]

В таблице ниже приведено требование к ширине лица:

Параметр	Требуемый диапазон
"face_width"	> 80

Ресурсы, в которых выполняется оценка:

Определение состояния улыбки доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.2.3 Expression" пункты "a", "b" и "c" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "smile_properties".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "smile_properties".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"smile_properties" > "threshold"	["none"]

Качество изображения#

Данная оценка определяет вероятностную оценку для каждого нижеперечисленного параметра в диапазоне [0..1], где 0 соответствует низкому качеству, а 1 – высокому качеству:

"dark" — степень того, что фото не затемнено;
"light" — степень того, что фото не засвечено;
"blurriness" — степень размытости;
"illumination" — степень равномерности освещения. Чем меньше разница между светлыми и темными зонами лица, тем выше расчетное значение. Если освещение равномерно распределено по всему лицу, значение близится к "1".
"specularity" — степень отсутствия бликов. Чем выше оценочное значение, тем меньше бликов и лучше качество изображения. Если оценочное значение низкое, значит на лице яркие блики.

В ресурсах "/iso" и "detect_policy" > "face_quality" также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Эти данные не сохраняются в базе данных и на основе этих данных не выполняется фильтрация изображений.

Примеры представлены на изображениях ниже. Справа показаны изображения хорошего качества.

Размытое изображение (слева), не размытое изображение (справа)

Слишком темное изображение (слева), изображение хорошего качества (справа)

Слишком светлое (слева), изображение хорошего качества (справа)

Изображение с неравномерным освещением (слева), изображение с равномерным освещением (справа)

Изображение с зеркальным отражением и содержит блики на лице (слева), изображение хорошего качества (справа)

Наиболее важными параметрами качества изображения для распознавания лиц являются темнота, свет и размытие.

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

Ресурсы, в которых выполняется оценка:

"/detector"

Название оценки — "estimate_quality".
"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_quality".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_quality".
"/sdk"

Название оценки — "estimate_quality".

Определение качества изображения с помощью средств для проверки изображения:

"/iso" и "/detector" (см. разделы "7.2.7 Subject and scene lighting", "7.3.2 Contrast and saturation", "7.3.3 Focus and depth of field", "7.2.8 Hot spots and specular reflections", "7.2.12 Lighting artefacts", "7.2.7 Subject and scene lighting" и "7.2.12 Lighting artefacts" в стандарте ISO/IEC 19794-5:2011)

Названия проверок — "illumination_quality", "specularity_quality", "blurriness_quality", "dark_quality", "light_quality".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "illumination_quality", "specularity_quality", "blurriness_quality", "dark_quality", "light_quality".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"illumination_quality" > "threshold"	[0...0.3]
"specularity_quality" > "threshold"	[0...0.3]
"blurriness_quality" > "threshold"	[0.61...1]
"dark_quality" > "threshold"	[0.5...1]
"light_quality" > "threshold"	[0.57...1]

Равномерность освещения по стандарту ICAO#

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

Доступна возможность оценки равномерности освещения по требованиям, указанным в стандарте ICAO.

Также выполняется сравнение оцененного значения с порогом.

Определение равномерности освещения по стандарту ICAO доступно только с помощью средства для проверки изображения — группы проверок "/handlers" > "detect_policy" > "face_quality" ресурсов "/handlers" и "/verifiers".

Название проверки — "illumination_uniformity".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"illumination_uniformity" > "threshold"	[0.5...1]

Фон изображения#

Яркость фона#

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

Данная оценка определяет степень яркости фона, где:

[0...0.1] — черный фон
[0.1...0.3] — темный фон
[0.3...0.97] — светлый фон
[0.97...1] — белый фон

Фон темный, background_lightness = 0.13 (слева), фон светлый background_lightness = 0.94 (справа)

Ресурсы, в которых выполняется оценка:

Определение степени яркости фона доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "B.2.9 Backgrounds" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "background_lightness".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "background_lightness".

Допустимый диапазон прохождения проверки:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимый диапазон
"background_lightness" > "threshold"	[0.2...1]

Однородность фона#

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

Данная оценка позволяет определить степень однородности фона, где:

"0" — фон неоднородный;
"1" — фон однородный.

Фон неоднородный, background_uniformity = 0.004 (слева), фон однородный, background_uniformity = 0.7 (справа)

Ресурсы, в которых выполняется оценка:

Определение однородности фона доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "B.2.9 Backgrounds" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "background_uniformity".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "background_uniformity".

Допустимый диапазон прохождения проверки:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимый диапазон
"background_uniformity" > "threshold"	[0.5...1]

Динамический диапазон по стандарту ICAO#

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

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

Также выполняется сравнение оцененного значения с порогом.

Определение динамического диапазона изображения доступно только с помощью средств для проверки изображения:

"/detector"

Название проверки — "dynamic_range".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "dynamic_range".

Допустимый диапазон прохождения проверки:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимый диапазон
"dynamic_range" > "threshold"	[0.5...1]

Естественность освещения#

Данная оценка определяет естественное ли освещение на лице, где:

"0" — освещение неестественное;
"1" — освещение естественное.

Освещение неестественное (слева), освещение естественное (справа)

Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Требования к изображению:

Для корректных результатов проверки должны быть выполнены нижеописанные требования.

В таблице ниже приведено требование к маске:

Параметр	Требуемое значение
"predominant_mask"	"missing"

В таблице ниже приведено требование к параметру качества изображения:

Параметр	Требуемый диапазон
"blurriness"	[0.5...1]

В таблице ниже приведено требование к очкам:

Параметр	Требуемые значения
"glasses"	"no_glasses" или "eyeglasses"

Ресурсы, в которых выполняется оценка:

Определение естественности освещения доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.3.4 Unnatural colour" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "natural_light".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "natural_light".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"natural_light" > "threshold"	"1"

Тип цвета изображения на основе лица#

Данная оценка определяет наиболее вероятный тип цвета, определяемого по лицу, из следующих:

"color" — изображение цветное;
"grayscale" — изображение черно-белое;
"infrared" — изображение находится в ближнем инфракрасном диапазоне (near infrared).

Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Ресурсы, в которых выполняется оценка:

Определение типа света доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.4.4 Use of near infra-red cameras" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "face_color_type".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "face_color_type".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"face_color_type" > "threshold"	["color"]

Положение головы#

Данная оценка определяет положение головы. Положение головы определяется тремя параметрами:

угол наклона головы вверх/вниз (pitch);
угол отклонения головы вправо/влево (roll);
угол поворота головы вправо/влево (yaw).

Значения углов определяются в диапазоне от "-180" до "180".

Положительное значение угла pitch означает направление наклона головы вверх, а отрицательное значение — направление наклона головы вниз.

Положительное значение угла roll означает направление отклонения головы вправо, а отрицательное значение — направление отклонения головы влево.

Положительное значение угла yaw означает направление поворота головы вправо, а отрицательное значение — направление поворота головы влево.

В ресурсах "/iso" и "detect_policy" > "face_quality" также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Во всех перечисленных ниже ресурсах, за исключением "/iso", доступна возможность отфильтровать изображения по положению головы.

В ресурсах "/detector", "/handlers", "/verifiers" и "/sdk" для порога задается значение от "0" до "180". Значение по умолчанию равно "180", что означает, что голова на изображении может быть повёрнута на любой угол от "-180" до "180". При установке любого другого значения (например, "30") все детекции с углом головы, который меньше или равен "-30" и больше или равен "30" будут отфильтрованы.

Для поля "face_quality" ресурсов "/handlers" и "/verifiers" задается минимальный и максимальный порог в отдельных полях.

Ресурсы, в которых выполняется оценка:

"/detector"

Название оценки — "estimate_head_pose".
"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_head_pose".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_head_pose".
"/sdk"

Название оценки — "estimate_head_pose".

Ниже представлены рекомендуемые пороги для проведения оценки в ресурсах "/detector", "/handlers", "/verifiers" and "/sdk".

Рекомендуемые максимальные пороги:

В таблице ниже приведены рекомендуемые максимальные пороги положения головы для проведения оценки в кооперативном режиме:

Параметр	Рекомендуемые максимальные пороги
"roll_threshold"	30
"pitch_threshold"	15
"yaw_threshold"	15

В таблице ниже приведены рекомендуемые максимальные пороги положения головы для проведения оценки в некооперативном режиме:

Параметр	Рекомендуемые максимальные пороги
"roll_threshold"	30
"pitch_threshold"	30
"yaw_threshold"	30

Определение положения головы с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.2.2 Pose" в стандарте ISO/IEC 19794-5:2011)

Названия проверок — "head_roll", "head_pitch", "head_yaw".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "head_roll", "head_pitch", "head_yaw".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"head_yaw" > "threshold"	[-5...5]
"head_pitch" > "threshold"	[-5...-5]
"head_roll" > "threshold"	[-8...-8]

Положение лица по вертикали и горизонтали#

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

Данные оценки определяют положение центральной точки по вертикали и горизонтали относительно изображения.

Также выполняется сравнение оцененных значений с порогами (в соответствии с ISO или нестандартными порогами).

Ресурсы, в которых выполняется оценка:

Определение положения лица по вертикали и горизонтали доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. разделы "8.3.2 Horizontally centred face" и "8.3.3 Vertical position of the face" в стандарте ISO/IEC 19794-5:2011)

Названия проверок — "head_horizontal_center", "head_vertical_center".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "head_horizontal_center", "head_vertical_center".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"head_horizontal_center" > "threshold"	[0.45...0.55]
"head_vertical_center" > "threshold"	[0.3...0.5]

Ширина и высота головы (вертикальный и горизонтальный размеры)#

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

Данные оценки определяют вертикальный и горизонтальный размер головы относительно размера изображения. Также выполняется сравнение оцененных значений с порогами (в соответствии с ISO или нестандартными порогами).

Ресурсы, в которых выполняется оценка:

Определение размеров головы по горизонтали и вертикали доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. разделы "8.3.4 Width of head" и "8.3.5 Length of head" в стандарте ISO/IEC 19794-5:2011)

Названия проверок — "head_width", "head_height".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "head_width", "head_height".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"head_width" > "threshold"	[0.5...0.75]
"head_height" > "threshold"	[0.6...0.9]

Ширина и высота лица#

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

Данные оценки определяют ширину и высоту лица в пикселях. Также выполняется сравнение оцененных значений с заданными порогами.

Ресурсы, в которых выполняется оценка:

Определение ширины или высоты лица на изображении доступно только с помощью средств для проверки изображения:

"/detector"

Названия проверок — "face_width", "face_height".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "face_width", "face_height".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"face_width" > "threshold"	[180...1920]
"face_height" > "threshold"	[180...inf]

Отступы от краёв изображения#

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

Оценки отступов от краёв изображения определяются как отступы от границы изображения (левой, правой, верхней, нижней) до границы лица (левой, правой, верхней, нижней) в пикселях. Также выполняется сравнение оцененных значений с заданными порогами.

Ресурсы, в которых выполняется оценка:

Определение отступов от краёв изображения доступно только с помощью средств для проверки изображения:

"/detector"

Названия проверок — "indent_upper", "indent_lower", "indent_right", "indent_left".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "indent_upper", "indent_lower", "indent_right", "indent_left".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"indent_upper" > "threshold"	[20...inf]
"indent_lower" > "threshold"	[20...inf]
"indent_right" > "threshold"	[20...inf]
"indent_left" > "threshold"	[20...inf]

Маска#

Данная оценка определяет вероятностную оценку для каждого нижеперечисленного параметра в диапазоне [0..1]:

"medical_mask" (надета медицинская маска);
"missing" (не надета медицинская маска);
"occluded" (лицо закрыто другим предметом, помимо медицинской маски).

Также определяется наиболее вероятное состояние маски.

Помимо трёх основных состояний определяются следующие дополнительные состояния:

"correct" — маска на лице, рот и нос закрыты маской
"mouth" — маска закрывает только рот
"clear" — на лице нет маски
"chin" — маска находится под подбородком и не перекрывает зону от глаз до рта
"partially" — лицо частично перекрыто, но не медицинской маской и не маской с полным перекрытием лица
"full" — на лице присутствует маска, при которой полностью закрыто лицо, например, балаклава/лыжная маска

Каждому основному состоянию маски соответствует одно из двух дополнительных свойства. Наиболее вероятное дополнительное свойство возвращается в поле "predominant_occlusion":

состоянию "medical_mask" соответствует свойство "correct" или "mouth"
состоянию "missing" соответствует свойство "clear" или "chin"
состоянию "occluded" соответствует свойство "partially" или "full"

Для каждого из свойств возвращается вероятностная оценка в диапазоне [0..1].

Дополнительные свойства маски не записываются в БД и по ним не выполняется фильтрация.

Ресурсы, в которых выполняется оценка:

"/detector"

Название оценки — "estimate_mask".
"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_mask".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_mask".
"/sdk"

Название оценки — "estimate_mask".

Эмоции#

Данная оценка определяет вероятностную оценку для каждого нижеперечисленного параметра в диапазоне [0..1]:

"anger" (злость);
"disgust" (отвращение);
"fear" (страх);
"happiness" (счастье);
"neutral" (нейтральность);
"sadness" (грусть);
"surprise" (удивление).

Также определяется наиболее вероятная эмоция.

Эмоции можно сохранить в объекте события при создании события.

Ресурсы, в которых выполняется оценка:

"/detector"

Название оценки — "estimate_emotions".
"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_emotions".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_emotions".
"/sdk"

Название оценки — "estimate_emotions".

Положение плеч#

Данная оценка определяет наиболее вероятное состояние положения плеч из следующих состояний:

"non-parallel" (плечи не параллельны)
"parallel" (плечи параллельны)
"hidden" (плечи скрыты)

Ресурсы, в которых выполняется оценка:

Определение головного убора доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.2.5 Shoulders" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "shoulders_position".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "shoulders_position".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимый диапазон
"shoulders_position" > "threshold"	["parallel"]

Головной убор#

Данная оценка определяет наиболее вероятный тип головного убора из следующих:

"none" (нет головного убора)
"baseball_cap" (кепка/бейсболка);
"beanie" (шапка);
"peaked_cap" (фуражка);
"shawl" (платок);
"hat_with_ear_flaps" (ушанка);
"helmet" (шлем/каска);
"hood" (капюшон);
"hat" (шляпа);
"other" (прочее).

Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Доступна возможность указывать несколько типов головного убора в качестве допустимых.

Требования к изображению:

Для корректных результатов проверки должны быть выполнены нижеперечисленные требования.

В таблице ниже приведены требования к положению головы:

Параметр	Требуемый диапазон
"pitch"	[-20...20]
"roll"	[-10...10]
"yaw"	[-25...25]

В таблице ниже приведено требование к ширине лица:

Параметр	Требуемый диапазон
face_width	> 80

Ресурсы, в которых выполняется оценка:

Определение головного убора доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "B.2.7 Head coverings" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "headwear_type".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "headwear_type".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"headwear_type" > "threshold"	["none"]

Бочкообразная дисторсия (эффект «Fisheye»)#

Данная оценка определяет наличие эффекта "Fisheye", где:

"0" — на изображении не присутствует эффект "Fisheye";
"1" — на изображении присутствует эффект "Fisheye".

Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Требования к изображению:

Для корректных результатов проверки должны быть выполнены нижеперечисленные требования.

В таблице ниже приведены требования к положению головы:

Параметр	Требуемый диапазон
"pitch"	[-20...20]
"roll"	[-10...10]
"yaw"	[-25...25]

В таблице ниже приведено требование к ширине лица:

Параметр	Требуемый диапазон
"face_width"	> 80

Ресурсы, в которых выполняется оценка:

Определение эффекта "Fisheye" доступна только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.3.6 Radial distortion of the camera lens" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "radial_distortion".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "radial_distortion".

Допустимое значение прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимое значение
"radial_distortion" > "threshold"	"1"

Параметры изображений#

Формат изображения#

Данная оценка определяет формат входящего изображения ("JPEG", "JPEG2000" или "PNG"). Также выполняется сравнение оцененного значения с порогом (в соответствии с ISO или нестандартным порогом).

Ресурсы, в которых выполняется оценка:

Определение формата изображения доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. раздел "7.5 Format requirements for the Frontal Image Type" в стандарте ISO/IEC 19794-5:2011)

Название проверки — "image_format".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "image_format".

Допустимые значения прохождения проверки:

Изображение проходит проверку если попадает в допустимое значение соответствующего порога:

Параметр	Допустимые значения
"image_format" > "threshold"	["JPEG", "JPEG2000", "PNG"]

Размер изображения#

Данная оценка определяет размер изображения в байтах. Также выполняется сравнение оцененного значения с заданным порогом.

Ресурсы, в которых выполняется оценка:

Определение размера изображения доступно только с помощью средств для проверки изображения:

"/detector"

Название проверки — "image_size".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "image_size".

Допустимый диапазон прохождения проверки:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимый диапазон
"image_size" > "threshold"	[5120...2097152]

Ширина и высота изображения#

Данные оценки определяют ширину и высоту изображения в пикселях. Также выполняется сравнение оцененных значений с порогами (в соответствии с ISO или нестандартными порогами).

Ресурсы, в которых выполняется оценка:

Определение ширины и высоты изображения доступно только с помощью средств для проверки изображения:

"/iso" и "/detector" (см. разделы "5.7.4 Width" и "5.7.5 Height" в стандарте ISO/IEC 19794-5:2011)

Названия проверок — "image_height", "image_width".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Названия проверок — "image_height", "image_width".

Допустимые диапазоны прохождения проверок:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимые диапазоны
"image_height" > "threshold"	[180...1920]
"image_width" > "threshold"	[180...1080]

Соотношение сторон изображения#

Данная оценка определяет пропорциональное отношение ширины изображения к высоте. Также выполняется сравнение оцененного значения с заданным порогом.

Ресурсы, в которых выполняется оценка:

Определение соотношения сторон изображения доступно только с помощью средств для проверки изображения:

"/detector"

Название проверки — "aspect_ratio".
"detect_policy" > "face_quality" в ресурсах "/handlers" и "/verifiers"

Название проверки — "aspect_ratio".

Допустимый диапазон прохождения проверки:

Изображение проходит проверку если попадает в допустимый диапазон соответствующего порога:

Параметр	Допустимый диапазон
"aspect_ratio" > "threshold"	[0.74...0.8]

Метаданные EXIF#

При включённой оценке EXIF все теги изображения анализируются, после чего выводятся их названия и значения. См. спецификацию JEITA CP-3451 EXIF для получения подробной информации. Возвращаются следующие данные:

make;
model;
orientation;
latitude;
longitude;
artist;
software;
dateTime;
digitalZoomRatio;
flash;
uid.

Ресурсы, в которых выполняется оценка:

"/detector"

Название оценки — "extract_exif".
"/handlers"

Название оценки — "policies" > "detect_policy" > "extract_exif".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "extract_exif".
"/sdk"

Название оценки — "use_exif_info".

Параметры тел#

Пол и возраст по изображению тела#

Данная оценка позволяет определить пол и возраст человека по изображению тела.

Ресурсы, в которых выполняется оценка:

"/handlers"

Название оценки — "policies" > "detect_policy" > "body_attributes" > "estimate_basic_attributes".
"/sdk"

Название оценки — "estimate_body_basic_attributes".

Верхняя часть тела#

Данная оценка определяет параметры следующих элементов одежды на верхней части тела:

"headwear" — головной убор (нет, есть, неизвестно), цвет головного убора (белый, черный, прочий, неизвестно);
"sleeve" — рукава (длинные рукава, короткие рукава, неизвестно);
"upper_clothing" — цвет верхней одежды (бежевый, чёрный, синий, коричневый, зеленый, серый, хаки, разноцветный, оранжевый, розовый, фиолетовый, красный, белый, желтый, неизвестно)

Ресурсы, в которых выполняется оценка:

"/handlers"

Название оценки — "policies" > "detect_policy" > "body_attributes" > "estimate_upper_body".
"/sdk"

Название оценки — "estimate_upper_body".

Нижняя часть тела#

Данная оценка определяет параметры следующих элементов одежды на нижней части тела:

"lower_garment" — нижняя одежда (брюки, шорты, юбка, неизвестно), цвет нижней одежды (бежевый, чёрный, синий, коричневый, зеленый, серый, хаки, разноцветный, оранжевый, розовый, фиолетовый, красный, белый, желтый, неизвестно);
"shoes" — цвет обуви (черный, белый, прочий, неизвестный);

Ресурсы, в которых выполняется оценка:

"/handlers"

Название оценки — "policies" > "detect_policy" > "body_attributes" > "estimate_lower_body".
"/sdk"

Название оценки — "estimate_lower_body".

Наличие рюкзака#

Данная оценка определяет наличие рюкзака на теле:

"0" — на изображении тела нет рюкзака;
"1" — на изображении тела есть рюкзак.

Ресурсы, в которых выполняется оценка:

"/handlers"

Название оценки — "policies" > "detect_policy" > "body_attributes" > "estimate_accessories".
"/sdk"

Название оценки — "estimate_accessories".

Liveness#

Примечание. Возможность выполнения такой оценки регулируется особым параметром в лицензионном ключе LUNA PLATFORM 5.

Технология Liveness позволяет обнаруживать атаки на биометрическое предъявление. Для оценки Liveness в LUNA PLATFORM, используется эстиматор LUNA SDK OneShotLiveness.

В результате оценки Liveness может вернуться один из следующих результатов:

"0" — человек не является реальным;
"1" — человек является реальным;
"2" — результат проверки неизвестен.

Ресурсы, в которых выполняется оценка:

"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_liveness".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_liveness".
"/sdk"

Название оценки — "estimate_liveness".
"/liveness"

См. дополнительную информацию про Liveness в разделе "Описание OneShotLiveness".

Deepfake#

Примечание. Возможность выполнения такой оценки регулируется особым параметром в лицензионном ключе LUNA PLATFORM 5.

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

Данная оценка позволяет обнаруживать подмену лиц с помощью технологии DeepFake на фотоизображениях.

В результате оценки Deepfake могут вернуться следующие результаты:

"prediction" = "fake" — человек не является реальным;
"prediction" = "real" — человек является реальным;
"score" = [0...1] — степень достоверности выполнения оценки.

При необходимости можно настроить обработчик так, чтобы фильтровать события по предполагаемому результату оценки Deepfake ("fake" или "real"). Для этого в теле запроса обработчика надо указать параметр "deepfake_states" со значением "0" (фильтровать по значению "fake") или "1" (фильтровать по значению "real"). Например, если параметр "deepfake_states" равен "1" (фильтровать по "real"), а эстиматор определил, что результат "fake", то в событии вернется пустое поле "events", а результаты проверки попадут в поле "filtered_detections".

В запросах "create handler" и "create verifier" доступна возможность задать порог "real_threshold" и режим работы "mode". В запросе "sdk" будут использованы значения данных параметров по умолчанию (см. ниже) без возможности явного указания.

Порог

С помощью порога "real_threshold" можно задать значение в диапазоне [0...1], ниже которого система будет считать, что человек не является реальным.

Например, если значение порога "real_threshold" = "0.5", а степень достоверности выполнения оценки "score" = "0.4", то в теле ответа будет выдан результат "prediction" = "fake". Если же значение порога "real_threshold" = "0.6", а степень достоверности выполнения оценки "score" = "0.7", то в теле ответа будет выдан результат "prediction" = "real".

Значение по умолчанию — "0.5".

Режимы работы

Режимы работы описаны в таблице ниже.

Режим работы

Описание

"mode" = "1"

Упрощенный режим работы.

"mode" = "2" (по умолчанию)

Режим работы с использованием дополнительной модели нейронной сети.

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

Если результат предварительной проверки определил, что лицо является поддельным, то в теле ответа будет возвращен результат "score" = "0" и "prediction" = "fake".

Требования к изображению

Для корректных результатов проверки должны быть выполнены нижеописанные требования.

В таблице ниже приведены требования к положению головы:

Параметр	Требуемый диапазон
"pitch"	[-20...20]
"yaw"	[-30...30]

В таблице ниже приведено требование к ширине лица:

Параметр	Требуемый диапазон
"face_width"	> 150

Ресурсы, в которых выполняется оценка:

"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_deepfake".
"/verifiers"

Название оценки — "policies" > "detect_policy" > "estimate_deepfake".
"/sdk"

Название оценки — "estimate_deepfake".

Количество людей#

Примечание. Возможность выполнения такой оценки регулируется особым параметром в лицензионном ключе LUNA PLATFORM 5.

Данная оценка определяет количество людей на изображении.

Ресурсы, в которых выполняется оценка:

"/handlers"

Название оценки — "policies" > "detect_policy" > "estimate_people_count".
"/sdk"

Название оценки — "estimate_people_count".

При необходимости совместно с оценкой количества людей можно получить X и Y координаты людей с помощью параметра "people_count_coordinates" в ресурсе "/handlers" и параметра "people_coordinates" в ресурсе "/sdk".