TLBC (version 1.0)

classify: Function to classify accelerometer and/or GPS data

Description

Classifies data into behavior categories using a pre-computed two-level model.

Usage

classify(accelerometers=NULL, GPS=NULL, modelName, saveDir, names=NULL)

Arguments

accelerometers

(Optional) Path to a directory (or list of directories) containing actigraph accelerometer data files. Accelerometer data files should be csv files output in "raw" format by ActiLife (without timestamps), and named by the participant identifier, e.g., Participant01.csv.

Or, path to a directory (or list of directories) containing previously computed accelerometer features, i.e., computed by the function sensorsToFeatures.

GPS

(Optional) Path to a PALMS-processed GPS data file (or a directory containing GPS data files). GPS data files should be in csv format with the following fields: identifier, dateTime, speed, ele, elevationDelta, lat, lon, nsatView, snrView. identifier should be the participant identifier, e.g. Participant01. If GPS is a path to a directory, each file in the directory should correspond to a participant, and the file name should be the participant identifier, e.g., Participant01.csv.

Or, path to a directory containing previously computed GPS features, i.e., computed by the function sensorsToFeatures.

modelName

Path to a pre-trained TLBC model. Either a model you trained yourself, i.e., the argument modelName in the function trainModel, or a pre-trained model that has been trained on one of three UCSD datasets, available for download.

saveDir

Path to a directory where predictions will be saved. Predictions will be saved in files named <identifier>.csv with two fields: timestamp, prediction.

names

(Optional) List of participant identifiers to use.

Examples

## Not run: 
# 
# # use a pre-trained model to classify hip accelerometer data
# myAccel="~/myStudy/HipGT3X+"
# ovrWgtModel="OverweightWomenHipGT3X+.RData"
# myPredictions="~/myStudy/predictions"
# classify(accelerometers=myAccel, modelName=ovrWgtModel, saveDir=myPredictions)
# ## End(Not run)