Skip to main content
Version: 1.1.0

Attributes

objects:

  • angles: head rotation angles:
    • yaw: rotation around vertical Y-axis;
    • pitch: rotation around horizontal Z-axis;
    • roll: rotation around horizontal X-axis.
  • age: age;
  • bbox: the rectangle that represents face bounds in the image. The bounds are calculated relative to the coordinates of the original image;
  • class: object class name, e.g., face or body;
  • confidence: numerical value of detection confidence;
  • emotions:
    • emotion: 7 basic emotions: angry, disgusted, scared, happy, neutral, sad, surprised;
    • confidence: the numerical value of manifestation of each estimated emotion. Value range: 0 to 1.
  • fitter:
    • fitter_type: type of set of anthropometric points. The fda provides high accuracy in a wide range of facial angles (up to the full profile), in contrast to the previous sets, however, recognition algorithms still require face samples to be close to frontal. The fda set contains 21 points;
    • keypoints: anthropometric points;
    • left_eye: left eye coordinates;
    • right_eye: right eye coordinates;
  • gender: gender;
  • id: the ordinal number of a face in the image;
  • liveness:
    • confidence: numerical value of confidence that the image belongs to a real person. Value range: 0 to 1;
    • value: verdict: REAL - the face image belongs to a real person, FAKE - the face image does not belong to a real person.
  • mask:
    • value: verdict: true - masked person, false - unmasked person;
    • confidence: the numerical value of confidence that a person in the image is/isn’t wearing a mask. Value range: 0 to 1.
  • quality:
    • qaa (Quality Assessment Algorithm) contains the following data:
      • totalScore: numerical value for overall image quality score in points from 0 to 100;
      • isSharp: boolean value for image sharpness;
      • sharpnessScore: numerical value for sharpness assessment in points from 0 to 100;
      • isEvenlyIlluminated: boolean value for image illumination uniformity;
      • illuminationScore: numerical value for score of illumination uniformity in points from 0 to 100;
      • noFlare: boolean value for presence/absence of image flares;
      • isLeftEyeOpened: boolean value for position of left eye (open/closed);
      • leftEyeOpennessScore: numerical value for eye openness score in points from 0 to 100;
      • isRightEyeOpened: boolean value for position of right eye (open/closed);
      • rightEyeOpennessScore: numerical value for eye openness score in points from 0 to 100;
      • isBackgroundUniform: boolean value for background uniformity;
      • backgroundUniformityScore: numerical value for background uniformity score in points from 0 to 100;
      • isDynamicRangeAcceptable: boolean value shows that dynamic range of image intensity in face area exceeds/does not exceed the value of 128;
      • dynamicRangeScore: numerical value for score of dynamic range of intensity in points from 0 to 100;
      • isEyesDistanceAcceptable: boolean value for acceptable/unacceptable distance between the eyes;
      • eyesDistance: numerical value of distance between eyes in px;
      • isNotNoisy: boolean value for presence/absence of image noise;
      • noiseScore: numerical value of image noise in points from 0 to 100;
      • isMarginsAcceptable: boolean value for acceptable/unacceptable margins;
      • marginInnerDeviation: numerical value of inner deviation in px;
      • marginOuterDeviation: numerical value of outer deviation in px;
      • isNeutralEmotion: boolean value for presence/absence of neutral emotions;
      • neutralEmotionScore: numerical value for score of neutral emotions in points from 0 to 100;
      • notMasked: boolean value for presence/absence of medical mask;
      • notMaskedScore: numerical value of confidence that a person in the image isn’t wearing a medical mask in points from 0 to 100;
      • hasWatermark: boolean value for presence/absence of watermark in the image;
      • watermarkScore: numerical value of confidence that the image contains a watermark in points from 0 to 100;
      • isRotationAcceptable: boolean value for acceptable/ unacceptable yaw, pitch and roll angles;
      • maxRotationDeviation: numerical value for max deviation of yaw, pitch and roll angles.
  • $template: biometric template coded in base64;
  • template_size: size of biometric template (vector length);

verification:

  • distance: distance between vectors of biometric templates;
  • fa_r: false acceptance rate; -fr_r: false rejection rate;
  • score: face verification rate from 0 (0%) to 1 (100%).