Preprocess and extract interpretable features from screen tapping data.

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

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

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

Details

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

See also

tap_data

Examples

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)