¶ Log Recording Procedure
To assess the positioning quality and ensure that all beacons are placed correctly, it is essential to carry out the procedure of recording logs. Logs must be collected for each sublocation. This way we can conduct a comprehensive analysis to detect any sharp jumps, comprehend the suitable degree of smoothing, and repeatability of results.
Prior to the log recording procedure ensure that locations is properly prepared. Please check that the first steps of location configuration have been executed:
1. Location uploaded to Navigine Mapping Tool. Check how to upload location;
2. Beacons installed in the right places. Check beacon placement procedure.
3. Non-walkable areas are surrounded by barriers. Check how to add barriers.
4. Passageways are added as paths in the Mapping Tool. Check how to add paths.
Before the start of the recording:
- Make sure that you have the latest version of Navigine mobile app installed on your iOS/Android device.
- Check that there is no external interference with your device. In case of network loss, bluetooth problems, incoming phone call during the recording process, the recording procedure shall be restarted.
- Record between 5-10 log files for more qualitative analysis. The more logs are recorded, the more data we have in operation and therefore the better is the quality of analysis.
Positioning quality control procedure
For the log to be informative comply with the following terms:
- The duration of the log recording is at least 2 minutes. This is necessary for the solution to converge to the true one.
- The route must cover the entire walkable area and area of beacons placement. This will prove that all beacons are correctly configured and working.
- The route must start and end at the same point. This will help to evaluate the signal quality.
- The time of the start and end of logging is clocked. This will allow to receive additional logs from other devices that were providing measurements at the same time and place.
The following figure shows an example of a bad and a good route for log recording.
Measuring logs along the polyline
For location setup, advanced settings management and complicated issues we use data with ground truth. The recording procedure consists of adding a set of points, defining the trajectory, and travelling along this trajectory.
Adding a set of checkpoints helps finding the difference between calculated position and recorded trajectory. From this data we can calculate the average and maximum positional error. This procedure provides the most accurate final data.
Polyline consists of points connected with line segments. User trajectory can be constructed as polyline where each point represents a checkpoint and line segment represents the route between these points.
Log recording for Mobile application
The pipeline:
1. Go to «Locations» tab in the Navigine mobile app and make sure that the right location is chosen. “test_1” in the example (Fig.1).
2. Switch to "Measuring" tab. Here shall be seen the floor plan of the location with installed transmitters (Fig.2).
3. In order to start drawing a route you need to click a “polyline” button, one among a toolbar to the right side of the screen (Fig.3). Position of the cursor is considered as a starting point.
4. A polyline is presented by a set of points that you need to specify in this step. Please note that starting point will be created at the position of the cursor upon clicking the “polyline” button. Other points are specified by moving the cursor to the proper place and clicking “Add point” (Fig.4). After the last point is specified, you need to click “Finish”. If you made some mistakes and want to cancel this line, simply click the “polyline” button again.
5. As soon as the route is specified start measuring process. Start the log recording at the exact position that is indicated as a starting point in the app. Click “Start measuring” on the top of the screen (Fig.5) and begin walking alongside the route. Our processing algorithms assume constant velocity of the motion, so please don’t make stops during log recording and try to keep approximately the same speed during measurements.
6. Click “Checkpoint” (Fig.6) in the mobile application every time you pass a checkpoint. This way application binds the current position to the time label. All passed points and sections are marked with green color.
7. Once the last checkpoint has been reached click “Finish” button. At this step the recording process is done. At the top left part of the screen (Fig.7) will appear the message “file saved”.
8. To see the recorded log file switch to “Profile” tab, click “Settings” button at the top right corner of the screen and choose “Log management”. All the log recordings with the time of recording are stored here.
9. Click the log name and send it via email to Navigine Support or share it using your favourite app (Fig.8).
Compared to a regular log that contains dump of all visible incoming signals + recorded sensors, log with check points also includes information about the reference trajectory defined by a polyline path with timestamps. This type of logs contain all information needed for remote navigation setup.
Once the whole location has been covered with these logs, we can understand all possible configuration problems. We suggest recording logs for the first setup at any location.
Log recording for tracking
Pipeline:
- Open https://rtls.navigine.com site and check if your application is selected
- Open “Settings” tab → “Devices” → Press “Edit button of your device”
- Select your Location → Sublocation → Press “Get link” button. Then scan qr code or open underlined link
- In order to start drawing a route, you need to set the cursor at the starting point and click “Start draw path” button
- A polyline is presented by a set of points that you need to specify in this step. Please note that starting point will be created at the position of the cursor upon clicking the “Start draw path” button. Other points are specified by moving the cursor to the proper place and clicking “Add point”. After the last point is specified, you need to click “Finish”. If you made some mistakes and want to cancel this line, simply click the “Redraw path” button.
- As soon as the route is specified start measuring process. Start the log recording at the exact position that is indicated as a starting point in the app. Click “Start measurement” button and begin walking alongside the route. Our processing algorithms assume constant velocity of the motion, so please don’t make stops during log recording and try to keep approximately the same speed during measurements.
- Click “Add check point” (Fig.6) button every time you pass a checkpoint. This way application binds the current position to the time label. All passed points and sections are marked with green color.
- Once the last checkpoint has been reached at the bottom of the screen (Fig.7) will appear the message “Log was successful saved”.
