app_usage: Get app usage per hour

In mpathsenser: Process and Analyse Data from m-Path Sense

Get app usage per hour

Description

This function extracts app usage per hour for either one or multiple participants. If multiple days are selected, the app usage time is averaged.

Usage

app_usage(
  db,
  participant_id = NULL,
  start_date = NULL,
  end_date = NULL,
  by = c("Total", "Day", "Hour")
)

Arguments

db	A database connection to an m-Path Sense database.
participant_id	A character string identifying a single participant. Use get_participants to retrieve all participants from the database. Leave empty to get data for all participants.
start_date	Optional search window specifying date where to begin search. Must be convertible to date using as.Date. Use first_date to find the date of the first entry for a participant.
end_date	Optional search window specifying date where to end search. Must be convertible to date using as.Date. Use last_date to find the date of the last entry for a participant.
by	Either 'Total', 'Hour', or 'Day' indicating how to summarise the results.

Value

A data frame containing a column 'app' and a column 'usage' for the hourly app usage.

mpathsenser documentation built on May 29, 2024, 9:11 a.m.