Compute Potential Hysteresis

Detects the presence of counter-clockwise hysteresis (effect lags concentration).

Usage

compute_potential_hysteresis(
  data,
  ntime_col,
  deltaqtc_col,
  conc_col,
  group_col
)

Arguments

data

A data frame containing C-QT analysis dataset

ntime_col

An unquoted column name for nominal timepoints

deltaqtc_col

An unquoted column name for dQTC measurements

conc_col

An unquoted column name for concentration measurements

group_col

An unquoted column name for grouping column - usually DOSEF

Value

Logical TRUE if hysteresis detected (Tmax-Umax lag >= 1 hour with sustained QTc elevation), FALSE otherwise

Details

Hysteresis is flagged when both conditions are met:

• The time of maximum QTc effect (Umax) occurs >= 1 hour after time of maximum concentration (Tmax)

• More than 3 timepoints have mean deltaQTc > 5 ms (sustained elevation)

See also

eda_hysteresis_loop_plot() for visual inspection of hysteresis loops

Examples

data_proc <- preprocess(cqtkit_data_verapamil)
data_proc <- dplyr::filter(data_proc, DOSE == 120)

compute_potential_hysteresis(
  data_proc,
  NTLD,
  deltaQTCF,
  CONC,
  DOSEF)
#> [1] FALSE