Перейти к основному содержимому
Версия: 2.3.1

Атрибуты

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
Пол
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: численное значение расстояния между глазами в пикселях.
    • 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
Пол
id
Порядковый номер лица на изображении.
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
Атрибут показывает степень схожести лиц от 0 (0%) до 1 (100%). Высокая степень схожести означает, что два биометрических шаблона принадлежат одному и тому же человеку.