Apply flatline QC flag — utilASRflagflatline • AquaSensR

Apply flatline QC flag

Usage

utilASRflagflatline(flag, vals, dqo)

Arguments

flag: character vector of current flag values ("pass", "suspect", or "fail").
vals: numeric vector of observed values, the same length as flag.
dqo: two-row data frame of data quality objectives for the parameter being checked, containing one row where Flag == "Fail" and one where Flag == "Suspect". Optional numeric columns FlatN and FlatDelta define the run-length and tolerance thresholds for each severity level. Either row may have NA for these columns, in which case that level of check is skipped.

Value

Updated character flag vector.

Details

Uses utilASRflagrleflat to compute consecutive run lengths. A run extends as long as the range (max minus min) of all values in the run so far is strictly less than FlatDelta. An observation is flagged "suspect" when its run length reaches FlatN (using FlatDelta from the "Suspect" row), and "fail" when its run length reaches FlatN (using FlatDelta from the "Fail" row).

Examples

flag <- rep("pass", 8)
vals <- c(10, 10, 10.005, 10.002, 10.001, 10.003, 12, 12)
dqo <- data.frame(
  Flag = c("Fail", "Suspect"),
  FlatN = c(5, 3), FlatDelta = c(0.01, 0.01)
)
utilASRflagflatline(flag, vals, dqo)
#> [1] "pass"    "pass"    "suspect" "suspect" "fail"    "fail"    "pass"   
#> [8] "pass"