Skip to content

mMARCH.AC

Processing of Accelerometry Data with 'GGIR' in mMARCH

v3.3.4.0 · Feb 5, 2026 · GPL-3

Description

Mobile Motor Activity Research Consortium for Health (mMARCH) is a collaborative network of studies of clinical and community samples that employ common clinical, biological, and digital mobile measures across involved studies. One of the main scientific goals of mMARCH sites is developing a better understanding of the inter-relationships between accelerometry-measured physical activity (PA), sleep (SL), and circadian rhythmicity (CR) and mental and physical health in children, adolescents, and adults. Currently, there is no consensus on a standard procedure for a data processing pipeline of raw accelerometry data, and few open-source tools to facilitate their development. The R package 'GGIR' is the most prominent open-source software package that offers great functionality and tremendous user flexibility to process raw accelerometry data. However, even with 'GGIR', processing done in a harmonized and reproducible fashion requires a non-trivial amount of expertise combined with a careful implementation. In addition, novel accelerometry-derived features of PA/SL/CR capturing multiscale, time-series, functional, distributional and other complimentary aspects of accelerometry data being constantly proposed and become available via non-GGIR R implementations. To address these issues, mMARCH developed a streamlined harmonized and reproducible pipeline for loading and cleaning raw accelerometry data, extracting features available through 'GGIR' as well as through non-GGIR R packages, implementing several data and feature quality checks, merging all features of PA/SL/CR together, and performing multiple analyses including Joint Individual Variation Explained (JIVE), an unsupervised machine learning dimension reduction technique that identifies latent factors capturing joint across and individual to each of three domains of PA/SL/CR. In detail, the pipeline generates all necessary R/Rmd/shell files for data processing after running 'GGIR' for accelerometer data. In module 1, all csv files in the 'GGIR' output directory were read, transformed and then merged. In module 2, the 'GGIR' output files were checked and summarized in one excel sheet. In module 3, the merged data was cleaned according to the number of valid hours on each night and the number of valid days for each subject. In module 4, the cleaned activity data was imputed by the average Euclidean norm minus one (ENMO) over all the valid days for each subject. Finally, a comprehensive report of data processing was created using Rmarkdown, and the report includes few exploratory plots and multiple commonly used features extracted from minute level actigraphy data. Reference: Guo W, Leroux A, Shou S, Cui L, Kang S, Strippoli MP, Preisig M, Zipunnikov V, Merikangas K (2022) Processing of accelerometry data with GGIR in Motor Activity Research Consortium for Health (mMARCH) Journal for the Measurement of Physical Behaviour, 6(1): 37-44.

Downloads

307

Last 30 days

13031st

1.3K

Last 90 days

6.2K

Last year

Trend: -28.8% (30d vs prior 30d)

CRAN Check Status

2 NOTE
12 OK
Show all 14 flavors
Flavor Status
r-devel-linux-x86_64-debian-clang OK
r-devel-linux-x86_64-debian-gcc OK
r-devel-linux-x86_64-fedora-clang NOTE
r-devel-linux-x86_64-fedora-gcc NOTE
r-devel-macos-arm64 OK
r-devel-windows-x86_64 OK
r-oldrel-macos-arm64 OK
r-oldrel-macos-x86_64 OK
r-oldrel-windows-x86_64 OK
r-patched-linux-x86_64 OK
r-release-linux-x86_64 OK
r-release-macos-arm64 OK
r-release-macos-x86_64 OK
r-release-windows-x86_64 OK
Check details (2 non-OK)
NOTE r-devel-linux-x86_64-fedora-clang

dependencies in R code

Namespaces in Imports field not imported from:
  ‘ActCR’ ‘ActFrag’ ‘tidyr’
  All declared Imports should be used.
NOTE r-devel-linux-x86_64-fedora-gcc

dependencies in R code

Namespaces in Imports field not imported from:
  ‘ActCR’ ‘ActFrag’ ‘tidyr’
  All declared Imports should be used.

Check History

NOTE 12 OK · 2 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE Apr 6, 2026
NOTE r-devel-linux-x86_64-fedora-clang

dependencies in R code

Namespaces in Imports field not imported from:
  ‘ActCR’ ‘ActFrag’ ‘tidyr’
  All declared Imports should be used.
NOTE r-devel-linux-x86_64-fedora-gcc

dependencies in R code

Namespaces in Imports field not imported from:
  ‘ActCR’ ‘ActFrag’ ‘tidyr’
  All declared Imports should be used.
ERROR 11 OK · 2 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE Apr 3, 2026
ERROR r-devel-linux-x86_64-debian-gcc

package dependencies

Package required but not available: ‘xlsx’

See section ‘The DESCRIPTION file’ in the ‘Writing R Extensions’
manual.
NOTE r-devel-linux-x86_64-fedora-clang

dependencies in R code

Namespaces in Imports field not imported from:
  ‘ActCR’ ‘ActFrag’ ‘tidyr’
  All declared Imports should be used.
NOTE r-devel-linux-x86_64-fedora-gcc

dependencies in R code

Namespaces in Imports field not imported from:
  ‘ActCR’ ‘ActFrag’ ‘tidyr’
  All declared Imports should be used.
NOTE 12 OK · 2 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE Mar 10, 2026
NOTE r-devel-linux-x86_64-fedora-clang

dependencies in R code

Namespaces in Imports field not imported from:
  ‘ActCR’ ‘ActFrag’ ‘tidyr’
  All declared Imports should be used.
NOTE r-devel-linux-x86_64-fedora-gcc

dependencies in R code

Namespaces in Imports field not imported from:
  ‘ActCR’ ‘ActFrag’ ‘tidyr’
  All declared Imports should be used.

Dependency Network

Dependencies Reverse dependencies refund denseFLMM dplyr xlsx survival tidyr zoo ineq cosinor cosinor2 abind accelerometry ActCR ActFrag minpack.lm +2 more dependencies mMARCH.AC

Version History

new 3.3.4.0 Mar 10, 2026
updated 3.3.4.0 ← 3.2.0.1 diff Feb 4, 2026
updated 3.2.0.1 ← 3.2.0.0 diff Apr 24, 2025
updated 3.2.0.0 ← 2.9.4.0 diff Apr 22, 2025
updated 2.9.4.0 ← 2.9.2.0 diff Aug 22, 2024
updated 2.9.2.0 ← 2.4.0.1 diff Aug 15, 2023
updated 2.4.0.1 ← 2.4.0.0 diff Sep 21, 2022
new 2.4.0.0 Aug 21, 2022