Handling policies section#
The “Handling policies” section is intended for creating, deleting, viewing policies, and editing their parameters.
Handling policies (handlers) can be static or dynamic.
If the handler is static, its parameters are specified when creating the handler.
If the handler is dynamic, then you can change its parameters when generating an event. For this, create a generate events
request with a specific content type (see API Reference Manual of the LUNA PLATFORM 5 documentation). In a dynamic handler, administrator can allow users to specify parameters that change with each request. At the same time other technical parameters can be set separately and left hidden from the user. With a static handler, administrator would have to create a new handler for each new task.
The general view of the “Handling policies” section is presented below (Figure 28).
“Handling policies” section contains the following elements:
- table of policies:
- “Description”—policy name;
- “Handling policy ID”—policy identifier;
- “Handler type”—static or dynamic policy;
- —button for editing policy parameters (1);
- —button for deleting the policy (2);
- “Add static” button—button for creating a static handling policy;
- “Add dynamic button—button for creating a dynamic handling policy;
- the number of policies displayed on the page is set by the switch in the lower right corner of the page. There can be 10, 25, 50 or 100 policies in total on one page (3).
Policy creation#
Static policy creation#
To create a static policy, click on the “Add static” button (Figure 28). A form will open to select how to create the static policy (Figure 29):
- preconfigured typical policy templates (policies 1–6);
- step by step custom policy (“Other”).
To quickly create simple static policies, use one of the typical policy templates.
Six standard templates are available:
- “Policy 1. Registration of a reference descriptor (with saving to a list)”—allows user to detect a face on the frame, check Liveness, and save the face to a specified list;
- “Policy 2. Biometric identification of faces (without saving to a list)”—allows user to detect all faces in the frame and compare them with all faces in the specified list;
- “Policy 3. Saving the faces identified in the list to the database”—allows user to detect all faces on the frame, check Liveness, compare detected faces with all faces in the specified list, and if the comparison is successful, save the face to the specified list;
- “Policy 4. Determination of attributes and properties of a face without identification (gender, age, emotions, etc.)”—allows user to detect all faces in the frame, perform all possible checks, and save the event;
- “Policy 5. Saving events for unique faces for later counting”—allows user to detect all faces in the frame, check Liveness, compare the detected faces with all faces in the list of unique faces, and if this face is not in the list, save the face to this list of unique faces;
- “Policy 6. Registration of a reference descriptor with verification of compliance of the photo with the requirements of biometric standards*—allows you to save the reference descriptor in a specific list only for those photos that have been verified in accordance with the biometric standards.
* The following checks are missing in the beta version:
- it is not allowed to use retouching and image editing;
- image cropping is allowed;
- compression code: JPEG (0 x 00), PNG (0 x 03).
When user clicks on a line with a standart template (policies 1–6), a window opens for entering the main parameters of a preconfigured policy (Figure 30).
Fill in all the required parameters and click on the “Create” button. A window will open with a message about the successful creation of the policy (Figure 31).
Click anywhere outside the successful static policy generation message to navigate to the “Select the type of policy you want to create” form (Figure 29).
To create a unique static policy that requires detailed parameter settings, use the step-by-step custom policy.
When user clicks on the line with a step-by-step custom policy (“Other”), a form for step-by-step static policy creation will open (Figure 32).
Fill in all the required parameters and click on the “Next” button to proceed to the next step. After setting all the parameters, a window with a message about the successful creation of the policy will open.
Dynamic policy creation#
To create a dynamic policy, click on the “Add dynamic” button on the page with the list of policies (Figure 28). In the opened window, enter the name of the new dynamic policy and click “Save” (Figure 33). If you need to go back to the page with the list of handlers during creating a handler, press the Esc key on your keyboard.
Policy editing#
Static policy editing#
The general view of the static policy editing form is shown below (Figure 34).
Description of the parameters of the static policy editing form is given below (Table 8-18).
Table 8. Parameters of the static policy editing form: general parameters and determined attributes
Parameter |
Description |
Default value |
---|---|---|
General |
||
Policy name* |
Specifies the name that will be displayed in the list of other policies |
- |
Determined attributes |
||
Detect face |
Face detection in photo images When enabled, the "Face descriptor" and "Basic attributes (gender, age)" options become avalible |
Off |
Face descriptor |
Image processing and creation of a data set in a closed, binary format using a special extraction algorithm. When the attribute is enabled, the options “Labels”, “Save descriptor in database”, “Save face to database”, “Attach face to list”, “Save event in cases where a face was found”, and “Display event in cases where a face was found” become available |
On |
Basic attributes (gender, age) |
Assessment of the basic attributes of a person in the image. On When the attribute is enabled, the “Save if” and "Call only in cases" options become available |
|
Head position |
Assessment of the head position (angles of inclination and rotation of the head left/right and up/down). When the attribute is enabled, the options “Discard face images with head rotation/tilt angle above” become available |
On |
Emotion |
Determination of the dominant emotion (anger, disgust, fear, happiness, neutral, sadness, surprise) |
Off |
Mask |
Assessment of the presence or absence of a medical mask or mouth covering. When the attribute is enabled, the filter “Process images only if detected” becomes available |
Off |
Image quality |
Determination of quality (the presence of overexposure, blurring, underexposure, the presence of glare on the face, uneven lighting) |
On |
Eye direction |
Assessment of the direction of a person's gaze in the image |
Off |
Presence of glasses |
Assessment of the presence of glasses and their type (glasses, sunglasses, no glasses) |
Off |
Eye status |
Evaluating whether a person's eyes are open or closed in the image, as well as determining key points of the irises of the eyes |
Off |
Mouth status |
Closed or occluded mouth detection and smile detection |
Off |
Position of 68 feature points of the face |
Determination of 68 feature points of the face (requires additional time for calculations, it is used to determine emotions, eye direction or Liveness check) |
Off |
EXIF metadata |
Defining image metadata |
Off |
Table 9. Parameters of the static policy editing form: Liveness check
Parameter |
Description |
Default value |
---|---|---|
Perform Liveness check |
Enabling Liveness check |
Off |
Discard images of faces with a Liveness score below the specified |
Ignoring images with a Liveness score below the specified value. Possible values: from 0 to 1. Available only if the “Perform Liveness check” attribute is enabled |
0,5 |
Discard images of faces with the Liveness quality lower than the specified |
Ignoring images with a Liveness quality lower than the specified. Possible values: from 0 to 1. Available only if the “Perform Liveness check” attribute is enabled |
0,5 |
Table 10. Parameters of the static policy editing form: Deepfake check **
Parameter |
Description |
Default value |
---|---|---|
Perform Deepfake check |
Determination of digital manipulations for replace one person's likeness convincingly with that of another |
Off |
Discard images of faces with a Deepfake score below the specified score |
Ignoring images with a Liveness score below the specified value. Possible values: from 0 to 1, where 1 is a real person, 0 - fake |
0,5 |
Use specified Deepfake mode |
Possible values:
The choice of mode determines what set of neural networks perform photo processing for deepfake checking. For more information about the neural networks used in deepfake verification modes, contact VisionLabs technical support. |
Mode 2 |
** Deepfake license required. Deepfake check is not performed on normalized (centered and cropped) images after face detection.
Table 11. Parameters of the static policy editing form: image quality check
Parameter |
Description |
Default value |
---|---|---|
Perform face image quality check |
Enabling quality check |
|
Image format |
Must be saved in .jpeg or .png format (correct verification). Possible values:
|
JPEG; PNG JPEG2000; |
Image size in Mb |
This assessment determines the size of the image in bytes. It also compares the estimated value with the specified threshold |
5120: 2097152 |
Image width in pixels |
This assessment determines the width of the image in pixels. It also compares the estimatedvalues with thresholds (according to ISO or custom thresholds) |
180:1920 |
Image height in pixels |
This assessment determines the width of the image in pixels. It also compares the estimated values with thresholds (according to ISO or custom thresholds) |
180:1080 |
Image aspect ratio |
This assessment determines the proportional ratio of the image width to height. It also compares the estimated value with the specified threshold |
0.74:0,8 |
Degree of illumination uniformity |
It is possible to evaluate the uniformity of illumination according to the requirements specified in the ICAO standard. It also compares the estimated value with the specified threshold (correct verification) |
0.3:1 |
Degree of image specularity |
Bright light artifacts and flash reflection from glasses are not allowed (indirect verification) |
0.3:1 |
Degree of image blureness |
The pixel colors of front-type photo images must be represented in the 24-bit RGB color space, in which each pixel has 8 bits for each color component: red, green, and blue (indirect verification) |
0.61:1 |
Degree of absence of underexposure in the photo |
An underexposure assessment is available. It also compares the estimated value with the specified threshold |
0.5:1 |
Degree of absence of overexposure in the photo |
Too much exposure assessment is available. It also compares the estimated value with the specified threshold |
0.57:1 |
Face illumination uniformity |
It is possible to evaluate the uniformity of illumination according to requirements specified in ICAO standard. The face should be evenly lit so that there are no shadows or glare on the face image. It also compares the estimated value with the specified threshold (correct verification) |
0.5:1 |
Skin tone dynamic range |
This assessment is a determination of the ratio of the brightness of the lightest and darkest areas of the face according to the requirements specified in the ICAO standard. It also compares the estimated value with the specified threshold (correct verification) |
0.5:1 |
Degree of uniformity of the background |
This assessment determines the degree of background uniformity from 0 to 1, where:
|
0.5:1 |
Degree of lightness of the background |
This rating determines the degree of background brightness from 0 to 1, where:
|
0.5:1 |
Presence of radial distortion (Fisheye effect) |
Possible values:
|
No |
Type of image color based on face |
Possible values: Color; Grayscale; Infrared—near-infrared |
Color |
Shoulders position |
This assessment determines the position of the shoulders if they are in the frame: Parallel Non-parallel Hidden |
Parallel |
Face width in pixels |
This assessment determines the width of the face in pixels. It also compares the estimated value with the specified threshold |
180:1920 |
Face height in pixels |
This assessment determines the height of the face in pixels. It also compares the estimated value with the specified threshold |
180:1080 |
Face offset from the top edge of the image in pixels |
The image must contain a full front view of the person's head, including the left and right ear (if person has any), the top point of the forehead area and the chin (correct verification) |
20:50 |
Face offset from the bottom edge of the image in pixels |
The image must contain a full front view of the person's head, including the left and right ear (if person has any), the top point of the forehead area and the chin (correct verification) |
20:50 |
Face offset from the left edge of the image in pixels |
The image must contain a full front view of the person's head, including the left and right ear (if person has any), the top point of the forehead area and the chin (correct verification) |
20:50 |
Face offset from the right edge of the image in pixels |
The image must contain a full front view of the person's head, including the left and right ear (if person has any), the top point of the forehead area and the chin (correct verification) |
20:50 |
Head yaw angle |
Head rotation should be no more than 5° from the frontal position (correct verification) |
-5:5 |
Head pitch angle |
The image must contain a full front view of the person's head, including the left and right ear (if person has any), the top point of the forehead area and the chin (correct verification). The tilt of the head should be no more than 5° from the frontal position (correct verification) |
-5:5 |
Head roll angle |
The image must contain a full front view of the person's head, including the left and right ear (if person has any), the top point of the forehead area and the chin (correct verification). The inclination of the head should be no more than 8° from the frontal position (correct verification) |
-8:8 |
Gaze yaw angle |
This assessment determines the direction of gaze (yaw) |
-5:5 |
Gaze pitch angle |
This assessment determines the direction of gaze (pitch) |
-5:5 |
Probability of smile presence |
The facial expression must be neutral (indirect verification). |
0:0.5 |
Probability of mouth occlusion |
It is not allowed to cover the face with hair or foreign objects along the entire width, from the eyebrows to the lower lip (indirect verification) |
0:0.5 |
Probability of open mouth presence |
This assessment determines the state of the mouth The mouth is closed (correct verification) |
0:0.5 |
Smile properties |
This assessment determines the state of the mouth The facial expression must be neutral (indirect verification). Possible values: None—smile is not found; Smile with closed mouth; Smile with teeth |
None |
Glasses |
Sun glasses are not allowed (correct verification). Possible values: Sunglasses; Eyeglasses; No glasses |
No glasses |
Left eye status |
Both eyes are open normally for the respective subject (considering behavioral factors and/or medical conditions, correct verification). It is not allowed to cover the face with hair or foreign objects along the entire width, from the eyebrows to the lower lip (indirect verification) Possible values: Open; Closed; Occluded |
Open |
Right eye status |
Both eyes are open normally for the respective subject (considering behavioral factors and/or medical conditions, correct verification). It is not allowed to cover the face with hair or foreign objects along the entire width, from the eyebrows to the lower lip (indirect verification). Possible values: Open; Closed; Occluded |
Open |
Red eyes effect presence |
Possible values: No—there is no red-eye effect; Yes—there is a red-eye effect |
No |
Distance between eye centers in pixels |
The image must contain a full front view of the person's head, including the left and right ear (if person has any),the top point of the forehead area and the chin (correct verification) The distance between the centers of the eyes must be at least 120 pixels or at least 45 pixels in accordance with paragraph 12 of the procedure for placing and updating biometric personal data in a unified biometric system (correct verification) |
90:100 |
Horizontal head size relative to image size |
This assessment determines the horizontal head size relative to the image size. It also compares the estimated values with thresholds (according to ISO or custom thresholds) |
0.5:75 |
Vertical head size relative to image size |
This assessment determines the vertical head size relative to the image size. It also compares the estimated values with thresholds (according to ISO or custom thresholds) |
0.6:0.9 |
The position of the center point of the face horizontally relative to the image |
This assessment determines the horizontal position of the center point relative to the image. It also compares the estimated values with thresholds (according to ISO or custom thresholds) |
0.45:0.55 |
The position of the center point of the face vertically relative to the image |
This assessment determines the vertical position of the center point relative to the image. It also compares the estimated values with thresholds (according to ISO or custom thresholds) |
0.3:0.5 |
Eyebrows state |
The facial expression must be neutral (indirect verification). Possible values: Neutral; Raised; Squnting; Frowning |
Neutral |
Headwear type |
Possible values: None; Baseball_cap; Beanie; Peaked_cap; Shawl; Hat with earflaps; Helmet; Hood; Hat; Other |
None |
Presence of natural lighting |
The face should be evenly lit so that there are no shadows or glare on the face image (correct verification) Possible values: No—the lighting is unnatural; Yes—the lighting is natural |
Yes |
Table 12. Parameters of the static policy editing form: determined body attributes
Parameter |
*Description * |
Default value |
---|---|---|
Detect body |
Face detection in photo images |
Off |
Body descriptor |
Image processing and creation of a data set in a closed, binary format using a special extraction algorithm. When the attribute is enabled, the “Labels” option becomes available |
On |
Body basic attributes |
Gender and age estimation based on body silhouette |
|
Upper body attributes based on body silhouette |
Estimation of headwear, upper body clothing color, and sleeve length |
|
Lower body attributes based on body silhouette |
Estimation of lower body clothing type and shoe color |
|
Accessories |
Estimation of the presence or absence of a backpack |
Table 13. Parameters of the static policy editing form: estimation of people count
Parameter |
Description |
Default value |
---|---|---|
Estimate people count |
Counts the number of people in the frame |
Off |
Determine the coordinates of people's bounding box |
Getting X and Y coordinates of people |
Enabled |
Table 14. Parameters of the static policy editing form: filters
Parameter |
Description |
Default value |
---|---|---|
Filters |
||
Discard images with multiple faces |
Determination of images containing multiple faces. Possible values: Select only one face of the best quality—process an image containing several faces, but detect only a face of the best quality; Do not discard—detect all faces in the image; Discard—ignore an image containing multiple faces |
Do not discard |
Reject descriptors with quality below the specified threshold |
Ignoring low quality images. To use the filter, you must enable the determination of the descriptor in the determined attributes |
0,5 |
Process images only if detected |
Possible values: Missing—the event is created when there is no overlap of the face by the medical mask (no mask); Occluded—the event is created in case of detection of face overlapping; Medical mask—the event is created when a medical mask is detected on the face. Several filter values can be specified. Available only when defining the “Medical mask” attribute |
- |
Discard face images with head rotation angle (to the left or right, yaw) above |
Ignoring images in which the person's head is turned to the left or right at a too large angle —no information will be extracted when detecting a face and evaluating the angle of head rotation. Available only if the “Head position” attribute is enabled |
30 |
Discard face images with head tilt angle (to the left or right, roll) above |
Ignoring images in which a person's head is tilted to the left or right at a too large angle—no information will be extracted during face detection and head tilt evaluating. Available only if the “Head position” attribute is enabled |
40 |
Discard face images with head tilt angle (up or down, pitch) above |
Ignoring images in which the person’s head is tilted up or down at a too large angle —no information will be extracted during face detection and head tilt evaluating. Available only if the “Head position” attribute is enabled |
30 |
Process images of faces only with Liveness states |
Processing images with Liveness status: Spoof—the absence of a “live” person in the frame; Real—the presence of a “live” person in the frame; Unknown. Available only if the “Perform Liveness check” attribute is enabled |
- |
Process images of faces only with Deepfake states |
Processing images with Deepfake status: Fake—the absence of a “live” person in the frame; Real—the presence of a “live” person in the frame. Available only if the Perform Deepfake check” attribute is enabled |
- |
Filter images based on face image quality assessment results |
Filter images according to the parameters set in the "Perform face image quality assessment" setting that comply with ISO/IEC 19794-5:2011 and ICAO Available only when the parameter “Perform face image quality assessment*” is enabled |
Off |
Table 15. Parameters of the static policy editing form: labels
Parameter |
Description |
Default value |
---|---|---|
Labels |
||
Label name |
Specify the name that will be displayed in the policy settings, including the parameters for creating and saving an image/descriptor/event/face, adding a tag |
- |
Identify among |
Searching for a detected person for identification among those created in the database:
|
Faces |
Search for a descriptor |
Among the events created in the database, search for a descriptor:
Only for "Identify among events" |
Faces |
Perform search by |
|
- |
|
||
Each filled field imposes a search restriction—the comparison will be successful only if all the search conditions are met |
||
Location (only for “Identify among events”) |
“District”; “Area”; “City”; “Street”; “House number”; “Longitude (-180…180)”; “Accuracy (0…90)”; “Latitude (-90…90)”; “Accuracy (0…90)” |
- |
Filter search result by |
“Gender”—specifies the gender for which the face comparison is performed; “Age category”—specifies the lower and/or upper limits of the age of the face is indicated for comparison; “Liveness”—specifies Liveness state (Spoof, Real or Unknown) |
- |
Additional search parameters |
“The maximum number of similar ones in the search results”; “Accuracy threshold”—a value from 0 to 1 |
- |
Table 16. Parameters of the policy editing form: save parameters
Parameter |
Description |
Default value |
||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Save parameters |
||||||||||||||||||||||||||||||||||||||||||
Save face sample |
If enabled, images are saved unconditionally in the database. For selective saving, you must specify: “Save if”:
— “Save face image in cases where a face was found”:
— Face sample storage time—specifies the lifetime of objects, after which the samples will be deleted. Possible values:
|
On |
||||||||||||||||||||||||||||||||||||||||
Save body sample |
Saving the event without creating a face in the LUNA PLATFORM 5 database. If enabled, images are saved unconditionally in the database. For selective saving, you must specify: “Save if”:
— “Save body image in cases where a body was found”:
— Body sample storage time—specifies the lifetime of objects, after which the samples will be deleted. Possible values:
|
On |
||||||||||||||||||||||||||||||||||||||||
Save face attributes in database |
Saving face attributes in the LUNA PLATFORM 5 database. If enabled, the unconditional saving of face attributes in the database is performed. For selective saving, specify the parameters (for more information see description of “Save face sample ” parameter). — “FaceAttributes storage time”—indicates the time in seconds after which the descriptor will be deleted from the database |
Off - |
||||||||||||||||||||||||||||||||||||||||
Save original image in database |
|
|||||||||||||||||||||||||||||||||||||||||
Save face in database |
Saving the face detected in the image in the LUNA PLATFORM 5 database with the creation of a face in the database. Saving is possible only when the option “Save descriptor in database” is enabled. If enabled, the unconditional saving of the descriptor in the database is performed For selective saving, specify the parameters (for more information see description of “Save face sample ” parameter) — "Attach face to list"—adds the saved face to the control list or lists in LUNA PLATFORM 5. Possible only if the option “Save descriptor in the database” is enabled. For selective saving, specify the parameters (for more information see description of “Save face sample ” parameter) |
Off Off |
||||||||||||||||||||||||||||||||||||||||
Save event in database |
Saving the detection/identification event in the LUNA PLATFORM 5 database. If enabled, all events are stored unconditionally in the database. For selective saving,specify the parameters (for more information see description of “Save face sample ” parameter) |
On |
||||||||||||||||||||||||||||||||||||||||
Receive and display an event in the “Last events” section |
Displaying an event in the “Last events” section. For selective displaying of events, specify the parameters (for more information see description of “Save image in database” parameter) |
On |
Table 17. Parameters of the policy editing form: tagging parameters
Parameter |
Description |
---|---|
Tagging parameters |
|
Tag name |
Assigning a tag of the given name when conditions are met. In the absence of parameter specifications, the assignment is unconditional. |
Save if |
“Gender”—the gender of the face in the image matches the specified; “Age category”—the age of the face in the image matches the specified limits; “Liveness”—specifies Liveness state (Spoof, Real or Unknown); “Deepfake”—specifies Deepfake check (Fake or Real) |
Add a tag for each case where a face was found |
“Labels”—the list of labels, specifies the names of labels; “With precision”—the lower and/or upper limit of the satisfaction of the comparison result with the parameters specified in the comparison (from 0 to 1) |
Table 18. Parameters of the policy editing form: callbacks
Callbacks allows you to send generated events (notifications) to the third-party system at the specified URL. A mechanism for notifications is based on the principles of HTTP webhooks. They provide asynchronous interaction between systems, allowing external services to react to the emergence of events.
Parameter |
Description |
Default value |
---|---|---|
Add callback |
||
Type |
Protocol type when creating a notification |
HTTP |
URL |
Address of the external system where the notification will be sent |
- |
Authorization type |
Selecting the type of authorization into an external system and setting up authorization data. The basic type of authorization requires specifying login and password to enter an external system |
Basic |
Timeout (seconds) |
Maximum time to wait for a request to complete |
60 |
Request body format |
Data interchange format: JSON or MessagePack |
application/json |
HTTP Headers |
HTTP Request Headers |
- |
Call only in cases where |
Conditions for sending notification Activated when determination of basic attributes (gender, age) is enabled, see the Table 9 — Gender:
— Age category:
Activated when Liveness check is enabled, see the Table 10 — Liveness:
Activated when Deepfake check is enabled, see the Table 11 — Deepfake:
|
|
Call only in cases where a person or body has been found |
|
Adding a label#
To create a label, click on in policy editing form (Figure 35).
If you need to identify faces among other faces in the label, then select “Faces” for “Identify among” field in the window for the parameter adding (Figure 36). If you need to identify among events, select “Events” for “Identify among” field (Figure 37).
Fill in all the required parameters and click on the “Add” button at the bottom of the form.
Label editing#
Editing of the label is performed by clicking on the button in the line with the label name.
A general view of the form for editing the label is shown below (Figure 38).
Edit the parameter values and click on the “Change” button.
Label deleting#
Deletion of the label is performed by clicking on the button in the line with the label name.
Tag adding#
To create a tag, click on in policy editing form (Figure 39).
A general view of the form for creating a tag is shown below (Figure 40).
Fill in all the required parameters and click on the “Add” button at the bottom of the form.
Tag editing#
Tag editing is performed by clicking on the button in the line with the tag name.
A general view of the tag editing form is shown below (Figure 41).
Edit the values of the tag parameters and click on the “Change” button.
Tag deleting#
Deletion of the tag is performed by clicking on the button in the line with the tag name.
After finishing editing the policy, click on the “Save” button in the upper right corner (Figure 38).
Dynamic policy editing#
To edit a dynamic policy, first click on the button on the page with a list of policies (1 in Figure 32. Then in the editing form change the name of the policy and click “Save” (Figure 42).
Policy deleting#
Deleting a policy is performed by clicking on the button in the line (2 in the Figure 32).
Confirm the action in the pop-up window—click on the “Delete” button or cancel the action by clicking on the “Cancel” button (Figure 43). After successful deletion, a notification will appear.