Версия: 2.4.0 (последняя)

Атрибуты

v1

objects

angles

Углы поворота головы:

Угол поворота (yaw): вращение вокруг вертикальной оси Y.
Угол наклона (pitch): вращение вокруг горизонтальной оси Z.
Угол отклонения (roll): вращение вокруг горизонтальной оси X.

age

Возраст

bbox

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

class

Имя класса объекта, например, лицо (face) или силуэт (body).

confidence

Числовое значение уверенности детекции.

emotions

Эмоции:

emotion: 7 основных эмоций: гнев (angry), отвращение (disgusted), страх (scared), радость (happy), спокойствие (neutral), грусть (sad), удивление (surprised);
confidence: числовое значение уверенности оценки каждой эмоции. Диапазон значений: от 0 до 1.

fitter

fitter_type: вид набора антропометрических точек. Набор fda обеспечивает высокое качество в широком диапазоне ракурсов (вплоть до профильных), при этом алгоритмы распознавания по-прежнему требуют, чтобы ракурс лица был максимально приближен к фронтальному. Набор fda содержит 21 точку.
keypoints: антропометрические точки лица.
left_eye: координаты левого глаза.
right_eye: координаты правого глаза.

gender

Пол

Порядковый номер лица на изображении

liveness

confidence: числовое значение уверенности принадлежности изображения реальному человеку. Диапазон значений: от 0 до 1.
value: вердикт: REAL — на изображении реальный человек, FAKE — изображение не принадлежит реальному человеку.

mask

value: вердикт: true — человек в маске, false — человек без маски.
confidence: числовое значение уверенности наличия или отсутствия маски на лице. Диапазон значений: от 0 до 1.

quality

qaa (Quality Assessment Algorithm) содержит следующий набор данных:
- totalScore: численное значение, обозначает общую оценку качества изображения в баллах от 0 до 100.
- isSharp: логическое значение, обозначает резкость изображения.
- sharpnessScore: численное значение, обозначает оценку резкости в баллах от 0 до 100.
- isEvenlyIlluminated: логическое значение, обозначает равномерность освещения на изображении.
- illuminationScore: численное значение, оценка равномерности освещения в баллах от 0 до 100.
- noFlare: логическое значение, указывает на наличие или отсутствие вспышек на изображении.
- isLeftEyeOpened: логическое значение, обозначает положение левого глаза (открыт/закрыт).
- leftEyeOpennessScore: численное значение, обозначает степень открытости глаза в баллах от 0 до 100.
- isRightEyeOpened: логическое значение, обозначает положение правого глаза (открыт/закрыт).
- rightEyeOpennessScore: численное значение, обозначает степень открытости глаза в баллах от 0 до 100.
- isBackgroundUniform: логическое значение, указывает на однородность фона.
- backgroundUniformityScore: численное значение, оценка однородности фона в баллах от 0 до 100.
- isDynamicRangeAcceptable: логическое значение, показывает, что динамический диапазон интенсивности изображения в области лица превышает/не превышает значение 128.
- dynamicRangeScore: численное значение, оценка динамического диапазона интенсивности в баллах от 0 до 100.
- isEyesDistanceAcceptable: логическое значение, обозначает допустимое/ недопустимое расстояние между глазами.
- eyesDistance: численное значение расстояния между глазами в пикселях.
- isNotNoisy: логическое значение, обозначает наличие или отсутствие шумов на изображении.
- noiseScore: численное значение, оценка зашумленности изображения в баллах от 0 до 100.
- isMarginsAcceptable: логическое значение, обозначает допустимые/недопустимые отступы.
- marginInnerDeviation: численное значение внутреннего отклонения в пикселях.
- marginOuterDeviation: численное значение внешнего отклонения в пикселях.
- isNeutralEmotion: логическое значение, обозначает наличие или отсутствие нейтрального выражения лица.
- neutralEmotionScore: численное значение, оценка степени нейтральных эмоций в баллах от 0 до 100.
- notMasked: логическое значение, указывает на наличие или отсутствие маски на лице.
- notMaskedScore: численное значение, обозначает степень уверенности в отсутствии маски на лице от 0 до 100.
- hasWatermark: логическое значение, указывает на наличие или отсутствие водяного знака на изображении.
- watermarkScore: численное значение, обозначает степень уверенности в наличии водяного знака на изображении от 0 до 100.
- isRotationAcceptable: логическое значение, обозначает допустимый/недопустимый поворот головы.
- maxRotationDeviation: численное значение, максимальный градус отклонения для трех (yaw, pitch, roll) углов поворота головы.

$template

Биометрический шаблон, закодированный в base64

template_size

Размер биометрического шаблона (длина вектора)

verification

distance

Атрибут обозначает дистанцию между сравниваемыми векторами шаблонов. Биометрический шаблон представляет собой вектор признаков лица в N-мерном пространстве. Результатом сравнения двух векторов признаков лица является скалярное значение евклидовой дистанции между векторами. Чем короче эта дистанция, тем выше степень схожести.

fa_r (False Acceptance Rate)

Вероятность ошибочных подтверждений: атрибут показывает уровень сопротивления системы ошибкам ложного распознавания. Такая ошибка возникает, когда биометрическая система определяет новое лицо как ранее распознанное, т.е. принимает изображения разных людей за изображение одного и того же человека. Коэффициент измеряется количеством ложных распознаваний, деленным на общее количество попыток распознавания.

fr_r (False Rejection Rate)

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

score

Атрибут показывает степень схожести лиц от 0 (0%) до 1 (100%). Высокая степень схожести означает, что два биометрических шаблона принадлежат одному и тому же человеку.

v2

objects

pose

Углы поворота головы:

Угол поворота (yaw): вращение вокруг вертикальной оси Y.
Угол наклона (pitch): вращение вокруг горизонтальной оси Z.
Угол отклонения (roll): вращение вокруг горизонтальной оси X.

age

Возраст

bbox

class

Имя класса объекта, например, лицо (face) или силуэт (body).

confidence

Числовое значение уверенности детекции.

emotions

Эмоции:

emotion: 7 основных эмоций: гнев (angry), отвращение (disgusted), страх (scared), радость (happy), спокойствие (neutral), грусть (sad), удивление (surprised);
confidence: числовое значение уверенности оценки каждой эмоции. Диапазон значений: от 0 до 1.

keypoints

fitter_type: вид набора антропометрических точек. Набор fda обеспечивает высокое качество в широком диапазоне ракурсов (вплоть до профильных), при этом алгоритмы распознавания по-прежнему требуют, чтобы ракурс лица был максимально приближен к фронтальному. Набор fda содержит 21 точку.
left_eye_brow_left: координаты левого конца левой брови.
left_eye_brow_up: координаты центра левой брови.
left_eye_brow_right: координаты правого конца левой брови.
right_eye_brow_left: координаты левого конца правой брови.
right_eye_brow_up: координаты центра правой брови.
right_eye_brow_right: координаты правого конца правой брови.
left_eye_left: координаты левого уголка левого глаза.
left_eye: координаты центра левого глаза.
left_eye_right: координаты правого уголка левого глаза.
right_eye_left: координаты левого уголка правого глаза.
right_eye: координаты центра правого глаза.
right_eye_right: координаты правого уголка правого глаза.
left_ear_bottom: координаты нижней части левого уха.
nose_left: координаты левой части носа.
nose: координаты центра носа.
nose_right: координаты правой части носа.
right_ear_bottom: координаты нижней части правого уха.
mouth_left: координаты левого уголка рта.
mouth: координаты центра рта.
mouth_right: координаты правого уголка рта.
chin: координаты подбородка.

gender

Пол

Порядковый номер лица на изображении.

liveness

confidence: числовое значение уверенности принадлежности изображения реальному человеку. Диапазон значений: от 0 до 1.
value: вердикт: real — на изображении реальный человек, fake — изображение не принадлежит реальному человеку.

has_medical_mask

value: вердикт: true — человек в маске, false — человек без маски.
confidence: числовое значение уверенности наличия/отсутствия маски на лице. Диапазон значений: от 0 до 1.

quality

total_score: численное значение, обозначает общую оценку качества изображения в баллах от 0 до 1.
is_sharp: логическое значение, обозначает резкость изображения.
sharpness_score: численное значение, обозначает оценку резкости в баллах от 0 до 1.
is_evenly_illuminated: логическое значение, обозначает равномерность освещения на изображении.
illumination_score: численное значение, оценка равномерности освещения в баллах от 0 до 1.
no_flare: логическое значение, указывает на наличие или отсутствие вспышек на изображении.
is_left_eye_opened: логическое значение, обозначает положение левого глаза (открыт или закрыт).
left_eye_openness_score: численное значение, обозначает степень открытости глаза в баллах от 0 до 1.
is_right_eye_opened: логическое значение, обозначает положение правого глаза (открыт или закрыт).
right_eye_openness_score: численное значение, обозначает степень открытости глаза в баллах от 0 до 1.
is_background_uniform: логическое значение, указывает на однородность фона.
background_uniformity_score: численное значение, оценка однородности фона в баллах от 0 до 100.
is_dynamic_range_acceptable: логическое значение, показывает, что динамический диапазон интенсивности изображения в области лица превышает или не превышает значение 128.
dynamic_range_score: численное значение, оценка динамического диапазона интенсивности в баллах от 0 до 100.
is_eyes_distance_acceptable: логическое значение, обозначает допустимое/недопустимое расстояние между глазами.
eyes_distance: численное значение расстояния между глазами в пикселях.
is_not_noisy: логическое значение, обозначает наличие или отсутствие шумов на изображении.
noise_score: численное значение, оценка зашумленности изображения в баллах от 0 до 100.
is_margins_acceptable: логическое значение, обозначает допустимые/недопустимые отступы.
margin_inner_deviation: численное значение внутреннего отклонения в пикселях.
margin_outer_deviation: численное значение внешнего отклонения в пикселях.
is_neutral_emotion: логическое значение, обозначает наличие или отсутствие нейтрального выражения лица.
neutral_emotion_score: численное значение, оценка степени нейтральных эмоций в баллах от 0 до 1.
not_masked: логическое значение, указывает на наличие или отсутствие маски на лице.
not_masked_score: численное значение, обозначает степень уверенности в отсутствии маски на лице от 0 до 1.
has_watermark: логическое значение, указывает на наличие или отсутствие водяного знака на изображении.
watermark_score: численное значение, обозначает степень уверенности в наличии водяного знака на изображении от 0 до 1.
is_rotation_acceptable: логическое значение, обозначает допустимый/недопустимый поворот головы.
max_rotation_deviation: численное значение, максимальный градус отклонения для трех (yaw, pitch, roll) углов поворота головы.

template

_face_template_extractor_1000_12: ключ, описывающий используемый метод распознавания лиц (в примере указан метод 12v1000).
- blob: биометрический шаблон, закодированный в base64.
- format: формат данных, находящихся в поле blob.
- dtype: тип данных, который используется для представления пикселей изображения.
- shape: размер биометрического шаблона (длина вектора).

verification

distance

Атрибут обозначает дистанцию между сравниваемыми векторами шаблонов. Биометрический шаблон — это вектор признаков лица в N-мерном пространстве. Результатом сравнения двух векторов признаков лица является скалярное значение евклидовой дистанции между векторами. Чем короче эта дистанция, тем выше степень схожести.

fa_r (False Acceptance Rate)

fr_r (False Rejection Rate)

score

v1​

objects​

verification​

v2​

objects​

verification​

v1

objects

verification

v2

objects

verification