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 operator mode is affected by the current settings on this page. See here for information about the different modes.
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.
- Report Action Events Only: Only events that are of the action type will be reported.
- 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.
- Min Masked Event Portion: Indicates the portion of the qualifying mask detection samples during the event that are needed to indicate the presence of a mask for mask presence to be attributed to an event.
- 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.
- 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. When enabled, the Mobile Client will generate auto-replies without first communicating with the SAFR Server. This can reduce the Mobile Client's response, which can be useful when testing.
- 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.
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.
Enables removing of identities according to the preferences selected within this section.
- Remove identities: It's Enabled if either anonymous or non-anonymous identities are configured to be removed. Click the Change… button to configure the identity 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.
Sets up biometric indexing on events. Biometric indexing is required to allow event searching by image on the Web Console's Events Page or the Desktop Client's Search by Image Window.
This setting is only visible to users with CONFIG_PRIVILEGE or SUPER_CONFIG_PRIVILEGE privilege levels. See Manage Users Preferences for information about user privilege levels.
- Enable biometric event indexing: Enables event biometric indexing.
- Directory to index: The name of the user directory whose event archive you want to biometrically index.
- Indexing speed: The speed at which the event can be located when "search by image" is executed. Faster indexing speeds can lower system performance.
- Immediately index new events: Specifies if events should be biometrically indexed as soon as they're created. Enabling this option can affect your system performance when events are created.
- Only index events occurred after specific date: When enabled, specifies the date after which events should be biometrically indexed. If this checkbox isn't checked, then all the events in the event archive are indexed.