External Services
External services in Macula are, primarily, LPR (License Plate Recognition) and FR (Face Recognition) modules, as well as any system-specific third-party modules that have been integrated with Macula via HTTP API. If additional external services have been enabled and set up for your server(s), these will allow you to receive live event streams for the corresponding channels and also to investigate the recorded event data together with the video streams.
Live
If recognition is running for a specific channel, you can see the recognition results by opening the Notification Pane for each individual channel. The pane can be toggled using the viewport overlay controls, and its availability can be set up via Application Settings.
The list of the live results is cleared when you close the Macula Monitor application meaning that each time Macula Monitor starts with an empty notification pane and it gets filled as the recognition results arrive. The notification state (ON/OFF) is saved with the layout, local or shared.
If your target channel is recorded, you can double-click any entry to see the moment of the recognition played back automatically in the same viewport using the instant playback. The recording status is showed by the overlay icon in the bottom-left corner of the viewport (yellow = recording ON, white = OFF).
Playback
The channels used by external services can be played back just in the same manner as regular channels.
For systems that have FR service(s) connected, an additional control will appear in the bottom right corner, below the timeline. The Mysterious face 
icon will allow you to switch to the FR investigation mode using the current frame. If the target frame contains a face, you can then highlight it and form a search request as described below. Note that you will still have to specify the channel(s) to be searched in the Resources pane on the left, as the image may be coming from a non-FR channel.
Investigation
For every external service type, a corresponding tab appears on the topmost panel of Macula Monitor. Click your desired tab to proceed with the investigation.
In order to start searching for the recognition results, you need to specify the target channels first. To do this, click the “+” next to the channel, service group or server name in the Resources pane; you can add multiple channels from different external service groups. Use the “-” next to the channel, group or server name to deselect and exclude it from the search.
Next, enter your keywords in the search field. For license plate recognition, you can enter either the whole plate number or a part of it - with or without an asterisk (*) as a wildcard.
For face recognition, the following search adjustments are available:
upload a photo and draw a region to contain a face to search for (or switch from Playback, as described above)
specify search accuracy (higher accuracy is recommended for better results)
enter the person's name or a part of the name if you know it is present in the FR database
use tags and attributes to refine the search
Attribute search can be performed in two modes:
OR: use commas or spaces between attributes to include results that have ANY of the listed attributes
AND: use + between attributes to display results that have ALL attributes
For example, in LPR search, entering "red Ford" will display all red cars and Fords of any colour, while searching for "red+Ford" will only output red Ford entries.
Specify the target date and time range: the date can be either entered manually from the keyboard or selected using the calendar control; the time can be also either entered manually or adjusted using your mouse wheel after clicking the digits and holding your mouse cursor over the time element.
After that, click the Search button to view the results. Please note that, depending on the selected time range and number of channels, the search may take some time; the results will be listed in the bottom-right-hand area after they have been found. Do not press the Search button repeatedly: this will re-initiate the search process.
Double-click any specific search result and it will be opened in the central viewing area. The default view grid is 5x5, you can change it by selecting an appropriate grid size below. 1x1 grid corresponds to the instant playback mode. Click any result in the grid to see the recognition moment (plus some seconds before and after) played back on loop.
The instant playback here has some standard Macula Monitor controls and also an option to switch to the regular playback mode.
Use the semi-transparent Play viewport overlay control in the centre of the picture to play faster, slower or pause the playback: simply drag the arrow to the left/right/centre position
Timestamp in the upper-right-hand corner of the picture shows server time
The small Play icon in the bottom-right-hand corner will take you to the Playback mode
The Clock overlay control allows you to go to any particular moment in time in the same playback window
The Flag icon will open the Add new bookmark dialog box, allowing you to add a bookmark to this specific moment
Pressing the Camera icon will export a snapshot
Pressing the Video clip icon will automatically export the piece of video, which is currently being played
The timeline contains the recognition related time interval but you can also adjust the boundaries by clicking and dragging the arrows on the left and right sides of the timeline (minimal interval is ten seconds)
You can switch to other tabs while investigating and you can return to the exact place where you left off by switching back to the External Service tab, provided that you do not close the Macula Monitor application. If you do, all your search results will be discarded.
Found data can be saved into a CSV file (comma-separated values) that can be later parsed or opened with MS Excel-like applications. To do this, simply click the Export CSV... button below the search result list and specify your desired file name and path. You can also save the report into PDF or XLS format; for this, simply click the desired option and the report will be immediately saved and reflected in the Library tab (if your application settings have the dialog box enabled in the Library tab, you will have the dialog pop up, too).
Reports
This functionality is limited to GSF own Facial Recognition (FR) service only.
Similarly, to counter-based reports, you can build reports using data provided by FR. The chart basis is miscellaneous attributes (estimations) received from FR with the recognition events: age, gender, sentiment, etc.
Click the Reports button in the upper right corner (below the main menu, next to the Search button; the two buttons only appear for FR service). If the button does not appear, please upgrade your FR service to the latest release. The interface and logic here are analogous to that of regular reports.
First, select the target channel(s) in the Resources panel on the left by clicking the plus button next to them (selected channels are highlighted). Then, specify the reporting criteria in the right-hand panel, which is divided into several sections.
There are three chart types: bar, line and pie diagram. Regardless of the chosen type, all reports have configurable report interval and filters. For each report, you can use multiple attributes as filters in addition to the time intervals. Any report can be also exported as PDF or CSV.
Appearance:
Bar, line, or pie type visualization
Group by: choose the report target by selecting one of the available attributes (age, gender, tag, sentiment, temperature)
Aggregate by: select the minimum time interval to be used for value grouping in the report - results can be presented for months, weeks, days, hours or minutes (but reasonably, so minutes will not be available if your report period is, say, one month)
Choose if you want the sum of the values and labels for each entity to be added to the graph
Report time interval:
Choose the start and end date and time for the target report
Report filters:
Tags from FR
Temperature readings that were received by FR (works for certain camera integrations; please refer to us for the exact vendor list)
Age, gender, and sentiment estimators
Week days: select days of the week that you want to be included in the report (e.g., ignore weekends) (all days are selected by default)
Day time interval: choose the target audit interval to be analysed for each of the selected days
Click on the items in the filter list to (de)select them: the deselected items will be struck through and greyed out.
All values are relative, i.e., represent the aggregated changes in the value for the given time interval compared to the previous one.
The tag Known comprises detections with any custom tag PLUS all detections of tagless subjects from the database. This poses two important points:
There is no separate category for the "tagless" detections; thus, if you want reports on those people, create tags (e.g., use the "default" tag for them).
The filter logic works as follows:
For the Sum values mode: if at least one tag is selected, Known is deselected.
Reports without sum: if at least one tag is deselected, Known is deselected.
When ready, hit the Make report button in the bottom of the right-hand panel to display the diagram based on your selected criteria. The required time depends on the selected report interval and your connection type, and may take up to several minutes.
Click the Export report... button to save the report in PDF or CSV format.
Last updated