Face mask detection
SmartFace also extracts information if a detected person wears a face mask and also provides the information, if the face mask is worn properly. The information is provided in three attributes – FaceMaskConfidence, NoseTipConfidence and the calculated enumeration FaceMaskStatus.
Face mask attributes
FaceMaskConfidence – The confidence that a mask is present. It is a decimal number in the range [-10 000 to 10 000]. A higher number represents a higher confidence that the mask is present.
NoseTipConfidence – The attribute determines if the face mask is worn properly, i.e. that the nose is completely covered. It is s a decimal number in the range [0 to 10 000]. A higher number represents more confidence that the nose tip is visible.
FaceMaskStatus – The enumeration determines if the mask is present on the face. The enumeration has the values Mask, NoMask or Unknown. It is calculated from the FaceMaskConfidence attribute using the FaceMaskThreshold property of FaceMaskConfidenceConfig.
The attributes are extracted from face along with the age and gender attributes.
Availability
The face mask detection attributes are available on Face and MatchResult entities in:
ZeroMQ notifications
OData API
Rest API
Face mask detection attributes along with the filtering ability are also available in Access Controller.
See the
Access Controller explained
documentation for more information.
Limitations
Currently, the face mask detection is not available for the fast detection option.
The face mask detection is also not available for all faces created before face mask detection was implemented in SmartFace. For these faces FaceMaskConfidence and NoseTipConfidence will have the value null and FaceMaskStatus will be Unknown.