This feature is not available on all camera models.
MxAnalytics allows tracking objects that move about in the image and to collect statistical information about these objects. To do so, the camera records the distribution of the objects and can present the results as a heatmap. In addition, you can define counting lines, which are counting the objects when crossing. These data are recorded in a reserved partition on a storage device that is directly attached to the camera. Note that the storage device needs to be partitioned accordingly when formatting the device in the Storage on External File Server / Flash Device dialog (see also MxAnalytics Data Storage on this page).
In order to use MxAnalytics, you need to configure this feature in the General MxAnalytics Settings dialog. After that, you can view the results in the MxAnalytics Overview dialog and export the data in different formats.
In order to get reliable results, you should make sure to avoid all external influences that may degrade the results of MxAnalytics. If this is not possible, the results may be inaccurate. The following influences are unfavorable and should be avoided:
MxAnalytics has been designed for cameras mounted to a ceiling. Depending on the lens used, the camera should be mounted no lower and no higher than shown in this table:
Lens | Minimum Height | Maximum Height |
---|---|---|
L11 (1.8 mm) | 2.5 m | 6 m |
L22 (4.0 mm) | 6 m | 10 m |
Configuring MxAnalytics in the General MxAnalytics Settings dialog follows these steps:
To view the results of MxAnalytics, open the MxAnalytics Overview dialog:
You can arm MxAnalytics permanently or use signal inputs and time table profiles to control the arming status.
Example:
In order to activate MxAnalytics only during the operating hours of a store, you need to create a Time Table Profile that matches the opening hours. Next, set the arming of MxAnalytics to Enabled and select the time table profile with the opening hours you just defined.
Hint: Using a time table profile to control the arming status of MxAnalytics reduces the storage space required and thus enlarges the time span covered by the collected data. This also improves the significance of the results, since objects outside of the analysis window are ignored and do not appear in the heatmap. For more information on the storage space, see Storage Requirements below.
This sections contains general settings for object recognition.
In order to limit the analysis of MxAnalytics to a specific area, you can define several windows or polygons in this field. The most convenient method to define such a window is to use a [Shift]-click, click to define a rectangle in the live image, then click on Add detection area (see also Graphically Entering Image Areas). Note that it is also possible to exclude specific areas from detection. The syntax for a definition line is as follows:
Rectangle syntax:
[!]image sensor, horizontal position, vertical position, width, height
(optional parameters have brackets)
Example: 0,0,0,1280,960
Polygon syntax:
[!]image sensor, poly=<hor. coordinate>x<vert. coordinate>/<hor. coordinate>x<vert. coordinate>/<hor. coordinate>x<vert. coordinate>{/<hor. coordinate>x<vert. coordinate}
(optional parameters have square brackets, parameters that can be used as often as needed have curly brackets)
Example: 0,poly=0x0/0x1280/960x1280/960x0
In order to exclude a specific area from detection, enter a "!" in front of the definition line.
Hint 1: Limiting the detection area increases performance and delivers better results. in addition, doing so reduces the storage space required and thus enlarges the time span covered by the collected data. For more information on the storage space, see Storage Requirements below.
Hint 2: Image areas with reflecting surfaces should be excluded from detection to prevent negative influences on the analysis results.
If you are activating the display of the detection area, the camera shows the detection areas (rectangles and polygons) as well as the bounding box (the polygon containing all detection areas in the camera image).
Enter the height in centimeters from the floor to the mounting position of the camera. The camera uses this information to properly display the results in the heatmap. When analyzing moving persons, the heatmap will be shown near the persons' feet.
Note: Mounting the camera at heights of less than 2 m/6 ft will reduce the accuracy of the analysis results.
Sets the tilt angle for this camera. If mounted to the ceiling, select –90°, if mounted to the wall, select 0°. The camera uses this information to properly display the results in the heatmap.
This parameter allows setting a minimum object size in pixels (smaller objects are ignored). The most convenient method is to use a [Shift]-click, click to define a rectangle in the live image, then click on Set minimum size (see also Graphically Entering Image Areas).
The camera provides three pre-defined settings to adapt the camera to the illumination profile at the location. In addition, you can select a custom setting to manually adjust the light and shadow settings of the camera.
Available Settings:
This parameter controls the sensitivity of the analysis. A higher value means that the software only recognizes objects that have a noticeable color difference to the background. A lower value means that the software also recognizes objects that are hard to recognize against the background.
The following settings for displaying objects in MxAnalytics are available:
A counting line is used to count objects that are crossing the line. Note that software also recognizes the direction of movement of these objects. Each line in the definition field represents one counting line. The definition of a counting line consists of its start and end points. The syntax of a counting line definition is as follows:
lens,x1,y1,x2,y2,id=<identification number>[,name=<string>][,west=<string>][,east=<string>]
(optional parameters have brackets)
Note: If the string contains a comma, you need to precede it with a backslash (\).
Example: 0,436,152,751,654,id=1,name=Ground Level Entrance\, left,west=In,east=Out
Parameter | Description |
---|---|
Image Sensor | Selects the image sensor (camera image) to use for this counting line definition:
|
x1 | The horizontal position of the start point. |
y1 | The vertical position of the start point. |
x2 | The horizontal position of the end point. |
y2 | The vertical position of the end point. |
id | The identification number (ID) of the line shown in the image. You can thus visually identify the line. |
name | The description of the line (e.g. "South Entrance") that will be shown in the report later on. (Optional parameter) |
west | The description of objects crossing the line to the left/west (e.g. "In") that will be shown in the report later on. (Optional parameter) |
east | The description of objects crossing the line to the right/east (e.g. "Out") that will be shown in the report later on. (Optional parameter) |
This parameter to set a time during which an object will not be counted any more once it has crossed the line. This setting can improve the precision of the analysis if object are staying close to the line an cross it several times.
The software provides the following settings to show the lines in the camera image:
Allows setting a color for the counters and the line IDs.
A heatmap shows the distribution of the objects, i.e., where objects are staying and how they move, as a colored heat image. The warmer the color, the more objects are staying at a specific location. When analyzing moving persons, the heatmap will be shown near the persons' feet.
If you want to always use the same image as a background for the heatmap, you can save a "reference image" in the camera. If no reference image has been saved or you deleted an existing reference image by clicking on Delete, the software uses the current live image of the camera as background.
Hint: You should save a reference image if no objects are visible in the live image. This avoids that objects are interfering with the display of the heatmap later on.
Shows the current heatmap on the live image of the camera. This feature is mainly aimed at quickly checking the configuration.
Caution: You should only briefly show the heatmap in the camera's live image, since this feature generates high CPU loads and results in reduced live image rates of the camera. Before closing the dialog, you should make sure that you deactivate the Show Heatmap checkbox and that you save the changes permanently by clicking on Set/Close at the bottom of the dialog.
Note: While you are displaying the heatmap in the camera image, the heatmap will also show on the recorded image (except when using the Full Image recording mode).
Open the MxAnalytics Overview dialog to define the reports that are to be generated by the camera:
This section of the dialog contains general information about the records that are available. The information covers the date/time of the first and last records as well as information on the storage space used and the total number of records. In addition, you can manually create a new record (Force new record) and reset MxAnalytics completely by deleting all records (Delete all records).
Notes:
Click on Show to get a heatmap based on the current data in a separate browser window. The heatmap contains the MxAnalytics results since the last reset of the data or since activating MxAnalytics (whichever is applicable).
This section contains a summary table of the defined counting lines, their descriptions and the current counter values.
Hint: You can use other programs to get the current counting line configuration and the current counter values using the following link: http://196.21.94.4/control/stat_export?function=counter
. The data are returned in JSON format.
This section contains a summary table of the defined counting line report profiles. If no report profiles have been defined yet, you can do so in the Counting Line Report Profiles dialog.
Hint: If you want the camera to automatically send a counting line report via e-mail, make sure that both status LEDs in the corresponding line (E-Mail Profile and Time Task) are green. If this is not the case, create a new e-mail profile and then use this profile in a new time tasks.
This section contains a summary table of the defined heatmap report profiles. If no report profiles have been defined yet, you can do so in the Heatmap Report Profiles dialog.
Hint: If you want the camera to automatically send a heatmap report via e-mail, make sure that both status LEDs in the corresponding line (E-Mail Profile and Time Task) are green.
A counting line is used to count objects that are crossing the line. Note that software also recognizes the direction of movement of these objects.
Open this dialog to define different reports (weekly/monthly), which can be used in other dialogs. You can then send these reports via e-mail or request them using MxEasy, MxControlCenter or via the camera's remote control (control command, videomotionanalysis section).
This section allows testing the profiles listed in this dialog. Select the desired profile and the week, then click on Get report. The camera shows the results in a new window (one table per counting line), which can be printed immediately. If you click on Download as CSV table, you can download the file and process the corresponding table in other programs (spreadsheet, databases, etc.).
The following parameters are displayed for each profile:
Parameter | Description |
---|---|
Profile | Name of the profile, as it is displayed in other selection boxes. |
Counting Lines | Selects the counting lines to include in the report. |
Columns | Defines the columns of the report table. Each column can show one day or a range of subsequent days to show totals (e.g. Mon - Fri and Sat - Sun ). |
Export Range | Specifies the range to be included in the report (weekly or monthly report). |
Week/Month | Depending on the selection in the Export Range section, you chose to include the current or the last week, or the current or the last month, respectively, in the report. |
Time | Selects the time range per day that is to be included in the report. |
Export Format | If the report is sent via e-mail, you can chose to attach the file either as HTML or as CSV file. |
A weekly report shows a table in which one line contains the counter values for one hour.
Example: A weekly report with the columns Mon,Tue,Wed,Thu,Fri,Mon - Fri and a daily range of 08:00 - 20:00 results in the following table:
Counting Line Report ... - South Entrance | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Time | Monday | Tuesday | Wednesday | Thursday | Friday | Monday - Friday | ||||||
In | Out | In | Out | In | Out | In | Out | In | Out | In | Out | |
8:00 - 9:00 | 0 | 0 | 0 | 0 | 0 | 0 | 4 | 5 | 0 | 0 | 4 | 5 |
9:00 - 10:00 | 0 | 0 | 0 | 0 | 0 | 0 | 5 | 10 | 0 | 0 | 5 | 10 |
10:00 - 11:00 | 0 | 0 | 0 | 0 | 0 | 0 | 1 | 13 | 0 | 0 | 1 | 13 |
11:00 - 12:00 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
12:00 - 13:00 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
13:00 - 14:00 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
14:00 - 15:00 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
15:00 - 16:00 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
16:00 - 17:00 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
17:00 - 18:00 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
18:00 - 19:00 | 0 | 0 | 0 | 0 | 2 | 7 | 0 | 0 | 0 | 0 | 2 | 7 |
19:00 - 20:00 | 0 | 0 | 0 | 0 | 0 | 2 | 0 | 0 | 0 | 0 | 0 | 2 |
Total | 0 | 0 | 0 | 0 | 2 | 9 | 10 | 28 | 0 | 0 | 12 | 37 |
A monthly report shows a table in which one line contains the counter values for one calendar week.
Example: A monthly report with the columns Mon,Tue,Wed,Thu,Fri,Mon - Fri and a daily range of 08:00 - 20:00 results in the following table:
Counting Line Report ... - South Entrance | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Week | Monday | Tuesday | Wednesday | Thursday | Friday | Monday - Friday | ||||||||
In | Out | In | Out | In | Out | In | Out | In | Out | In | Out | |||
31 | 78 | 79 | 89 | 79 | 82 | 81 | 82 | 96 | 80 | 72 | 411 | 407 | ||
32 | 75 | 69 | 81 | 87 | 82 | 85 | 75 | 80 | 66 | 91 | 379 | 412 | ||
33 | 79 | 76 | 84 | 95 | 83 | 79 | 102 | 80 | 81 | 75 | 429 | 405 | ||
34 | 86 | 89 | 92 | 89 | 74 | 87 | 84 | 85 | 91 | 79 | 427 | 429 | ||
35 | 81 | 88 | 93 | 77 | 0 | 0 | 0 | 0 | 0 | 0 | 174 | 165 |
Note: A hyphen in a cell means that there are no counter values available for this hour. This may be caused by an analysis that had been activated at the time or a time range in the past, for which the corresponding data record is not available any more.
A heatmap shows the distribution of the objects, i.e., where objects are staying and how they move, as a colored heat image. The warmer the color, the more objects had been staying at a specific location. When visualizing the results, you can set a range of minimum and maximum values to include in the heatmap, and you can set the heatmap's transparency.
Open this dialog to define different reports, which can be used in other dialogs. You can then send these reports via e-mail or request them using MxEasy, MxControlCenter or via the camera's remote control (control command, videomotionanalysis section).
This section allows getting a heatmap that covers a given time range within the range of recorded data. Firs, select the desired time range for the heatmap. Click on Get report to show this heatmap in a separate browser window.
Hint: Click in a date field to show a calendar. The days with available data have a light green background and can be selected.
This section allows testing the profiles listed in this dialog. To do so, select the desired profile and the day, then click on Get report. The distribution of objects is shown in a new window on a current live image of the camera or a reference image (if such an image has been saved; see reference image). You can print the heatmap from this window or save the heatmap as JPG file.
The following parameters are displayed for each profile:
Parameter | Meaning |
---|---|
Profile | Name of the profile, as it is displayed in other selection boxes. |
Export Range | Specifies the range to be included in the report (current or last day). |
Time | Selects the time range per day that is to be included in the report. |
Legend | Adds a legend to the image on the heatmap report, which includes the minimum and maximum values in O/h (Objects/hour). |
Value Range | Usually, you will display all values in the heatmap (minimum value = 0 %, maximum value = 100 %). By adjusting the minimum and maximum values, you can influence the displayed results as follows:
|
Transparency | Controls the heatmap transparency. A higher value will show more of the image in the background. |
In order to to use the export features of MxAnalytics, the camera needs to store the analysis data on the integrated SD card of the camera. The data are stored on an MxAnalytics partition and are safely stored in case of a power failure. To format the SD card accordingly, open the Storage on External File Server / Flash Device dialog (Available Storage Targets).
Hint: You can leave this help page open during the entire process to properly follow the step-by-step instructions.
Caution: Only activate the Secure deletion mode - slow option if you would like to erase any existing data without having a chance to recover them. This formatting mode can take up to a couple of hours, depending on the size of the device.
The results of MxAnalytics are stored every 15 minutes. When running the analysis 24/7, the resulting volume of data can reach up to 1 GB per month. If you want to analyze longer periods of time, you need to make sure that the MxAnalytics volume is large enough. Note that once the reserved storage capacity of the partition has been reached, the oldest records will be overwritten.
Hint: In order to maximize the storage space for MxAnalytics on the SD card, you can use most of the space for MxAnalytics storage when formatting. For event storage, you can use an external file server or a USB harddisk, for example.
Click on the Set button to activate your settings and to save them until the next reboot of the camera.
Click on the Factory button to load the factory defaults for this dialog (this button may not be present in all dialogs).
Click on the Restore button to undo your most recent changes that have not been stored in the camera permanently.
Click on the Close button to close the dialog. While closing the dialog, the system checks the entire configuration for changes. If changes are detected, you will be asked if you would like to store the entire configuration permanently.
cn, de, en, es, fr, it, jp, ru |