app_usage {mpathsenser} | R Documentation |
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
|
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.