WiFi Location Monitor > Map
WiFi Location Monitor > Nodes
WiFi Location Monitor > Devices
WiFi Location Monitor > Cloudtrax
WiFi Location Monitor > Settings
WiFi Location Monitor > Analytics
WiFi Location Monitor > Heatmap
Access the Accuware dashboard at at this link and follow the instructions on the login screen. Please supply the credentials contained in the email from Accuware Activation email and press the Login to Dashboard button.
Once authenticated you will be automatically redirected under the Sites sub-section of the General section where you will find the following areas:
Current Site: summarizes and lets you change basic information of the site.
- Site Id: your unique site identification.
- Name: your custom site name.
- Description: the expiration date of your site along with the type of account (FREE EVALUATION or PRODUCTION).
- Address: this coordinates allows to place the Map on the area of interest.
- Access: this is the access level associated with your account (identified by your email address).
This sub-section enables you to manage the logical levels associated with a specific site. Use the levels mechanism to group nodes based on:
- their vertical positions (e.g. groups of nodes placed on different floors of the same store).
- or their different locations (e.g. groups of nodes placed in different stores of the same shopping mall).
To create a new logical level you need simply to:
- Click on the Add Level button.
- Select a LevelID for the new level.
- (OPTIONAL) insert a Name and a Description.
- Click on Save.
You can also Edit the information associated with a level or Delete a level by using the buttons on the right side of the table.
This sub-section enables the management of the floor plan(s) associated with each logical level of a site. Please keep in mind that even if it is possible to associate more than one floor plan for each one of the levels of a site, this practice is strongly discouraged.
To upload a new floor plan you need simply to read the step by step guide at this link.
You can also View a floor plan, Edit the information associated with a floor plan or Delete a floor plan by using the buttons on the right side of the table.
This section enables the management of the users who are allowed to access to the Accuware dashboard (and allowed to call the Accuware API):
Your account: allows the assignment of a new password for the user account currently logged in.
Registered Accounts: gives a list of users currently registered in the site and allows to Change the Access level of a specific account (see below) or to Delete a specific account.
To create a new account you need simply to:
- Click on the Add Account button
- Insert the email address of the new user
- Select the Access level for the new user (see below)
- Click on Save
Please be aware that the initial password for the new user will be EMPTY and the new user will be able to change his/her password under the Accounts section after the first login).
This section enables the management of the geo-fences associated to the levels of your site. Geo-fences are virtual polygons (made of multiple vertex) that can be used to divide a floor plan into multiple virtual fences allowing afterwards to identify the fence in which each device is located:
- looking at the Geo-fence column of the Map section of the Accuware dashboard.
- or looking at the areas field of the JSON returned by the station API call.
To create a geo-fence:
- Select the level of interest using the drop-down menu in the top-right corner of the map.
- Leave the top-left button to INCLUDE.
- Click on the button with the star and click on the map to define the first vertex of the geo-fence.
- Click on the map to define the geo-fence (each geo-fence can contain an unlimited number of vertex). At the end click on the first vertex to close the geo-fence. The geo-fence has been created and an ID has been assigned to it.
To modify a geo-fence:
- Click on the geo-fence area.
- Modify the geo-fence vertex.
- Click outside the geo-fence area.
In order to delete a geo-fence:
- Click inside the geo-fence area.
- Click on the Trash button.
Accuware Wi-Fi Location Monitor
This page is your main view to your Accuware Wi-Fi Location Monitor installation:
Accuware Wi-Fi Location Monitor maps: this section of the page shows for your current site
- summary information about the total number of nodes, the number of known devices detected in the past 5 minutes, the number of unknown devices detected in the 2 hours.
- the position(s) of the node(s):
- a green icon indicates a properly working node;
- a red icon means that there is a problem and the node is not sending any report to the Accuware server from at least 15 seconds. If the problem persists, check here for solutions.
- the location(s) of the station(s) detected by the nodes:
- ORANGE dots: unknown stations active in the past 10 minutes.
- YELLOW dots: known (registered) stations active in the past 5 minutes.
- GREY dots: known (registered) stations active in the past 60 days (but not seen anymore from more than 5 minutes). By clicking on the dots you will be able to see the last time a device has been seen in the site.
- Below the map it is possible to find a set of tools useful to filter the information shown on the map.
- In the top-right corner of the map there are:
- a button to enlarge the Map to full screen.
- a drop-down menu that allows to select the level of the site to be shown.
Devices: this section of the page shows the list of all the WiFi devices registered within the site (devices can be registered inside this area):
- Name: an optional name associated to the device.
- Description: an optional description associated to the device.
- MAC: is the MAC address of the device.
- Level ID: is the level on which the device has been added.
- Last Seen: shows when the device has been seen last time by at least one of the nodes. N/A means that the device has never been seen active or has not been seen active since the last upgrade of the Accuware dashboard.
- Geo Fences: shows the IDs of the geo-fences in which the device is currently located.
- Show button: enable the visualization of a specific WiFi devices. It must be used in conjunction with the Selected button bellow the Map.
Nodes: this section of the page shows several information regarding the nodes registered within the site:
- Name: an optional name associated to the node.
- Description: an optional description associated to the node.
- MAC: is the MAC address of the node.
- Level ID: is the level on which the node has been added.
- Last Report: is when the node sent its last report to the Accuware server.
- Devices in Range: is the number of devices seen in the last report.
- Status: a node is considered ACTIVE, if it has been able to transmit at least a report in the last 15 seconds.
This page allows the management of the nodes of your site:
Node Map: this section of the page shows the all the nodes of a specific level of your site. It is possible to do the following actions:
- Add a node: you can do so by following these simple steps:
- Chose the level on which you want to add the node(s) by using the drop-down menu in the top-right corner of the map.
- Activate the Floor Plan visualization by clicking the button in the top left corner of the Map (this enable the highest level of zooming we strongly invite you to use it!).
- Click on the map to create a new node. The node positions, set using the Accuware dashboard, are used to resolve the location of the mobile devices by the Accuware Wi-Fi Location Monitor engine and this is why it is mandatory to closely match the nodes’ map locations with their physical locations.
- Insert a the MAC address of the node(s) (MAC addresses must have this format AA:BB:CC:DD:EE:DD).
- (OPTIONALLY) insert a Name and a Description for the node(s).
- Delete a node: you can do so by clicking on the node and clicking the Delete button.
- Move the node: you can do so by dragging and dropping one or more nodes in a new location.
Nodes: shows the list of all Open Mesh nodes registered with the site. It is possible to Edit the information associated with a node (Name, Description, LevelID, Latitude and Longitude) or Delete a node by clicking the button on the right side of the table.
This page allows the management of all the stations (Wi-Fi devices) detected by the nodes:
Known devices: this section of the page shows the list of all the known Wi-Fi devices registered within the site. It is possible to Edit the information associated with a Known device (Name, Description) or Delete a specific Known Device by using the buttons on the right side of the table.
To add a Known device inside the list you need simply to:
- Click on the Add Device button.
- Insert a the MAC address of the device (MAC addresses must have this format AA:BB:CC:DD:EE:DD).
- (OPTIONAL) insert a Name and a Description.
Other devices: this section of the page shows the list of all the unknown Wi-Fi devices detected in proximity of the site during the past 2 hours. It is possible to Add a Wi-Fi device among the list of Known devices clicking on the Edit button under the Action column.
In this sub-section you will see the status of the Open Mesh nodes inside the Cloudtrax dashboard. The Cloudtrax dashboard is a third-party dashboard that provides a convenient way to monitor and configure the Open Mesh Wi-Fi network used by Accuware Wi-Fi Location Monitor. You have to keep in mind that this tool is NOT at all involved in the trilateration of the locations of the Wi-Fi devices detected.
If you want to see more information about the status of the Open Mesh network and to modify all the parameters associated with your Open Mesh network you can login to Cloudtrax at this page using the credentials provided in the Accuware Activation email.
This page allows the management of advanced information of the site:
- Report Frequency: this is the frequency at which the nodes scan the environment looking for MAC addresses on a specific channel. Right now it is NOT possible to increase the frequency of the reports.
- Node Type: indicates the type of node. Please make sure that the type of nodes you bought from Open Mesh is the same type listed here (OM2P, OM2P-LC or OM2P-HS). If not lease submit a support request using this form immediately!
- RssModel: using this setting you can force the system to use a specific model to estimate the positions of the devices. You can try to change this parameter to a specific value and see if you notice improvement in the positions:
- Linear – works best if you operate the network in environments with many walls.
- Logarithmic – is better suited for open spaces or buildings with large rooms. It can take up to 5 minutes before the new model kicks in. When this model is chosen the WiFi devices outside the perimeter of the nodes tend to be pulled towards the area with the WiFi nodes. Anyway, as explained inside this page, the locations outside the perimeter of the WiFi nodes are not accurate and should not be taken into account.
- Noise Reduction: enables a filter that will remove some of the noise present in the measurements. The filter should be able to make the locations less “jumpy”, although it might introduce some latency in the locations updates. Again, the best advice is to try different settings and see if any of them improves the locations. It will take up to 1 minute before this setting becomes active.
The Analytics section of the Accuware dashboard allows to see and export the information related to 4 different metrics.
- a green icon indicates a properly working node;
- a red icon signifies that the node lost connectivity to the server. If the problem persists, you can find a solution in this page.
Real-time Updates: summarizes the number of unique stations detected by all the nodes in their last reports. Every 5 seconds each node reports to the Accuware server the number of unqiue Wi-Fi devices detected and these reports are aggregated to show the count of unique visitors seen by all the nodes of your site.
Site Statistics: shows the count of unique visitors seen since the beginning of the day, week and month.
Recent Visitors: shows the number of unique visitors seen in the last 6 hours or the number of reports received by the Accuware server in the last 6 hours. Data is aggregated at 10 minutes intervals.
- EXAMPLE: if you walk by 3 times, say between 10:00:01 AM and 10:09:59 AM, it counts you as one. If you walk by again at 10:10:00 AM it will count you another time. If your site contains multiple nodes, use the Settings link (in the top-right corner of the graph) to display data from all the nodes or a sub-set of nodes.
Historical Data: displays counts for a specific time period (From-To) and a specific granularity (Freq). By default you will see the unique visitors seen by all the nodes of your site during the past 7 days.
- Settings: if your site contains multiple nodes, use the Settings link (in the top-right corner of the graph) to display data from all the nodes or a sub-set of nodes. Under the Settings menu you can also choose between 4 different metrics:
- Unique Visitors (unmc): counts the number of unique visitors (unique MAC addresses). Again, if you select Freq “Hourly”, it will count you as one if you walk by any time between 10:00:00 AM and 10:59:59 AM, and then it will count you again if you walk by any time after 11:00:00 AM.
- Report Count (repc): counts the number of “reports” transmitted by nodes. When working properly, the nodes send 1 report every 5 seconds (a total 720 reports/hour). If there are problems with the Internet connection and the repc is lower than 720 reports/hour, then you might see a drop in the number of Unique Visitors (unmc) simply because the node is not able to transmit the reports to the Accuware server.
- In Place Visitors (idh3): represents for each hour, the number of visitors seen, at least once, during the previous 3 hours and it is used to see the “stationary visitors”. This means that if a MAC address is detected (at least once) between [7:00:00 AM-07:59:59 AM], between [8:00:00 AM-08:59:59 AM] and between [9:00:00 AM-09:59:59 AM], then at 10:00:00 AM, the MAC address is counted as a “In place visitor”. IMPORTANT: Obviously, the graph can be seen only with the “Hourly” frequency filter is selected.
- Unique daily devices by hour (undh) : represents for each hour, the number of new visitors seen during the previous hour. By new we mean never detected so far since the beginning of the day. This means that if a visitor is seen multiple time during a day it will be counted only once. IMPORTANT: Obviously, the graph can be seen only with the “Hourly” frequency filter is selected.
- Export (.csv): you can also export CSV files which contain the following fields for each row:
- the time stamp
- one or more of these metrics:
- Unique Visitors (unmc)
- Report Count (repc)
- In Place Visitors (idh3)
- Unique daily devices by hour (undh)
Before exporting the CSV file, you have to:
- Choose the metric(s) of interest by clicking the Settings button.
- Filter on the time window (From-To).
- Filter on the frequency (Freq).
- Click on Export (.csv) button.
The gear button in the top right corner of the page (under the siteID) allows you to change the Node sensitivity. This parameter allows you to set the sensitivity of all the nodes. This means that Analytics will count only the Wi-Fi devices with an RSS higher (or equal to) the chosen threshold. Moving the slider to the left reduces the threshold/detection radius (thus reducing the number of Wi-Fi devices counted). Please keep in mind that it is not possible to set different RSS thresholds for different nodes.
A heatmap is a graphical representation of data where values in a matrix are represented as colors. A simple heat map provides a compact, visual summary of quantitative information. Some elaborate heat maps enable viewers to visualize complex data sets. Location-related data is usually overlaid on a floor plan.
The Heatmap section of the Accuware dashboard is a demonstration tool that allows to see the density, over time, of the devices detected by Accuware Wi-Fi Location Monitor.
How to visualize a heatmap
- Select the desired floor plan using the pull-down menu in the top-right corner of the large map. The floor plan will appear superimposed on the map
- Under Synchronization:
- Check if the Timezone detected by the system is the correct timezone. If not, please change the timezone using the drop-down menu.
- Fill the Sync data up to field with the number of previous days that you want to use in your analysis.
- Click on Synchronize now to retrieve the data from the server. After the synchronization is complete, a density map will appear over the floor plan.
- You can use the controls in the Display section to manage the data set. You can:
- view data for a specific day using the Select day pull-down menu.
- select the size (in terms of number of hours) of data to be displayed for each day. It is possible to see the aggregated data for a 24-hours period, or just data for a 10-minutes window.
- You can use the controls in the Settings section to manage the data visualization by changing the following parameters:
- Opacity: the opacity of the heat map, expressed as a number between 0 and 1.
- Radius: the radius of influence for each data point, in pixels.
- Max Intensity: the maximum intensity of the heat map. By default (when set to 0), heat map colors are dynamically scaled according to the greatest concentration of points at any particular pixel location on the map. This property enables setting the maximum value. Setting the maximum intensity can be helpful when the data-set contains outliers with an unusually high intensity (e.g. if you set max intensity to 20, all the areas in which there are more than 20 points will be colored in red).
How to integrate the heat maps inside your dashboard
You can easily build a heat map visualization tool using:
- the data provided by the Accuware Wi-Fi Location Monitor API or the Accuware CSV service.
- and the Google Heat Maps APIs.
Alternatively you can visualize the Heat maps area of the Accuware dashboard inside your web application following the info inside this support page.