U-Filter User's Guide

U-Filter by Ultinous filters alarms using image-based AI filtering, eliminating false alarms. This guide will walk you through the steps necessary for setting up image filtering via the U-Filter web interface.

Required steps

Setting up a working U-Filter environment involves the following steps:

1. U-Filter is installed and has an active license.
2. Configure Sites and Channels, described below.
3. Create and assign users to Sites.
4. Setup and associate your cameras with U-Filter.

Your company should already have provided you with an account approved by Ultinous. Login to the U-Filter web interface to begin the configuration process.

To learn more about receiving an account approved for U-Filter, contact sales@ultinous.com.

Configure Sites

Every stream handled by U-Filter is grouped by a Site, representing their physical location. The following section describes how to create one - repeat these steps for each Site you would like to create.

1. Click the Add New Site button in the upper left corner of the screen.

2. Fill in the following fields with the data provided by your organisation.

• Name: The name identifying your Site.
• Unique ID: The unique technical name of the Site, used to identify your site in integration and third party services. Must be unique across all Sites. Must not contain special characters. An ID is generated by default (can be modified, cannot be changed once saved).
• SMTP Password: The password used to authenticate U-Filter when configuring your cameras.
• Event cooldown (in seconds): The minimum amount of time that has to pass between analysis periods. No e-mails will be sent during this timeframe. 60 seconds by default.
• Overload cooldown (in seconds): In case the U-Filter server gets overloaded with requests, this parameter controls how many seconds has to pass until new ones get accepted from the channel that caused the overload. Requests from other channels are unaffected. 60 seconds by default.
• Event time offset (optional, in seconds): The amount of seconds to be added to the event timestamp included in every e-mail and integration (such as to the timestamp value in HTTP integration). Type a negative value if you wish to subtract the given amount instead.

SMTP or CSM Software

• Integration: Select the type of service you would like to use U-Filter with. E-mail is selected by default.
• Target address: The target address to which you would like to receive images filtered by U-Filter. Type a valid e-mail address associated with the service chosen above.

NOTE: In case you would like to use U-Filter in conjunction with a third-party service, select the service from the drop-down menu of Integration, above. Then type the e-mail address provided by the service into the Target address field.

• Attach snapshot image: Tick this box to send a snapshot image of the incident attached to the e-mail containing the event data, in .jpg format.
• Use custom SMTP settings (optional): Tick this button to overwrite your global SMTP configuration set in the Admin Panel or setup a new one (only applies to the current site).

Click Save or proceed with configuring event sending via HTTP.

HTTP Webhook (optional):

Enables / disables event sending via HTTP. Use this feature to send triggered events to a third-party software with an optional snapshot image of the incident attached. Sends a HTTP POST request to the URL set below, with a content type of application/json. See the U-Filter HTTP section of the guide for message schema.

• Target URL: The location of the API.
• Header keys and values: Keys and values of custom HTTP headers. Click the Add button to add more Keys. To delete a Key, press the Trash icon next to it.
• Send snapshot image: Off by default. If enabled, it fills in the img_url field of the HTTP message schema in base64 encoded format.

To test the HTTP Webhook, click the Send Test Event button once the Site is created.

Configure Channels

Once your Site is created, Channels can be registered, corresponding to your camera streams.

1. Click the row of the Site you would like to add a Channel to.
2. Click the Add New Channel button in the upper left corner of the screen.

• Name: The name identifying your Channel.
• External ID (optional): You may define a custom ID value here, in case an external or third-party solution requires one to identify this channel with.
• Unique ID: The technical name of the Channel, used to identify it in integration and third party services. Must be unique across all Sites. Must not contain special characters. An ID is generated by default (can be modified).
• GPS Latitude (optional): The GPS latitude coordinates of your Channel.
• GPS Longitude (optional): The GPS longitude coordinates of your Channel.

3. Choose any combination of objects you would like to filter. Select their sensitvity ranging from VERY LOW to VERY HIGH or turn their detection OFF. Lowering the sensitivity causes less false detections but decreases accuracy. Increasing it results in more detections but may include more false detections as well.
4. Click Save, then click Back.
5. Your Channel has appeared in the list of Channels of your Site. Click the ℹ️ button in the right-most column of your Channel.
6. The following popup will appear:

Use the information here to help you configure your camera's SMTP settings:

• SMTP server: The SMTP address generated for the U-Filter Site.
• User Name: The SMTP username for this Site, generated from the corresponding Site technical name and the account's technical names.
• Password: The password set for this Site. To change it, edit the Site by clicking Configure next to the Site name. Click the Generate New Password button. Click OK on the popup, then click Save.

For custom SMTP server settings in U-Filter, contact your system administrator for configuration.

7. You can test your settings by clicking the Upload button in the button row to the right of the Channel in question.

8. Click the Select Image button to select an image file in .jpg format (other formats are not supported) to apply the chosen types of analytics. Click Upload. Tick the Save image on the server box if you would like to re-use the image later (e.g. for drawing areas, see below).
9. All done! You can either click Save and proceed to configuring your cameras, or configure U-Filter with additional filtering tools, described below.

Note that the maximum size of the image that can be sent via e-mail or HTTP input is 3840x3840 pixels. JPG is the only supported image format.

Additional filters

In order to further enhance or tweak detection accuracy, additional filters may be applied to images sent to U-Filter.

1. Open the Channels page of your Site. Click the Configure button under the Detections column of your Channel.
2. Scroll down to Additional Filters.
3. Select an image to upload from your device: since this image will be used as a canvas on which ROI will be drawn or size filters can be applied, an image extracted from your camera feed would be ideal.

This image can be stored on the server by ticking the checkbox (selected by default), removing the need to reupload the image every time a change in ROI or size filters is desired. There are multiple ways to extract an image from your camera feed - for example by using a tool such as ffmpeg. You can use the command below to generate an image.

ffmpeg -i <rtsp_URL_of_your_camera> -vframes 1 output_image.jpg

4. Draw Areas: click this button to designate one or more regions of interest (ROI). Read below to learn more about drawing ROI.
5. Set Object Size: click this button to adjust the minimum or maximum object size to be detected. Read below to learn more about setting custom size ranges.
6. You may click the Delete Image button to remove the uploaded image from the server, or click Select Image then Upload again to replace the uploaded image with a different one.

Make sure to adjust or reset your ROI and size filter settings if you replace your initial image with a different one.

Draw ROI (Region of Interest)

You can draw annotations on top of the scene observed by the camera to specify what areas (regions of interest) to include or exclude from filtering.

1. Click the Draw Areas button to open the Ultinous Camera Editor and begin drawing areas. You can drawn multiple areas.
2. To remove all areas, click the Remove Areas button.

Read the Camera Editor guide for detailed instructions on drawing regions of interest.

Set detection size filter (optional)

If you have a good idea of what pixel range the detected objects would fall into, you can customise the minimum and maximum height size of detections, in pixels, here. This would ensure that only objects that fit into that range would get detected, resulting in a further decrease in the number of false detections.

NOTE: Take care that any object below or above the set range will NOT be detected, possibly resulting in missing incidents. It is good practice to set the minimum size slightly below, and the maximum size slightly above the desired amount.

1. Click the Set Object Size button.

2. Move the the arrows by clicking and dragging them to help you determine the optimal values. Adjust the slider's endpoints on the bottom part of the screen to set the minimum / maximum values.
3. Click Set sizes to save your changes, or Discard to cancel them.

Note that if you upload an image with different dimensions than the one already uploadeded, ROI and detection size filters will have to be adjusted for the new image dimensions.

Edit Site

1. Click Configure in the Actions column of the Site.

2. Modify the settings to your liking, then click Save. To remove the Site, click Delete Site.

Note that SMTP data and the Site technical name can not be modified once the Site is created.

Edit Channel

1. On the Sites screen, click the Configure button on the right of the Site containing the channel in question.

2. Click the View Channels button at the Site's header.

3. On the list of channels, click the Configure button on the right side of the row of the Channel in question.

3. Modify the settings to your liking, then click Save.

The Unique ID and Target e-mail address can not be modified as they are generated automatically.