wpa (version 1.4.3)

flag_extreme: Warn if a certain metric exceeds an arbitrary threshold

Description

This is used as part of data validation to check if there are extreme values in the dataset.

Usage

flag_extreme(data, metric, person = TRUE, threshold, return = "message")

Arguments

data

A Standard Person Query dataset in the form of a data frame.

metric

A character string specifying the metric to test.

person

A logical value to specify whether to calculate person-averages. Defaults to TRUE (person-averages calculated).

threshold

Numeric value specifying the threshold for flagging.

return

String specifying what to return. This must be one of the following strings:

• "text"

• "message"

• "table"

See Value for more information.

Value

A different output is returned depending on the value passed to the return argument:

• "text": string. A diagnostic message.

• "message": message on console. A diagnostic message.

• "table": data frame. A person-level table with PersonId and the extreme values of the selected metric.

See Also

Other Data Validation: check_query(), extract_hr(), flag_ch_ratio(), flag_em_ratio(), flag_outlooktime(), hr_trend(), hrvar_count_all(), hrvar_count(), identify_churn(), identify_holidayweeks(), identify_inactiveweeks(), identify_nkw(), identify_outlier(), identify_privacythreshold(), identify_query(), identify_shifts_wp(), identify_shifts(), identify_tenure(), remove_outliers(), standardise_pq(), subject_validate_report(), subject_validate(), track_HR_change(), validation_report()

Examples

# NOT RUN {
# The threshold values are intentionally set low to trigger messages.
flag_extreme(sq_data, "Email_hours", threshold = 15)

# Return a summary table
flag_extreme(sq_data, "Email_hours", threshold = 15, return = "table")

# Person-week level
flag_extreme(sq_data, "Email_hours", person = FALSE, threshold = 15)


# }