Objects of Face Machine Server
Sample
A Sample is an object that stores the image of a person's face and/or a corresponding Biometric template that is used for face recognition. The list of Samples can be the attribute of a Person Profile or an Event.
Person Profile
A Person Profile can be considered as a person added to the database. When you create a Person Profile, you can specify any text information about a person, such as his/her name, age, etc. in personInfo
. In addition, you can add face images, which are stored in Samples, to the Person Profile. You can add several images for one person in the database, in this case his/her Person Profile will contain several samples. A Person Profile can have the Main Sample, which is displayed in the Person Profile view of the web interface.
Profile Group (List)
You can put several Person Profiles into a Profile Group (List). Profile Groups allow you to segment the database and identify people in different places using the different segments. For example, your company has two checkpoints. People from the group A have access only to the checkpoint A, and people from the group B have access only to the checkpoint B. In this case, you can give the device from the checkpoint A access to one part of the database, and give the device from the checkpoint B access to another part of this database. As a result, only a segment will be used for the search instead of the whole database.
Edge Device
An Edge Device is an entity that can generate Events and has read-only access to Person Profiles from available groups. An Edge Device token allows Edge Devices to connect to FMS for database updating on the device local storage (only the Lists linked to this device are downloaded, see Creating Edge Devices in the Getting Started section) and sending Events generated on the side of the Edge Device to FMS for logging.
An Edge Device is authorized using the device token. The Edge Device token is automatically generated by the server and assigned to the Edge Device when it's created.
An Edge Device doesn't always correspond to a physical device. For example, it's possible to login using the same token from several instances of one application.
Event
An Event is automatically generated by an Edge Device when processing video streams. Events are generated, for example, in case of detection or identification of a face.
Each Event contains information about the Edge Device from which it was sent (device id
) and also date and time of the Event generation. Besides, an Event can store the face image (for example, in case of successful identification).