The biddmodellingcourse package contains the practicals for the BIDD modelling short course at the University of Bristol. It also contains the functions required to run the practicals and solutions.

Getting Started - On The Day

  • The practicals and code should be on the memory stick given to you at the start of the the course. Open the course folder and then open the biddmodellingcourse folder.

  • Verify that you have a working installation of both R and Rstudio, then click on the biddmodellingcourse.Rproj project. This should open an instance of Rstudio.

  • Install the BIDD modelling short course from GitHub using the R terminal (this may take several minutes, if you are having problems talk to a course instructor):

install.packages("devtools")
devtools::install_github("bristolmathmodellers/biddmodellingcourse")
  • You are now ready to start the practicals (see the handouts or the course website (https://bristolmathmodellers.github.io/biddmodellingcourse/)). For practicals that require coding, follow along interactively using the provided notebooks (available in the vignettes folder).

  • The course practicals make use of R notebooks, these allow text and code to be intermingled in a single document. Code is highlighted and separated from the text using ```. To run the code in these chunks click on the green arrow in the right hand side of the chunk, or select the chunk and press enter. To run all code chunks above a given chunk press the grey arrow pointing downwards. The output from each code chunk will be displayed below the code chunk.

Getting Started - Remote Set-up

git clone https://github.com/bristolmathmodellers/biddmodellingcourse.git
  • Now follow the getting started on the day instructions above.

Docker

This package was developed in a docker container based on the tidyverse docker image. Docker containers are lightweight, stand-alone, executable packages of a piece of software that includes everything needed to run it (see here for details). To run the docker image run (with an active docker daemon running):

docker run -d -p 8787:8787 --name biddmodellingcourse -e USER=biddmodellingcourse -e PASSWORD=biddmodellingcourse seabbs/biddmodellingcourse

The rstudio client can be found on port :8787 at your local machines ip. The default username:password is biddmodellingcourse:biddmodellingcourse, set the user with -e USER=username, and the password with - e PASSWORD=newpasswordhere. The default is to save the analysis files into the user directory.