-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.Rmd
119 lines (83 loc) · 6.08 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
---
title: "README"
output:
md_document:
variant: gfm
---
<!-- badges: start -->
[![R-CMD-check](https://github.com/jepusto/SingleCaseES/workflows/R-CMD-check/badge.svg)](https://github.com/jepusto/SingleCaseES/actions)
[![Codecov Status](https://codecov.io/gh/jepusto/SingleCaseES/branch/master/graph/badge.svg)](https://codecov.io/gh/jepusto/SingleCaseES?branch=master)
[![](http://www.r-pkg.org/badges/version/SingleCaseES)](https://CRAN.R-project.org/package=SingleCaseES)
[![](http://cranlogs.r-pkg.org/badges/grand-total/SingleCaseES)](https://CRAN.R-project.org/package=SingleCaseES)
[![](http://cranlogs.r-pkg.org/badges/last-month/SingleCaseES)](https://CRAN.R-project.org/package=SingleCaseES)
<!-- badges: end -->
# SingleCaseES: A calculator for single-case effect size indices
This package provides R functions for calculating basic effect size indices for single-case designs, including several non-overlap measures and parametric effect size measures, and for estimating the gradual effects model developed by [Swan and Pustejovsky (2018)](https://doi.org/10.1080/00273171.2018.1466681). Standard errors and confidence intervals (based on the assumption that the outcome measurements are mutually independent) are provided for the subset of effect sizes indices with known sampling distributions.
The available __non-overlap indices__ are:
* Percentage of non-overlapping data (PND)
* Percentage of all non-overlapping data (PAND)
* Robust improvement rate difference (IRD)
* Percentage exceeding the median (PEM)
* Non-overlap of all pairs (NAP)
* Tau non-overlap (Tau)
* Baseline-corrected Tau (Tau-BC)
* Tau-U (including baseline trend adjustment)
The available __parametric effect sizes__ are:
* Within-case standardized mean difference
* Log response ratio (decreasing and increasing)
* Log odds ratio
* Log ratio of medians
* Percent of goal obtained
* The gradual effects model, which can be used to estimate log response ratios or log odds ratios in the presence of time trends during treatment and return-to-baseline phases.
The package also includes two graphical user interfaces (designed using [Shiny](https://shiny.rstudio.com/)) for interactive use, both of which are also available as web apps hosted through [shinyapps.io](https://www.shinyapps.io/):
* `SCD_effect_sizes()` opens an interactive calculator for the basic non-overlap indices and parametric effect sizes. It is also available at https://jepusto.shinyapps.io/SCD-effect-sizes/.
* `shine_gem_scd()` opens an interactive calculator for the gradual effects model. It is also available at https://jepusto.shinyapps.io/gem-scd/.
__*Please note that the web apps should only be used for demonstration purposes*__. For research purposes, please install the R package and run the GUI through RStudio.
# Acknowledgment ![]()
<img src="https://raw.githubusercontent.com/jepusto/SingleCaseES/main/images/IES_InstituteOfEducationSciences_RGB.svg" width="40%" align = "right" alt = "Institute of Education Sciences logo"/>
The development of this R package was supported in part by the Institute of Education Sciences, U.S. Department of Education, through [Grant R324U190002](https://ies.ed.gov/funding/grantsearch/details.asp?ID=3358) to the University of Oregon. The contents of the package do not necessarily represent the views of the Institute or the U.S. Department of Education.
# Citations
Please cite this R package as follows:
> Pustejovsky, J. E., Chen, M., Grekov, P., & Swan, D. M. (`r substr(packageDate("SingleCaseES"),1,4)`). SingleCaseES: A calculator for single-case effect size indices (Version `r packageVersion("SingleCaseES")`) [R package]. https://jepusto.github.io/SingleCaseES/
Please cite the web applications as follows:
> Pustejovsky, J. E., Chen, M., Grekov, P., & Swan, D. M. (`r substr(packageDate("SingleCaseES"),1,4)`). Single-case effect size calculator (Version `r packageVersion("SingleCaseES")`) [Web application]. https://jepusto.shinyapps.io/SCD-effect-sizes
> Swan, D. M. & Pustejovsky, J. E. (2017). gem_scd: A web-based calculator for the Gradual Effects Model (Version 0.1.0) [Web application]. https://jepusto.shinyapps.io/gem-scd
# Installation
The package is available on the Comprehensive R Archive Network.
To install it, you will first need to [install R](http://cran.r-project.org/) and [RStudio](http://www.rstudio.com/products/rstudio/download/). Both of these programs are freely available.
Once you have these programs installed, run the following commands at the RStudio console prompt:
```{r, eval = FALSE}
install.packages("SingleCaseES")
```
To install the latest development version directly from Github, type:
```{r, eval=FALSE}
install.packages("devtools")
install.packages("sourcetools")
install.packages("shiny")
install.packages("markdown")
install.packages("ggplot2")
install.packages("purrrlyr")
devtools::install_github("jepusto/SingleCaseES", build_vignettes = TRUE, force = TRUE)
```
# Getting started
The package includes two vignettes that demonstrate the syntax of the main functions and provide precise definitions and details about how each of the effect sizes are calculated. To view the vignettes, type the following:
```{r, eval = FALSE}
browseVignettes("SingleCaseES")
```
A list of vignettes should then appear in your browser. Click on the hyperlinks to view them. Alternately, type the following line of code to open the introductory vignette:
```{r, eval = FALSE}
vignette("Using-SingleCaseES")
```
# Graphical user interface
To use the graphical user interface for basic effect sizes, you must first ensure that the `SingleCaseES` package is installed (following the directions above). To start the calculator, type the following commands at the RStudio console prompt:
```{r, eval = FALSE}
library(SingleCaseES)
SCD_effect_sizes()
```
The calculator should then open in your default web browser. To exit the calculator, close the window in which it appears.
To use the graphical user interface for the gradual effects model, type the following commands at the RStudio console prompt:
```{r, eval = FALSE}
library(SingleCaseES)
shine_gem_scd()
```
The calculator should then open in your default web browser.