Skip to content

LUNA PLATFORM v.5.18.0#

Changes

  • A new resource "/iso" was added to the API and Handlers services. The resource checks the face image for compliance with the requirements of the ISO/IEC 19794-5 standard. The response of the resource returns a verdict for each check (1 — the image corresponds to the standard, 0 — the value obtained does not correspond to the standard) and a general verdict based on all the checks performed. The total verdict is 1 if the image has successfully passed all the checks.

For each check, the received value and the threshold/value with which the comparison is performed are returned. The thresholds are set in the system by the requirements of the ISO/IEC 19794-5 standard and are not changed by the user.

Response example:

```
{
 "name": "head_roll",
 "object_value": 5.434040069580078,
 "threshold_value": {
   "min": -8,
  "max": 8
 },
"result": 1
},
```

The following checks are now available:

* Quality of the image: contrast and saturation (insufficient or too large exposure), blurring, specularity, uniformity of illumination.
* Mouth state (opened, closed, occluded).
* Glasses state (no glasses, glasses, sunglasses).
* Eyes state (for each eye: opened, closed, occluded).
* Gaze.
* Head rotation angles (pitch, yaw and roll angles).
* Position of the face central point in the image horizontally and vertically.
* Vertical and horizontal head size relative to the image size.
* Distance between the centers of the eyes.
* Image formats.

The requirements can be found on the official website: [https://www.iso.org/obp/ui/#iso:std:iso-iec:19794:-5:en](https://www.iso.org/obp/ui/#iso:std:iso-iec:19794:-5:en).

In the request, you can additionally enable the extraction of EXIF data of the image.

By default, checks are performed for images that have one face present. You can enable estimation for multiple faces in the image using the "multiface_policy" parameter. For each of the found faces, the estimates and coordinates of the found face will be returned. It should be noted that many ISO checks assume the presence of one person in the frame, so not all checks for multiple faces will be performed successfully.

The order of the returned responses after processing corresponds to the order of the transferred images.

If one or more of the images transferred in the request is damaged, an error will be returned. The rest of the images in the request will be processed as usual.

This functionality is licensed separately. If there is no ISO option in the license, an error will be returned when using the "/iso" resource.

For more information, see the "Image checking according to ISO/IEC 19794-5" section in the administrator manual and the OpenAPI documentation.

  • Removed were the "profile" and "limitations-file" options for the "db_create.py" script. The "profile" option was used to fill the Configurator service database with settings based on the default profile. The "limitations-file" option was used to load settings templates from a file.

    Now it is recommended to use the "db_create.py" command to create an empty database without additional parameters, then load the necessary settings from the file using the "dump-file" flag or migrate the settings with the "python3.9 -m configs.migrate --config /srv/luna_configurator/configs/config.conf --profile platform head" command.

  • The vendor's library for the HASP key "haspvlib_x86_64_111186.so" was added to the distribution package and in the documentation.