Viewing Tracks

One of the most important components of NEON Command is the ability to view path history and view a user’s location at any point in time. User’s paths can be viewed live, from cloud history, or from a locally saved .neon file. User paths can be exported to a .csv file as well.

Time bar

At the bottom of NEON Command is a time bar which shows the time frame of the current tracking session. On the left and right of the time are the bounds of the session’s start and end times. Path data cannot be viewed before or after these times without opening a different session. The times on the time bar show the start and end time of the paths being shown. Users can click and drag the start and end time to change the path segment. Additionally, the start and end times can be moved together by clicking between them and dragging.

Viewing Tracks - Time Bar

On the far left of the time bar is a play/pause button which will allow users to play or pause the playback of paths. The button to the right of this allows users to control the playback speed. This can be set to 1x, 2x, 4x, 8x, 16x, or 32x. If viewing a live tracking session, once the end time reaches the current time, playback will slow to real-time.

During playback, the Personnel Sidebar will show a list of all users who are active at some point in the selected time frame. This sidebar allows users to show and hide the user’s paths and error bounds, as well as follow an individual user as they move. For more detailed information, please see the personnel sidebar documentation.

Live

When NEON Command is launched and the user has signed in, it will show a live view of users who are currently tracking with Personnel Tracker and have an internet connection. The start of the time bar will be set to the time NEON Command was opened and the end time will continue to update. If new users begin tracking while viewing a live session, they will appear in the personnel sidebar.

While viewing paths live, there may small delay between a user’s current location and the location shown in Command. This delay is estimated to be from two to five seconds based on the processing power of the user’s Android device, network latency, and the user’s walking speed.

Users can also start a new Live Session by clicking “File > New Tracking Session”. This will clear all current path data displayed and the time bar will be reset to the time when the new session was started.

Cloud History

To open tracking history stored on the cloud click “File > Open > Cloud Tracking History”. This will open a new window where users can define a time period of up to 8 hours. This time period is set by start and end dates and times. Once a time frame is set, click “Open” to download and view all paths. An error message will pop up if there is no path data during the defined time period.

Viewing Tracks - Cloud History

NOTE: Tracking history will only be stored on the cloud for 90 days. In order to preserve tracking history beyond this, it must be saved locally to a user’s computer.

Local Files

Tracking sessions can be saved locally to a user’s computer by clicking “File > Save”. This will save all of the paths in the tracking session as a .neon file. Live sessions and cloud history can both be saved in this way. The file can then be opened in Command by clicking “File > Open”.

Back Propagation

While viewing paths in real-time, users may notice paths shifting at a steady rate. This path shifting is because of a feature called back propagation which is used to improve historical data with new data. This feature works by taking current and recent location data and applying that information to locations in the past. NEON runs this back propagation at 30-second delay and a 5-minute delay.

Cloud Tracking History has back propagation already applied to it which means users will not a shift in path while viewing this data. <!–

Export Path Data

Path data that is open and visible in NEON Command can be exported into .csv format to be viewed or ingested into third party applications. The user can export a path by selecting File > Export > Path. Path data is exported as a zip file, and is organized into separate files for each user. The files are named with the TrackingUnitID_AndroidID_NameOfUSer. For example, “00009280_6E65A859_Sarah.csv”.

The columns of the path data are explained below.

  • UnixTimeMs - Unix time in milliseconds. This number can be converted to date and time using an online calculator or the well known algorithm.
  • Latitude - Value for the location of the user.
  • Longitude - Value for the location of the user.
  • Heading - Facing direction from North (0 deg) measured clockwise.
  • HeadingError - Standard deviation in degrees.
  • ErrorLatitude - Latitude of the center of the error bound.
  • ErrorLongitude - Longitude of the center of the error bound.
  • ErrorRadius - Radius of the error bound measured in meters.
  • Floor - Index of building floor. The ground floor is 0.
  • FloorError - Uncertainty in floor measurement in floor units.
  • Altitude - Meters above mean sea level (MSL)
  • AltitudeError - Uncertainty of altitude measurement in meters. This value is 1000 when altitude is uninitialized.

Below is an example snippet of exported path data.

** Insert picture of path data here **

There are three rows of data generated for each path point. The earliest time stamp in the row is the real time location. The second time stamp is the 30 second back propagated location, and the latest time stamp is the five minute back propagated location. When ingesting this data into a third party application, you can simply filter the results to show which data point you prefer. NEON Command always displays the best possible location, so it will show the real time result first, then when the 30 second back propagated location comes in that is displayed, and when five minutes passes that location is displayed on the screen.

** What is the logic behind the 3 types of data that is saved in the data base? ** –>