-
Notifications
You must be signed in to change notification settings - Fork 5
/
README.rmd
93 lines (60 loc) · 3.81 KB
/
README.rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please don't edit that file -->
```{r setup, include=FALSE}
knitr::opts_chunk$set(echo = TRUE)
```
# MIMS-unit algorithm
<!-- badges: start -->
[![CRAN Status](https://www.r-pkg.org/badges/version/MIMSunit)](https://cran.r-project.org/package=MIMSunit)
[![Pkgdown](https://github.com/mHealthGroup/MIMSunit/workflows/Pkgdown/badge.svg?branch=master)](https://github.com/mHealthGroup/MIMSunit/)
[![.github/workflows/test.yml](https://github.com/mHealthGroup/MIMSunit/workflows/.github/workflows/test.yml/badge.svg)](https://github.com/mHealthGroup/MIMSunit/)
[![AppVeyor build status](https://ci.appveyor.com/api/projects/status/github/muschellij2/MIMSunit?branch=master&svg=true)](https://ci.appveyor.com/project/muschellij2/MIMSunit)
[![](https://cranlogs.r-pkg.org/badges/MIMSunit)](https://cran.r-project.org/package=MIMSunit)
<!-- badges: end -->
__Please create github [issues](https://github.com/mhealthgroup/MIMSunit/issues/) if you have any question related to the package. Please click the following button to subscribe to any update on the package (Very important to receive notifications about bugs and bug fixes).__
<!-- Place this tag where you want the button to render. -->
<a class="github-button" href="https://github.com/mhealthgroup/MIMSunit/subscription" data-color-scheme="no-preference: dark; light: light; dark: dark;" data-size="large" data-show-count="true" aria-label="Watch mhealthgroup/MIMSunit on GitHub">Watch</a>
## Short introduction
MIMS-unit is abbreviated for _Monitor Independent Movement Summary_ unit. This measurement is developed to harmonize the processing of accelerometer data from different devices. You may refer to the [manuscript](https://doi.org/10.1123/jmpb.2018-0068) for the detail description of the algorithm.
## Copyright and citation
The copyright of the work belongs to Northeastern University, [mHealth Research Group](https://www.mhealthgroup.org/). Please kindly [cite the manuscript](https://mhealthgroup.github.io/MIMSunit/authors.html) if you have used the package or referred to the algorithm in your work.
## Shiny Demo App
You may try to compute MIMS-unit values using our shiny demo app https://qutang.shinyapps.io/MIMSunit/. Note that the upload file size limit is 50 MB. The usage quote for the server is limited, so we do not guarantee the web app is always available to you.
## Datasets
All datasets used in the manuscript are available at https://mhealthgroup.github.io/MIMSunit/articles/datasets.html.
## System Requirements
1. R (>= 3.6.0)
2. memory (> 4GB)
### For Windows
Rtools >=3.5 (see: https://cran.r-project.org/bin/windows/Rtools/)
### For Linux (use ubuntu as an example)
Install dependency system packages for `devtools`: `build-essential`, `libcurl4-gnutls-dev`, `libxml2-dev`, `libssl-dev`, `libcurl4-ssl-dev`.
## Installation
### Stable version
CRAN
```r
install.packages('MIMSunit')
```
### Development version
Github
```r
install.packages("devtools")
devtools::install_github("mhealthgroup/MIMSunit")
```
_Note: It is recommended to use Rstudio when installing the package, because `devtools` has some compatible issues with R command line interface._
## Usage
```r
MIMSunit::mims_unit(input_dataframe, dynamic_range=c(-3,3), epoch='1 min')
```
Assume the input dataframe is in following format, with the first column (timestamp) in `POSXlct` objects and the device used to collect this data has dynamic range being -3g to 3g. You may set the epoch length to be `1 min`, `1 sec`, `5 sec`, `10 sec` and so on.
```
HEADER_TIME_STAMP,X,Y,Z
2016-10-03 14:51:14.236,0.007,-0.005,0.984
2016-10-03 14:51:14.256,0.008,-0.007,0.981
2016-10-03 14:51:14.276,0.009,-0.006,0.978
2016-10-03 14:51:14.297,0.009,-0.007,0.984
2016-10-03 14:51:14.317,0.010,-0.010,0.982
2016-10-03 14:51:14.337,0.011,-0.010,0.982
```