# Attributes

## v1

### 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 of a person in an image

## 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 such as 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 face landmarks. The
**fda**set contains 21 points and provides high accuracy in a wide range of facial angles (up to the full profile), in contrast to the previous sets. - keypoints: coordinates of face landmarks
- left_eye: left eye coordinates
- right_eye: right eye coordinates

## gender

Gender of a person in an image

## id

The ordinal number of a face in an 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 doesn't 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

- 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

- qaa (Quality Assessment Algorithm) contains the following data:

## $template

Biometric template coded in base64

## template_size

Size of a biometric template (vector length)

### verification

## distance

Distance between compared vectors of biometric face templates. The lower the value, the higher the degree of similarity.

## fa_r (False Acceptance Rate)

False acceptance rate shows the system resistance to false acceptance errors. Such an error occurs when the biometric system recognizes a new face as previously detected one, i.e. images of different people are mistaken for images of the same person. This rate is measured by the number of false-acceptance recognitions divided by the total number of recognition attempts.

## fr_r (False Rejection Rate)

False rejection occurs when a system fails to recognize a previously detected face, i.e. two images of the same person are mistaken for images of different people. The rate shows the percentage of recognition attempts with false rejection result.

## score

The attribute shows the degree of similarity of faces from 0 (0%) to 1 (100%). A high degree of similarity means that two biometric templates belong to the same person.

## v2

### objects

## pose

Head rotation angles:

- yaw: rotation around vertical Y-axis
- pitch: rotation around horizontal Z-axis
- roll: rotation around horizontal X-axis

## age

Age of a person in an image

## 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 such as 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

## keypoints

- fitter_type: type of set of anthropometric points. The
**fda**set contains 21 points and provides high accuracy in a wide range of facial angles (up to the full profile), in contrast to the previous sets. - left_eye_brow_left: coordinates of the left end of the left eyebrow
- left_eye_brow_up: coordinates of the center of the left eyebrow
- left_eye_brow_right: coordinates of the right end of the left eyebrow
- right_eye_brow_left: coordinates of the left end of the right eyebrow
- right_eye_brow_up: coordinates of the center of the right eyebrow
- right_eye_brow_right: coordinates of the right end of the right eyebrow
- left_eye_left: coordinates of the left corner of the left eye
- left_eye: coordinates of the center of the left eye
- left_eye_right: coordinates of the right corner of the left eye
- right_eye_left: coordinates of the left corner of the right eye
- right_eye: coordinates of the center of the right eye
- right_eye_right: coordinates of the right corner of the right eye
- left_ear_bottom: coordinates of the bottom of the left ear
- nose_left: coordinates of the left side of the nose
- nose: coordinates of the center of the nose
- nose_right: coordinates of the right side of the nose
- right_ear_bottom: coordinates of the bottom of the right ear
- mouth_left: coordinates of the left corner of the mouth
- mouth: coordinates of the center of the mouth
- mouth_right: coordinates of the right corner of the mouth
- chin: chin coordinates

## gender

Gender of a person in an image

## id

The ordinal number of a face in an 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 doesn't belong to a real person.

## has_medical_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

- total_score: numerical value for overall image quality score in points from 0 to 1
- is_sharp: boolean value for image sharpness
- sharpness_score: numerical value for sharpness assessment in points from 0 to 1
- is_evenly_illuminated: boolean value for image illumination uniformity
- illumination_score: numerical value for score of illumination uniformity in points from 0 to 1
- no_flare: boolean value for presence/absence of image flares
- is_left_eye_opened: boolean value for position of left eye (open/closed)
- left_eye_openness_score: numerical value for eye openness score in points from 0 to 1
- is_right_eye_opened: boolean value for position of right eye (open/closed)
- right_eye_openness_score: numerical value for eye openness score in points from 0 to 1
- is_background_uniform: boolean value for background uniformity
- background_uniformity_score: numerical value for background uniformity score in points from 0 to 1
- is_dynamic_range_acceptable: boolean value shows that dynamic range of image intensity in face area exceeds/does not exceed the value of 128
- dynamic_range_score: numerical value for score of dynamic range of intensity in points from 0 to 1
- is_eyes_distance_acceptable: boolean value for acceptable/unacceptable distance between the eyes
- eyes_distance: numerical value of distance between eyes in px
- is_not_noisy: boolean value for presence/absence of image noise
- noise_score: numerical value of image noise in points from 0 to 1
- is_margins_acceptable: boolean value for acceptable/unacceptable margins
- margin_inner_deviation: numerical value of inner deviation in px
- margin_outer_deviation: numerical value of outer deviation in px
- is_neutral_emotion: boolean value for presence/absence of neutral emotions
- neutral_emotion_score: numerical value for score of neutral emotions in points from 0 to 1
- not_masked: boolean value for presence/absence of medical mask
- not_masked_score: numerical value of confidence that a person in the image isn’t wearing a medical mask in points from 0 to 1
- has_watermark: boolean value for presence/absence of watermark in the image
- watermark_score: numerical value of confidence that the image contains a watermark in points from 0 to 1
- is_rotation_acceptable: boolean value for acceptable/ unacceptable yaw, pitch and roll angles
- max_rotation_deviation: numerical value for max deviation of yaw, pitch and roll angles

## $template

- _face_template_extractor_1000_12: key describing the face recognition method used (the example shows method 12v1000)
- blob: biometric template encoded in base64
- format: format of the data contained in the blob field
- dtype: data type used to represent image pixels
- shape: size of the biometric template (vector length)

## template_size

Size of a biometric template (vector length)

### verification

## distance

The attribute denotes the distance between the compared template vectors. A biometric template is a vector of facial features in N-dimensional space. The result of comparing two vectors of facial features is a scalar value of the Euclidean distance between the vectors. The shorter this distance, the higher the degree of similarity.

## fa_r (False Acceptance Rate)

False acceptance rate shows the system resistance to false acceptance errors. Such an error occurs when the biometric system recognizes a new face as previously detected one, i.e. images of different people are mistaken for images of the same person. This rate is measured by the number of false-acceptance recognitions divided by the total number of recognition attempts.

## fr_r (False Rejection Rate)

False rejection occurs when a system fails to recognize a previously detected face, i.e. two images of the same person are mistaken for images of different people. The rate shows the percentage of recognition attempts with false rejection result.

## score

The attribute shows the degree of similarity of faces from 0 (0%) to 1 (100%). A high degree of similarity means that two biometric templates belong to the same person.