`TOSTpaired.Rd`

Development on this function is complete, and for new code we recommend switching to tsum_TOST, which is easier to use, more featureful, and still under active development.

```
TOSTpaired(
n,
m1,
m2,
sd1,
sd2,
r12,
low_eqbound_dz,
high_eqbound_dz,
alpha,
plot = TRUE,
verbose = TRUE
)
TOSTpaired.raw(
n,
m1,
m2,
sd1,
sd2,
r12,
low_eqbound,
high_eqbound,
alpha,
plot = TRUE,
verbose = TRUE
)
```

- n
sample size (pairs)

- m1
mean of group 1

- m2
mean of group 2

- sd1
standard deviation of group 1

- sd2
standard deviation of group 2

- r12
correlation of dependent variable between group 1 and group 2

- low_eqbound_dz
lower equivalence bounds (e.g., -0.5) expressed in standardized mean difference (Cohen's dz)

- high_eqbound_dz
upper equivalence bounds (e.g., 0.5) expressed in standardized mean difference (Cohen's dz)

- alpha
alpha level (default = 0.05)

- plot
set whether results should be plotted (plot = TRUE) or not (plot = FALSE) - defaults to TRUE

- verbose
logical variable indicating whether text output should be generated (verbose = TRUE) or not (verbose = FALSE) - default to TRUE

- low_eqbound
lower equivalence bounds (e.g., -0.5) expressed in raw scores

- high_eqbound
upper equivalence bounds (e.g., 0.5) expressed in raw scores

Returns TOST t-value 1, TOST p-value 1, TOST t-value 2, TOST p-value 2, degrees of freedom, low equivalence bound, high equivalence bound, low equivalence bound in dz, high equivalence bound in dz, Lower limit confidence interval TOST, Upper limit confidence interval TOST

Mara, C. A., & Cribbie, R. A. (2012). Paired-Samples Tests of Equivalence. Communications in Statistics - Simulation and Computation, 41(10), 1928-1943. https://doi.org/10.1080/03610918.2011.626545, formula page 1932. Note there is a typo in the formula: n-1 should be n (personal communication, 31-8-2016)

```
## Test means of 5.83 and 5.75, standard deviations of 1.17 and 1.29 in sample of 65 pairs
## with correlation between observations of 0.75 using equivalence bounds in Cohen's dz of
## -0.4 and 0.4 (with default alpha setting of = 0.05).
TOSTpaired(n=65,m1=5.83,m2=5.75,sd1=1.17,sd2=1.29,r12=0.75,low_eqbound_dz=-0.4,high_eqbound_dz=0.4)
#> Warning: `TOSTpaired()` was deprecated in TOSTER 0.4.0.
#> ℹ Please use `tsum_TOST()` instead.
#> TOST results:
#> t-value lower bound: 3.96 p-value lower bound: 0.0001
#> t-value upper bound: -2.49 p-value upper bound: 0.008
#> degrees of freedom : 64
#>
#> Equivalence bounds (Cohen's dz):
#> low eqbound: -0.4
#> high eqbound: 0.4
#>
#> Equivalence bounds (raw scores):
#> low eqbound: -0.3508
#> high eqbound: 0.3508
#>
#> TOST confidence interval:
#> lower bound 90% CI: -0.102
#> upper bound 90% CI: 0.262
#>
#> NHST confidence interval:
#> lower bound 95% CI: -0.137
#> upper bound 95% CI: 0.297
#>
#> Equivalence Test Result:
#> The equivalence test was significant, t(64) = -2.489, p = 0.0077, given equivalence bounds of -0.351 and 0.351 (on a raw scale) and an alpha of 0.05.
#>
#>
#> Null Hypothesis Test Result:
#> The null hypothesis test was non-significant, t(64) = 0.735, p = 0.465, given an alpha of 0.05.
#>
#>
#> NHST: don't reject null significance hypothesis that the effect is equal to 0
#> TOST: reject null equivalence hypothesis
```