Sunday, March 26, 2017

Datalogging

Overview

  • Datalog is recorded continuously and stored in device's internal storage (size is capped at ~20MB)
  • Datalog holds only the most recent data, older data are overwritten; contents may be deleted upon app update due to internal changes
  • to persist data permanently users must perform a manual save

  • Datalogging activity layout

    • Sample timestamp - date and time of current data sample, the value on the right shows current timeline scale
    • Playback control bar - allows you to seek through current datalog and play it in real time
    • Parameter list - show parameter list, parameters can be quickly filtered using the filter chip group located in the upper part of the list
    • Pop-up menu - show pop-up menu with actions

    Pop-up menu

    • Live mode - show parameter values in real time as they're being recorded
    • Map - show Google map
    • Auto zoom & center - automatically zoom and center Google map based on currently displayed datalog
    • Refresh log - refresh datalog display buffer with the most recent data
    • Clear log - clear temporary datalog file
    • Help - show online guide

    • Alarm - show areas where the parameter values trigger alarm
    • Save - store selected datalog range as a permanent file (for more details watch the video demonstration below)
    • Load → open file (short press the file name)
    • Load → delete file (long press the file name to bring up an action menu with the "delete" button)
    • Load → Export
      • long press the file name to bring up an action menu with the clickable "export" icon
      • export file as:
        • .HLOG file - app proprietary binary format, this file can't be opened by other programs and is meant only for storage purposes or for data transfer between two app instances
        • .CSV file - 3rd party standard text format, this file can be opened by other programs (spreadsheet viewers etc.), however the app does not support the import of this format
          • parameters - define what parameters you wish to export
          • interval [ms] - temporal data resolution, i.e. interval in milliseconds at which the app will generate a data frame, which represents a single line record in the .csv file, the lower the interval the more lines will be generated and file size will increase linearly
    • Load → Import - import file (proprietary .hlog file only, 3rd party file import is not supported)

    Gestures

  • swiping horizontaly moves current datalog position forwards or backwards on the timeline, swiping vertically scrolls datalog vertically

  • pinching horizontally changes timeline scale, pinching vertically changes vertical size scale

  • Google maps watch the demonstration to learn how to interact with the map