Events Preferences
The Events Preferences tab allows you to enable and configure event reporting and event replies. Every reported event contains start and end times as well as information about where it occurred and who or what triggered it. The location of the event is indicated by the site and source labels, which can be defined for each camera. Events are stored in the Event Archive and can be easily retrieved in real time or on demand for search and analytics. Events are reported promptly as they occur and when they end. Events are updated as a better understanding of what they represent becomes available.
- For Mode: Specifies which video processing mode is affected by the current settings on this page. See here for information about the different modes.
Report Events
Enables event reporting. Event reporting enables SAFR to log and track events over time and gain additional insight into your SAFR system and usage patterns.
- Include Unrecognizable Events from Camera: Enable this option to report the appearance of unrecognized people captured by camera feeds. Unrecognized people are people that the SAFR system can’t see well enough to compare it to its People Directory.
- Include Unrecognizable Events from Video: Enable this option to report the appearance of unidentified individuals captured in video files imported into SAFR. Unrecognized people are people that the SAFR system can’t see well enough to compare it to its People Directory.
- Include Stranger Events: Enable this option to report when cameras see strangers. Strangers are people who the SAFR system can see well enough to compare him/her to individuals stored in its People Directory, and there isn’t a match.
- Min Age: The minimum age of strangers that will trigger stranger events. If a stranger younger than the specified minimum age is detected, no stranger event is generated.
- Max Age: The maximum age of strangers that will trigger stranger events. If a stranger older than the specified maximum age is detected, no stranger event is generated.
- Only if occluded: When enabled stranger events are only reported when the stranger is occluded. This can be useful if you want to catch people who are attempting to bypass your security system by intentionally occluding their faces.
- Include Speculated Identity Events: Enables reporting events for speculated people. A “Speculated Identity” is a face that isn’t a 100% match with a face in the Person Directory, but is close.
- Include Secondary Events: When enabled, face events that are tied to a person event will be included. Enabling secondary events often produces undesired “noise”, so it is turned off by default. See Face Detection-Person Detection Tie-In for information about secondary events.
- Preserve Event Face Image: Select this check box if you want the images that trigger an event to be saved with the event report.
- Max Image Size: The maximum size of the event face images, in pixels.
- Image Margin: Windows only. Specifies how much extra space around the face to include in the event face image.
- Image Format: macOS only. Choose whether you want the event face image saved as a JPG or a PNG.
- Preserve Event Scene Thumbnail Image: Select this option if you want a thumbnail of the scene image in which the event occurred to be saved with the event report.
- Max Image Size: The maximum size of the event scene thumbnail images, in pixels.
- Image Format: macOS only. Choose whether you want the event scene thumbnail image saved as a JPG or a PNG.
- Include Unrecognizable Event Images: Specifies if event images should be stored for events triggered by unrecognizable people.
- Include Stranger Event Images: Specifies if event images should be stored for events triggered by people who aren’t registered in your Identity Database.
- Reporting delay: The number of seconds an event report is delayed in order to properly assess the nature of the event. For example, a person who may at first seem unknown may become known after a second observation.
- Min Identified Event Duration: The minimum duration required for an event representing a known person to be recorded as an event.
This setting helps filter out noise or brief appearances that may not be worth reporting as a system event.
If this setting and Reporting Delay have different settings, the greater number is used.
- Min Unrecognizable Event Duration: The minimum duration of an event representing an unrecognizeable person to be recorded as an event.
If this setting and Reporting Delay have different settings, the greater number is used.
- Min Stranger Event Duration: The minimum duration of an event representing a stranger to be recorded as an event.
If this setting and Reporting Delay have different settings, the greater number is used.
- Update in-progress event attributes: If this is enabled then any event properties that change will be updated at the specified interval. Many properties do change periodically, such as images or other averages that are continually computed.
- Update interval: Specifies the interval time in which to update event properties that change.
- Include qualified images with updates: Windows only. When enabled, SAFR will include qualified images with in-progress event attribute updates. These qualified images will be included even if they’re lower quality than earlier images.
- Update with higher quality image: Update the thumbnail images with higher quality images during the course of the event if possible.
Listen for Event Replies
- Display Reply Message: Enables SAFR to display reply messages on the screen.
- Display until end of event: When enabled, the event reply is continuously displayed until the event ends. When this isn’t enabled, the event reply is only shown for a couple seconds.
- Generate auto-replies: macOS only. Internal use only. Do not enable this setting.
- Positive Reply: Allows you to configure positive replies.
- Sound: Specifies which sound, if any, is played when a positive event occurs.
- Voice: Specifies which voice, if any, will be used.
- Overlay image: Windows only. The image to be displayed while a positive reply is being displayed. If no image has been uploaded, then the live view of the video feed will be shown.
- Text Color: Windows only. Specifies the text color of the reply.
- Background: macOS only. The background image to be displayed while a positive reply is being displayed. If no image has been uploaded, then the live view of the video feed is used as the background.
- Neutral Reply: Allows you to configure neutral replies.
- Sound: Specifies which sound, if any, is played when a neutral event occurs.
- Voice: Specifies which voice, if any, will be used.
- Overlay image: Windows only. The image to be displayed while a neutral reply is being displayed. If no image has been uploaded, then the live view of the video feed will be shown.
- Text Color: Windows only. Specifies the text color of the reply.
- Background: macOS only. The background image to be displayed while a neutral reply is being displayed. If no image has been uploaded, then the live view of the video feed is used as the background.
- Negative Reply: Allows you to configure negative replies.
- Sound: Specifies which sound, if any, is played when a negative event occurs.
- Voice: Specifies which voice, if any, will be used.
- Overlay image: Windows only. The image to be displayed while a negative reply is being displayed. If no image has been uploaded, then the live view of the video feed will be shown.
- Text Color: Windows only. Specifies the text color of the reply.
- Background: macOS only. The background image to be displayed while a negative reply is being displayed. If no image has been uploaded, then the live view of the video feed is used as the background.
- Reaction Delay: Delays the event reporting to the server by this amount in seconds.
Remove events
Enables removing of events according to the preferences selected within this section.
- Remove events: It’s Enabled if either anonymous or non-anonymous events are configured to be removed. Click the Change… button to configure the event removal.
- Remove Anonymous Events after: Determines how many days to wait before removing events triggered by people without a name attribute in the Person Directory. If this value is set to zero, then anonymous events won’t be automatically removed.
- Remove Known Identity Events after: Determines how many days to wait before removing non-anonymous events. If this value is set to zero, then non-anonymous events won’t be automatically removed.
- Remove identities: It’s Enabled if either anonymous or non-anonymous events are configured to be removed. Click the Change… button to configure the event removal.
- Target Directory: Determines the directory whose identities are to be automatically removed.
- Remove Anonymous Identities after: Determines how many days to wait before identities that don’t have a name attribute. If this value is set to zero, then anonymous identities won’t be automatically removed.
- Remove Identities of person type: Select the Person Type of the identities you’d like removed. If you don’t modify this field, then identities of all Person Types will be removed.
- after: Determines how many days to wait before removing identities of the specified Person Type. If this value is set to zero, then identities with Person Types won’t be automatically removed.
See Also