Read Data Files from ActiGraph Monitors

Standardize the process of bringing various modes of output files into R. For more information, see: <>. Additionally, processes are provided to read and minimally pre- process raw data from primary accelerometer and inertial measurement unit files, as well as binary .gt3x files. ActiGraph monitors are used to estimate physical activity outcomes via body-worn sensors that measure (e.g.) acceleration or rotational velocity.

Project Status: Active ? The project has reached a stable, usablestate and is being activelydeveloped. BuildStatus License

CRAN_Status_Badge packageversion


AGread is for automatically detecting the format of .csv data files from ActiGraph accelerometers, and bringing the data into R. It is designed to streamline and standardize the file-reading process, prior to further processing. Thus, it can be used flexibly to develop new methods for handling ActiGraph data, or to invoke existing methods, many of which exist in other R packages (e.g. PhysicalActivity and TwoRegression), or will soon.

New in AGread 1.2.0, binary .gt3x files can be read in as well.


You can install the development version of AGread from github with:

# install.packages("devtools")

Or, AGread v0.1.2 is now available on CRAN, and can be installed with:



AGread 0.2.0


In this update, the key new feature is support for reading binary
.gt3x files. Other bugs have been solved related to time variables,
and particularly calculations in epoch lengths other than 1-s. The
major changes are noted below.


  • Added support for reading binary .gt3x files
  • Added reintegration function
  • Expanded support for files with inclinometer columns, to allow un-coded or dummy-coded data
  • Added chunking as an option for reading RAW.csv files that are too large and cause memory issues
  • Added option to apply autocalibration with GGIR
  • Added option to return raw (uncollapsed) data (#3, @srlamunion)
  • Updated time stamp calculations and time zone specifications where needed
  • Set up automated testing for continued development

AGread 0.1.2


This is a resubmission of the original version


  • Added a summary of what ActiGraph monitors measure in DESCRIPTION
  • Unwrapped examples from \dontrun{} where feasible
  • Improved the documentation of classify_magnetometer()
  • Exported AG_meta()

AGread 0.1.1


This is a resubmission of the original version


  • Added Vincent van Hees as contributor
  • Added URL and BugReports fields to DESCRIPTION

AGread 0.1.0


  • This is the initial version of AGread.

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


0.2.2 by Paul R. Hibbing, 11 days ago

Report a bug at

Browse source code at

Authors: Paul R. Hibbing [aut, cre] , Vincent T. van Hees [ctb] , Samuel R. LaMunion [ctb] , Daniel Judge [ctb] , Judge Maygarden [ctb] , ActiGraph LLC [cph]

Documentation:   PDF Manual  

MIT + file LICENSE license

Imports anytime, binaryLogic, data.table, DescTools, dplyr, GGIR, lubridate, magrittr, rlang, seewave, stats, stringr, utils

Suggests testthat

Imported by Observation, PAutilities.

See at CRAN