mmhistorytools

An openaps plugin for cleaning, condensing, and reformatting medtronic history data

Motivation

Pump history records are optimized for storage, and not necessarily for analysis. They are a mix of mutable (Bolus) and immutable (TempBasalDuration) values. They require additional context to interpret important events, like whether a square bolus is still in delivery or whether it was cancelled, and how much basal insulin was lost during a PumpSuspend window.

Interpreting recent historical events is a foundational component in any openaps project, and this plugin aspires to be a central place for documenting and testing the intricacies of that task.

The mmhistorytools plugin vends multiple commands. Each command does a single pass over a set of history and is intentionally limited in scope, prioritizing testability above performance.

Getting started

Installing from pypi

$ sudo easy_install openapscontrib.mmhistorytools

Installing from source for development

Clone the repository and link via setuptools:

$ python setup.py develop

Adding to your openaps project

$ openaps vendor add openapscontrib.mmhistorytools
$ openaps device add history mmhistorytools

Usage

Use the device help menu to see available commands.

$ openaps use history -h
usage: openaps-use history [-h] USAGE ...

optional arguments:
  -h, --help  show this help message and exit

## Device history:
  vendor openapscontrib.mmhistorytools

  mmhistorytools - tools for cleaning, condensing, and reformatting history data





  USAGE       Usage Details
    trim      Trims a sequence of pump history to a specified time window
    clean     Resolve inconsistencies from a sequence of pump history
    reconcile
              Reconcile record dependencies from a sequence of pump history
    resolve   Converts events in a sequence of pump history to generalized
              record types
    normalize
              Adjusts the time and amount of records relative to a basal
              schedule and a timestamp

Use the command help menu to see available arguments.

$ openaps use history clean -h
usage: openaps-use history clean [-h] [--start START] [--end END] [infile]

Resolve inconsistencies from a sequence of pump history

positional arguments:
  infile         JSON-encoded history data

optional arguments:
  -h, --help     show this help message and exit
  --start START  The initial timestamp of the known window, used to simulate
                 missing suspend/resume events
  --end END      The final timestamp of the history window, used to simulate
                 missing suspend/resume events

Tasks performed by this pass:
 - De-duplicates BolusWizard records
 - Creates PumpSuspend and PumpResume records to complete missing pairs

Examples

Add a report flow to process pump history for analysis:

$ openaps report add clean_history.json JSON history clean pump_history.json --end clock.json --duration 5.0
$ openaps report add reconciled_history.json JSON history reconcile clean_history.json
$ openaps report add resolved_history.json JSON history resolve reconciled_history.json
$ openaps report add normalized_history.json JSON history normalize resolved_history.json --basal-profile basal.json

This common flow is also available with the prepare command shortcut:

$ openaps report add prepared_history.json JSON history prepare pump_history.json --basal-profile basal.json --end clock.json --duration 5.0

All infile arguments default to accept stdin, so commands can be chained to simplify testing:

$ openaps use pump iter_pump_hours 4 | openaps use history clean | openaps use history reconcile | openaps use history resolve | openaps use history normalize --basal-profile basal.json

Contributing

Contributions are welcome and encouraged in the form of bugs and pull requests.

Testing

Unit tests can be run manually via setuptools. This is also handled by TravisCI after opening a pull request.

$ python setup.py test