The JupyterHub server at jupyter.math.uwaterloo.ca is available to students for use in courses where they need to access a Jupyter Notebook environment. No extra software is needed beyond your web browser.

1. You can access the server by visiting https://jupyter.math.uwaterloo.ca.

2. Log in with your WatIAM ID and password and click Sign In

   

   It will take a moment for your environment to start up. If this is the first time you have accessed the environment you will be presented with the Launcher.

   

The tiles in the Launcher provide access to a variety of computing and programming environments. You can use any of these environments, but only for coursework. Refer to the University's policies on computer usage for more information about appropriate usage.

You can see a list of directories available to you in the file browser in the left-hand panel.

The directory shown in the screenshot above is your home directory on the server. Double-click the file that starts with !ALERT and a new tab will open with this text file. Please read this file. It explains that content in your home directory on the server could be deleted without notice and is not backed up. It is up to you to ensure you make copies of the files you need on the server. You can add files to your home directory on the server by clicking the Upload button:

You can download files by right-clicking them and choosing Download.

Using Anaconda Navigator

The easiest way to set up JupyterLab to run on your own computer for this course is to use Anaconda.

1. Install Anaconda for your platform

2. Open Anaconda Navigator

3. Create a new Environment to store your work

   1. On the left, click Environments

   2. Click Create

   3. Give your new environment a name (environment name) and choose to include R

   4. Click Create. It may take a while for your environment to appear.

4. With your new environment active click Home on the left

5. Click Install under JupyterLab

6. Click Launch under JupyterLab

Using Command Line and Miniconda

1. Open a terminal/powershell window

2. Create your environment with these commands (The $ represents the command prompt for your shell)
   
   

	$ conda create -n environment name $ conda activate environment name
	(environment name) $ conda install -c conda-forge r-base r-essentials
	(environment name) $ conda install -c conda-forge jupyterlab
	(environment name) $ Rscript.exe pkg-list.R
	(environment name) $ jupyter lab

Jupyter notebooks are divided into cells. Cells can contain code, or they can contain explanatory text/documentation.

Code Cells

Cells that contain code can be edited by clicking in them. And when selected they can be run in a few different ways:

1. Clicking the Run button on the toolbar
   

2. Clicking Run > Run Selected Cells on the main menu bar
   

3. By pressing Shift+Enter on your keyboard

In all cases, after you run a cell, any output from the code within the cell will be shown below the cell.

If the code produces warnings or errors, they are shown below the cell in red.

Documentation Cells

When a cell contains explanatory text rather than code, it is generally stored in a text format called Markdown. When you edit these cells, you are editing plain text.
When you run a cell with Markdown in it like this:

It produces nicely formatted text like this: