readGENEActiv: Function (R) to read binary files as produced by the...

In GGIRread: Wearable Accelerometer Data File Readers

Function (R) to read binary files as produced by the GENEActiv accelerometer

Description

R function wrapper around GENEActivReader to read binary files as produced by the GENEActiv accelerometer by ActivInsights Ltd https://activinsights.com/

Usage

  readGENEActiv(filename, start = 0L, end = 0L, progress_bar = FALSE,
                desiredtz = "", configtz = NULL)

Arguments

filename	filename (required)
start	start page for reading data
end	end page for reading data
progress_bar	Boolean
desiredtz	Character, timezone database name of the timezone where the accelerometer was worn.
configtz	Character, timezone database name of the timezone where the accelerometer was configured. Leave NULL if equal to timezone where experiment took place.

Details

If only start page is defined then all data is read beyond start until the end of the file is reached.

GENEActiv light measurements are calibrated according to the device model. For GENEActiv 1.1, the existing light calibration is applied. For GENEActiv 1.2 and above, an additional correction is applied to account for the light sensor's non-linear scaling with graded resolution. This provides greater accuracy at low light levels while supporting a higher range. This correction was provided by ActivInsights Ltd, the manufacturer of GENEActiv devices.

Value

header:

serial_number	Device serial number as extracted from file header
firmware	Firmware version
tzone	Time zone as extracted from file header
ReadOK	see GENEActivReader
SampleRate	matrix with battery voltage and corresponding timestamps
ReadErrors	matrix with battery voltage and corresponding timestamps
numBlocksTotal	matrix with battery voltage and corresponding timestamps
StartTime	Start time as extracted from file header

data.out:

time	Unix time in seconds with decimal places for miliseconds
x	see GENEActivReader
y	see GENEActivReader
z	see GENEActivReader
light	Ligth values express in lux units
temperature	Temperature in Celsius

Author(s)

Patrick Bos <[e-mail]> Vincent T van Hees <[e-mail]>

Examples

  binfile  = system.file("testfiles/GENEActiv_testfile.bin", package = "GGIRread")[1]
  rdata = readGENEActiv(filename = binfile, start = 1, end = 1, desiredtz = "Europe/London")

GGIRread documentation built on Sept. 18, 2026, 9:12 a.m.