telemetRy: for interacting with telemetry data in R

Description

This is a package for interacting with telemetry data using R. Functions for analyzing telemetry data over various timescales are provided. These tools were developed primarily for working with telemetry datasets generated by Data Sciences International (DSI) hardware and exported from Ponemah software.

Note: the author of this package has no affiliation with DSI.

Installation

telemetRy is available on github. To install telemetRy, you’ll need:
R > 3.2
devtools package from Hadley Wickham

First, install devtools:

install.packages('devtools')

Then install and load telemetRy:

devtools::install_github(repo = 'andrewstiegler/telemetRy')
library(telemetRy)

Usage

This package comes with a sample dataset generated using a DSI telemetry system.

head(sample_BP_data)

## # A tibble: 6 x 21
##   Time                TimesOnly ElapsedTime `1024071_SBP` `1024071_DBP`
##   <dttm>              <ITime>         <dbl>         <dbl>         <dbl>
## 1 2019-12-11 06:00:00 06:00:00            0          111.          79.3
## 2 2019-12-11 06:02:00 06:02:00          120          114.          82.6
## 3 2019-12-11 06:04:00 06:04:00          240          108.          75.6
## 4 2019-12-11 06:06:00 06:06:00          360          115.          81.4
## 5 2019-12-11 06:08:00 06:08:00          480          109.          77.1
## 6 2019-12-11 06:10:00 06:10:00          600          108.          75.9
## # ... with 16 more variables: `1024071_MAP` <dbl>, `1024071_HR` <dbl>,
## #   `1024071_Temp` <dbl>, `1024071_Activity` <dbl>, `1024084_SBP` <dbl>,
## #   `1024084_DBP` <dbl>, `1024084_MAP` <dbl>, `1024084_HR` <dbl>,
## #   `1024084_Temp` <dbl>, `1024084_Activity` <dbl>, `1033468_SBP` <dbl>,
## #   `1033468_DBP` <dbl>, `1033468_MAP` <dbl>, `1033468_HR` <dbl>,
## #   `1033468_Temp` <dbl>, `1033468_Activity` <dbl>

The package also provides functions for calculating typical days of long-term telemetry recordings, and functions for calculating circadian averages of telemetry data.

To see an example of using this package with your own DSI data, check out the guide Importing DSI data

To see an example of the advantages of the typical_day function, check out the guide for typical_day