get_tapping_features: Preprocess and extract interpretable features from screen...

Description Usage Arguments Details Value Author(s) See Also Examples

View source: R/get_tapping_features.R

Description

A convenience wrapper for extracting interpretable features from screen tapping data.

Usage

1
2
3
4
5
get_tapping_features(
  tap_data,
  depress_threshold = 20,
  remove_duplicates = TRUE
)

Arguments

tap_data

A n x 4 data frame with column names as t, x, y, buttonid containing tapping measurements. Here n is the total number of tapping measurements, t is the time of measurement when the screen press was recorded, x and y are the coordinates of the screen touch in the smartphone, and buttonid can be one of the following values c('TappedButtonLeft', 'TappedButtonRight','TappedButtonNone') indicating a tap that has been classified as to the left, right or neither of those places on the screen

depress_threshold

A numeric value indicating the threshold between two successive taps

remove_duplicates

A logical value indicating if duplicates in taps considered as None (i.e buttonid is neither left nor right) need to be removed or not

Details

The tapping activity entails alternately pressing two adjacent buttons as fast as possible.

Value

A 1 x 43 data frame consisting of tapping features and an error message, if any See https://github.com/Sage-Bionetworks/mhealthtools/blob/master/FeatureDefinitions.md for feature definitions

Author(s)

Elias Chaibub Neto, Meghasyam Tummalacherla, Phil Snyder, Thanneer M Perumal

See Also

tap_data

Examples

1
2
3
4
5
tap_features = get_tapping_features(tap_data)

tap_features = get_tapping_features(tap_data, depress_threshold = 120)

tap_features = get_tapping_features(tap_data, remove_duplicates = FALSE)

Sage-Bionetworks/mhealthtools documentation built on Sept. 20, 2020, 1:42 p.m.