# 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, 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 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, 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.

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