User Tools

Site Tools


terra4d:saimos

Saimos Facial Recognition

TERRA 4D comes with a plugin to handle Saimos face recognition.

General Configuration hints:

  • After installing Saimos, connect with a browser to the Saimos server. The server can only be configured via the Website. Normally, the Port 44444 on the server is intended for this purpose.
  • It is better to add the first node by detecting it, not by adding it manually. If the manual configuration fails, you get some strange issues like no faces in the Facial Log.

Camera Configuration hints:

Camera from RTSP stream

  • See the settings for a Hikvision camera here:

  • If artifacts appear in the video, you can try setting “RTSP Transport” to “TCP”.

Camera from Video File

  • Copy the video file and a snapshot jpg to the server
  • Set up a file camera

Improving facial detection and identifying

  • Arrange the camera so that the face is captured head on.
  • For good recognition, 350 px/m on target is the absolute minimum. For a proper detection, Saimos will need at least 24 px on the face. Detection of non-frontal faces is possible with the FuST cascade but it will not deliver the same results as for frontal faces. So for a proper detection of faces that are non-frontal the resolution should be higher than the minimum.
  • To get good identifications, use frontal faces to store in the personla database.

Important settings for facial detection

You can find these setting in “Face detection” of a channel.

  • Face Size: You have to set the minimum and maximum size of a face. Use the rectangles to modify this so that if fits to your channel. The position is not important.
  • Scale Threshold: Decrease this value to get more face detections. But be reserved, even a little smaller value can provide a lot more faces. A too low value quickly leads to error detections. As a first attempt, try to set the value from 2 to 1.5.
  • Min. Similarity: This value determines how safe a face is found in the person database. To achieve more identifications, reduce the value. But again: Be reserved, a value too low quickly leads to misidentified individuals. As a first attempt, 40 instead of 50 would be recommended.

Person Database hints:

Follow these steps to assign uploaded images e.g. from your ID card to a person in the database:

  • Select “Image Upload” from “facevis” menu
  • Click on “Upload” and select the image
  • As soon as “Completed” is reported, switch to the “Face Log”.
  • If you cannot see the image, click on the magnifying glass on the left and select the image (or images) in “Source / Image” and press “Apply”.
  • Now you can assign the picture to a person as usual.

If this does not work, check the following:

  • What is the status of the uploaded images in the “Image Upload” display – “Pending” or “Completed”?
  • If it says “Completed”, the images have been processed, but if the face log does not show any faces, it may mean that:
    • either the Saimos analysis didn't find any faces in uploaded images; this can happen if the faces are too small in the image (< 40 pixel)
    • or that the faces have been filtered out by the face log filter settings ⇒ check filter settings
  • If the status is still “pending”, this most likely means that the license does not contain faceservice channels ⇒ check license info (menu Help→License)
terra4d/saimos.txt · Last modified: 2020/01/22 13:01 by editor