rcompanion (version 2.5.2)

mangiaficoD: Mangiafico's d, or delta MAD

Description

Calculates Mangiafico's d, or delta MAD, which is the difference in medians divided by the pooled median absolute deviation, with confidence intervals by bootstrap

Usage

mangiaficoD(
  formula = NULL,
  data = NULL,
  x = NULL,
  y = NULL,
  correct = FALSE,
  mu = 0,
  ci = FALSE,
  conf = 0.95,
  type = "perc",
  R = 1000,
  histogram = FALSE,
  reportIncomplete = FALSE,
  verbose = FALSE,
  digits = 3,
  ...
)

Value

A single statistic, d. Or a small data frame consisting of d, and the lower and upper confidence limits.

Arguments

formula

A formula indicating the response variable and the independent variable. e.g. y ~ group.

data

The data frame to use.

x

If no formula is given, the response variable for one group.

y

The response variable for the other group.

correct

If TRUE, applies Hedges' correction.

mu

In the one-sample case, the median against which to compare x

ci

If TRUE, returns confidence intervals by bootstrap. May be slow.

conf

The level for the confidence interval.

type

The type of confidence interval to use. Can be any of "norm", "basic", "perc", or "bca". Passed to boot.ci.

R

The number of replications to use for bootstrap.

histogram

If TRUE, produces a histogram of bootstrapped values.

reportIncomplete

If FALSE (the default), NA will be reported in cases where there are instances of the calculation of the statistic failing during the bootstrap procedure.

verbose

If TRUE, reports the medians, median difference, and MAD.

digits

The number of significant digits in the output.

...

Other arguments passed to mad(). Of particular interest may be the constant= argument.

Author

Salvatore Mangiafico,

Details

Mangiafico's d, or delta MAD, is an appropriate effect size statistic where Mood's median test, or another test comparing two medians, might be used. Note that the response variable is treated as at least interval.

For normal samples, the result will be somewhat similar to Cohen's d.

The input should include either formula and data; or x, and y. If there are more than two groups, only the first two groups are used. Alternately, x and mu can be used for the one-sample case.

Currently, the function makes no provisions for NA values in the data. It is recommended that NAs be removed beforehand.

When the data in the first group are greater than in the second group, d is positive. When the data in the second group are greater than in the first group, d is negative.

Be cautious with this interpretation, as R will alphabetize groups in the formula interface if the grouping variable is not already a factor.

With a small sample size, the confidence intervals determined by this method may not be reliable, or the procedure may fail.

References

Ricca, B.P. and Blaine, B.E. Brief research report: Notes on a nonparametric estimate of effect size. Journal of Experimental Education 90(1):249–258.

https://rcompanion.org/handbook/F_05.html

See Also

multiMangiaficoD

Examples

data(Catbus)
mangiaficoD(Steps ~ Gender, data=Catbus, verbose=TRUE)

Nadja = c(6,6,6,7,7,8,8,9,9,9,11,11,11)
Nandor = c(0,1,2,3,4,5,6,7,8,9,10,11)
mangiaficoD(x = Nadja, y = Nandor, verbose=TRUE)

Nadja = c(6,6,6,7,7,8,8,9,9,9,11,11,11)
Nandor = c(0,1,2,3,4,5,6,7,8,9,10,11)
mangiaficoD(x = Nadja, y = Nandor, correct=TRUE)

Guillermo = c(9,8,7,7,7,6,6,6,6,5,5,5,5,5,4,4,4,4,4,4)
mangiaficoD(x = Guillermo, mu=7, verbose=TRUE)