-
Notifications
You must be signed in to change notification settings - Fork 1
/
README.Rmd
69 lines (43 loc) · 3.43 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
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# StrapvizR
<!-- badges: start -->
[](https://github.com/UBC-MDS/strapR/actions)
[](https://codecov.io/gh/UBC-MDS/strapvizr)
<!-- badges: end -->
## Summary
Performs bootstrapping of a sample to produce plots and statistics for use in final reports and documents.
The purpose of this package is to simplify and automate the process of creating simple bootstrap distributions of numerical samples. The package has a module which intakes a sample and relevant parameters such as the desired confidence bounds and number of simulations. The module will perform the simulation statistics to generate the bootstrap distribution and relevant statistics such as the sample mean and bootstrapped confidence interval. The package also has a module for visualization of the bootstrapped confidence interval, and for creating a professional publication-ready table of the relevant statistics.
## Package context within the R ecosystem
The package builds on the [dplyr](https://cran.r-project.org/web/packages/dplyr/) package and the [ggplot2](https://cran.r-project.org/web/packages/ggplot2/) package to achieve the above mentioned functionalities. The [BootCI](https://rdrr.io/cran/DescTools/man/BootCI.html) package seems to streamline the confidence interval process but does not include plotting support. **StrapvizR** streamlines the process of bootstrapping from data to visualization and embedding in documents which is not available as a single bundle. Some tutorials on bootstrap confidence intervals at sources [(1)](https://moderndive.com/8-confidence-intervals.html), [(2)](http://pages.stat.wisc.edu/~larget/stat302/chap3.pdf) and [(3)](https://www.geeksforgeeks.org/bootstrap-confidence-interval-with-r-programming/) encourage the reader to plot the results manually.
## Installation
You can install the latest version of `strapvizr` from GitHub
``` r
# install.packages("devtools")
devtools::install_github("UBC-MDS/strapvizr")
```
## Usage
To import the `strapvizr` package
```{r example}
library(strapvizr)
```
Please find the detailed documentation [here](https://ubc-mds.github.io/strapvizr/).
## Functions
- `bootstrap`: Returns a sampling distribution of specified replicates is generated for a specified estimator with replacement for a given bootstrap sample size.
- `calculate_boot_stats`: Calculates a confidence interval for a given sampling distribution as well as other bootstrapped statistics.
- `plot_ci`: Creates a histogram of a bootstrapped sampling distribution with its confidence interval and observed sample statistic.
- `tabulate_stats`: Generates a table that contains a given sampling distribution's mean and standard deviation along with relevant statistics as well as a summary table of the bootstrap distributions parameters. The code automatically saves the tables as html documents.
## Contributing
Julien Gordon, Gautham Pughazhendhi, Zack Tang, and Margot Vore.
## License
\`StrapvizR\` was created by Julien Gordon, Gautham Pughazhendhi, Zack Tang, Margot Vore. It is licensed under the terms of the MIT license.