This repository contains the source code for a MOSAIC Project tutorial. It is intended for statistics instructors who would like to write their own Shiny apps for classroom use.
Shiny makes it easy for R users to develop responsive, R-powered web applications. As you probably know, either from your own initial forays into Shiny or from the Shiny Tutorial, creating simple apps is no problem, and probably you have some ideas for teaching apps that could be written using just the tools developed in the Tutorial.
But some teaching apps appear to be quite complex. Consider, for example, this app which aims to introduce the student to the Chi-Square Test for Goodness of Fit. The app takes the user through a simulation process, keeping track of the results of simulations as they accumulate, permitting the viewer to consider the results from several points of view, and allowing the viewer to start over, perhaps with new data.
The aim of this tutorial is to take you step-by-step through the construction of a reasonably full-featured simulation app that lets students explore, through simulation, the coverage properties of the classical t-intervals for a population mean. After completing the tutorial you will be able to write your own simulation apps---hopefully having been spared some of the struggle that I went through when I first learned Shiny in the Spring of 2014.
This tutorial assumes that you have:
- familiarity with R. We'll assume some basic facility in R programming and that you can at least read and understand R code that creates custom plots in R's base graphics system. For the most part our explanation of R code will be limited to its relationship to app-building.
- an introductory knowledge of Shiny. All necessary prerequisites in this area can be acquired by watching Garret Grolemund's excellent three-part webinar on How to Start with Shiny. (See R Studio's webinars page.)
The tutorial is a runtime: shiny
R Markdown document. I would like to host it that way, but many students from the Coursera Data Science spcialization visit this site and my shinyapps.io
account is capped at 500 hours per month. Therefore, in order to view the tutorial you must run it on your own machine by following one of these two procedures.
- Clone this repo into your computer (or fork onto your GitHub account and then clone).
- In the cloned repo, open the directory
sim_tutorial_Rmd
and find the filetutorial_sim.Rmd
. - Open the file and run it. (It runs as a local shiny app.)
- Enjoy!
If you don't use Git, then:
- Download this repo as a zipped file using the Download Zip button on the right above.
- Extract the repo into a directory of your own choosing.
- Open RStudio, open the directory
sim_tutorial_Rmd
and find the filetutorial_sim.Rmd
. - Open the file and run it. (It runs as a local shiny app.)
- Enjoy!