Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chris-prener/testdriver
R package with data for teaching Statistics and Data Science
https://github.com/chris-prener/testdriver
datascience package r rstats statistics teaching
Last synced: about 23 hours ago
JSON representation
R package with data for teaching Statistics and Data Science
- Host: GitHub
- URL: https://github.com/chris-prener/testdriver
- Owner: chris-prener
- License: gpl-3.0
- Created: 2017-06-24T02:26:51.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2025-02-02T19:10:56.000Z (3 days ago)
- Last Synced: 2025-02-02T19:31:51.729Z (3 days ago)
- Topics: datascience, package, r, rstats, statistics, teaching
- Language: R
- Homepage: https://chris-prener.github.io/testDriveR/
- Size: 1.54 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.Rmd
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
---
output: github_document
---
```{r, echo = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "README-"
)
```
# testDriveR 
[](https://cran.r-project.org/package=testDriveR)
[](https://cran.r-project.org/web/checks/check_results_testDriveR.html)
[](https://www.r-pkg.org/pkg/testDriveR)
[](https://doi.org/10.32614/CRAN.package.testDriveR)
[](https://zenodo.org/badge/latestdoi/95270521)
The goal of `testDriveR` is to provide data sets for teaching statistics and data science courses. This package includes a sample of data from John Edmund Kerrich's famous coin flip experiment. These are data that I used for teaching [SOC 4015 / SOC 5050](https://slu-soc5050.github.io) at [Saint Louis University](https://www.slu.edu).
The package also includes an R Markdown template for completing assignments. This was the *required* format for authoring R Markdown documents in my courses [SOC 4015 / SOC 5050](https://slu-soc5050.github.io) and [SOC 4650 / SOC 5650](https://slu-soc5650.github.io) at [Saint Louis University](https://www.slu.edu). A quick overview is included below.
## Installation
The easiest way to get `testDriveR` is to install it from CRAN:
``` r
install.packages("testDriveR")
```
You can also install the development version of `testDriveR` from [Github](https://github.com/chris-prener/testDriveR) with `remotes`:
```{r gh-installation, eval = FALSE}
remotes::install_github("chris-prener/testDriveR")
```
## Current Data
The package currently contains five data tables:
* `auto17` - A data set containing model year 2017 vehicles for sale in the United States
* `childMortality` - A data set containing childhood mortality time series data by country from UNICEF
* `gss14` - A data set containing a selection of variables related to work and education from the 2014 General Social Survey
* `gss14_simple` - A simple version of `gss14` without factors created and without missing data explicitly declared
* `kerrich` - A data set containing 2000 trials of coin flips by [John Edmund Kerrich](https://en.wikipedia.org/wiki/John_Edmund_Kerrich)
### Usage
Once loaded, the data contained in `testDriveR` can be loaded into data frames in your global environment and then explored. For example, to load the `auto17` data:
```r
library("testDriveR")
autoData <- auto17
str(autoData)
```
### Data Creation
If you are interested in the original data/code used to create the included data, you can find them at:
* `auto17` is documented in [Chris's `autoData` repository](https://github.com/chris-prener/autoData)
* `childMortality` is documented in [Chris's `childMortality` repository](https://github.com/chris-prener/childMortality)
* `gss14` and `gss14_simple` are documented in [Chris's `gss14` repository](https://github.com/chris-prener/gss14)
* `kerrich` is documented in the [`extdata` directory](/inst/extdata/kerrich.R)
## R Markdown Template
The package also includes a template that my students use for getting started with `R` based assignments. It can be accessed from within RStudio by going to `File > New File > R Markdown...` and then selecting `SLU Sociology Assignments` under `Template`:
The template includes `YAML` for generating both `.nb.html` and `.md` output, a pre-formatted date that updates each time the document is knit, and initial code blocks for loading dependencies and data.
## Contributor Code of Conduct
Please note that this project is released with a [Contributor Code of Conduct](https://chris-prener.github.io/testDriveR/CODE_OF_CONDUCT.html). By participating in this project you agree to abide by its terms.