Атрибуты

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

Пол

id

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

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: численное значение расстояния между глазами в px;
  • isNotNoisy: логическое значение, обозначает наличие/отсутствие шумов на изображении;
  • noiseScore: численное значение, оценка зашумленности изображения в баллах от 0 до 100;
  • isMarginsAcceptable: логическое значение, обозначает допустимые/недопустимые отступы;
  • marginInnerDeviation: численное значение внутреннего отклонения в px;
  • marginOuterDeviation: численное значение внешнего отклонения в px;
  • 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%). Высокая степень схожести означает, что два биометрических шаблона принадлежат одному и тому же человеку.