read_agd: Read activity counts from an *.'agd' file

In actigraph.sleepr: Detect Periods of Sleep and Non-Wear in 'ActiGraph' Data

Read activity counts from an *.agd file

Description

Read ActiGraph sleep watch data from a database stored in an AGD file. Return a tibble.

Usage

read_agd(file, tz = "UTC")

Arguments

file	Full path to an agd file to read.
tz	Time zone to convert DateTime ticks to POSIX time.

Value

A tibble of activity data with at least two columns: timestamp and axis1 counts. Optional columns include axis2, axis2, steps, lux and inclinometer indicators (incline off, standing, sitting and lying). The device settings are stored as attributes, which include epochlength.

References

The AGD file format is described in the ActiLife 6 User's Manual by the ActiGraph Software Department, 04/03/2012 (Document SFT12DOC13, Revision A).

See Also

read_agd_raw()

Examples

file <- system.file("extdata", "GT3XPlus-RawData-Day01.agd",
  package = "actigraph.sleepr"
)
read_agd(file)

library("dplyr")
library("purrr")

# Read ActiGraph sleep watch data from the AGD files in a directory
# and bind the data into one data frame indexed by `.filename`.
path <- system.file("extdata", package = "actigraph.sleepr")

list.files(path, pattern = "*.agd", full.names = TRUE) %>%
  map_dfr(read_agd, .id = ".filename")

actigraph.sleepr documentation built on Sept. 12, 2026, 5:08 p.m.