GGIR: A Research Community–Driven Open Source R Package for Generating Physical Activity and Sleep Outcomes From Multi-Day Raw Accelerometer Data

Abstract

Recent technological advances have transformed the research on physical activity initially based on questionnaire data to the most recent objective data from accelerometers. The shift to availability of raw accelerations has increased measurement accuracy, transparency, and the potential for data harmonization. However, it has also shifted the need for considerable processing expertise to the researcher. Many users do not have this expertise. The R package GGIR has been made available to all as a tool to convermulti-day high resolution raw accelerometer data from wearable movement sensors into meaningful evidence-based outcomes and insightful reports for the study of human daily physical activity and sleep. This paper aims to provide a one-stop overview of GGIR package, the papers underpinning the theory of GGIR, and how research contributes to the continued growth of the GGIR package. The package includes a range of literature-supported methods to clean the data and provide day-by-day, as well as full recording, weekly, weekend, and weekday estimates of physical activity and sleep parameters. In addition, the package also comes with a shell function that enables the user to process a set of input files and produce csv summary reports with a single function call, ideal for users less proficient in R. GGIR has been used in over 90 peer-reviewed scientific publications to date. The evolution of GGIR over time and widespread use across a range of research areas highlights the importance of open source software development for the research community and advancing methods in physical behavior research.