scan (version 0.51)

tau_u: Tau-U for single-case data

Description

This function calculates indices of the Tau-U family as proposed by Parker et al. (2011).

Usage

tau_u(
  data,
  dvar,
  pvar,
  tau_method = "b",
  method = "complete",
  phases = c(1, 2),
  fisher = TRUE,
  continuity_correction = FALSE
)
tauUSC(...)

Arguments

data

A single-case data frame. See scdf to learn about this format.

dvar

Character string with the name of the dependent variable. Defaults to the attributes in the scdf file.

pvar

Character string with the name of the phase variable. Defaults to the attributes in the scdf file.

tau_method

Character with values "a" or "b" (default) indicating whether Kendall Tau A or Kendall Tau B is applied.

method

"complete" (default) or "parker". The latter calculates the number of possible pairs as described in Parker et al. (2011) which might lead to tau-U values greater than 1.

phases

A vector of two characters or numbers indicating the two phases that should be compared. E.g., phases = c("A","C") or phases = c(2,4) for comparing the second to the fourth phase. Phases could be combined by providing a list with two elements. E.g., phases = list(A = c(1,3), B = c(2,4)) will compare phases 1 and 3 (as A) against 2 and 4 (as B). Default is phases = c("A","B").

fisher

If TRUE, meta analyses of Tau U is based on Fisher Z transformed correlations.

continuity_correction

If TRUE, a continuity correction is applied for calculating p-values of correlations. This parameter is not yet implemented.

...

Further arguments passed to the function.

Value

table

A data frame containing statistics from the Tau-U family, including: Pairs, positive and negative comparisons, S, and Tau

matrix

The matrix of comparisons used for calculating the statistics.

tau_u

Tau-U value.

Details

Tau-U is an inconsistently operationalized construct.

References

Parker, R. I., Vannest, K. J., Davis, J. L., & Sauber, S. B. (2011). Combining Nonoverlap and Trend for Single-Case Research: Tau-U. Behavior Therapy, 42, 284-299.

See Also

Other overlap functions: corrected_tau(), nap(), overlap(), pand(), pem(), pet(), pnd()

Examples

# NOT RUN {
## Calculate tau-U for the example from Parker et al. (2011)
bob <- scdf(c(A = 2, 3, 5, 3, B = 4, 5, 5, 7, 6), name = "Bob")
tau_u(bob)

## Calculate tau-U based on Kendall Tau A
tau_u(Grosche2011$Eva, tau_method = "a")

## Request tau-U for all single-cases fom the Grosche2011 data
tau_u(Grosche2011)
# }