Windows

1. Install Ubuntu for Windows
   1. Open the Microsoft Store
   2. Search for 'Ubuntu'
   3. Select Ubuntu 18.04 and hit install
2. Enable the Windows Subsystem for Linux
   1. Open the Windows Power shell as an administrator
      1. Click the Windows icon in the lower left corner of your screen to open the start menu
      2. In the start menu, search for "Powershell"
      3. Right click on the Microsoft Powershell icon and select "Run as administrator"
      4. When prompted, click Yes to allow powershell to modify your device
   2. In the Powershell enter the following command:

      
      Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
      	      

   3. Close power shell
3. Restart your computer
   1. Click the Windows icon in the lower left corner of your screen to open the start menu
   2. Click the Power icon in the start menu
   3. Select Restart
4. Open the "Ubuntu" application
   1. Click the Windows icon in the lower left corner of your screen to open the start menu
   2. In the start menu, search for "Ubuntu"
   3. Click the Ubuntu icon in the search results
   4. A black bash window will appear with the message

      
      Installing, this may take a few moments...
      	      

   5. When the installation is complete, you will be prompted to create a username.

      
      Installing, this may take a few minutes...
      Installation successful!
      Please create a default UNIX user account. The username does not need to match your Windows username.
      For more information visit: https://aka.ms/wslusers
      Enter new UNIX username:
      	      

   6. Type a desired username and press enter
   7. You will be prompted to provide a password for the new account.

      
      Enter new UNIX password:
      	      

   8. Type a memorable and secure password and press enter. This password is case-sensitive and cannot be recovered if forgotten. Do not be alarmed if no text appears on the screen as you enter the password.
   9. You will be prompted to confirm the password.

      
      Enter new UNIX password:
      Retype new UNIX password:
      	      

   10. Retype the password and press enter
   11. Assuming the passwords match, a message confirming the password update should appear

       
       Enter new UNIX password:
       Retype new UNIX password:
       passwd: password updated successfully
       	      

   12. A UNIX shell is successfully installed on your system

macOS

The default shell in all versions of macOS is Bash, so no need to install anything. You access Bash from the Terminal (found in /Applications/Utilities). See the Git installation video tutorial for an example on how to open the Terminal. You may want to keep Terminal in your dock for this workshop.

Linux

The default shell is usually Bash, but if your machine is set up differently you can run it by opening a terminal and typing bash. There is no need to install anything.

Windows

Git can be installed on your computer following Bash install (described above).

1. Open a Bash terminal window
   1. Click the Windows icon in the lower left corner of your screen to open the start menu
   2. In the start menu, search for "Ubuntu"
   3. Click the Ubuntu icon in the search results
   4. Click within the black Bash terminal screen that appears
2. Use the apt package manager distributed with Ubuntu to install git
   1. Type sudo apt-get update and press enter
   2. When prompted for a password, enter the password established when installing Bash
   3. Type sudo apt-get install git and press enter
   4. If prompted for a password, again enter the password established when installing Bash

macOS

For OS X 10.9 and higher, install Git for Mac by downloading and running the most recent "mavericks" installer from this list. After installing Git, there will not be anything in your /Applications folder, as Git is a command line program. For older versions of OS X (10.5-10.8) use the most recent available installer labeled "snow-leopard" available here.

Linux

If Git is not already available on your machine you can try to install it via your distro's package manager. For Debian/Ubuntu run sudo apt-get install git and for Fedora run sudo dnf install git.

Windows

nano is a basic editor that can be used for all the modules in this workshop, it is included in the Ubuntu distribution

macOS

nano is a basic editor and the default that instructors use in the workshop. See the Git installation video tutorial for an example on how to open nano. It should be pre-installed.

Others editors that you can use are Text Wrangler or Sublime Text.

Linux

nano is a basic editor and the default that instructors use in the workshop. It should be pre-installed.

Others editors that you can use are Gedit, Kate or Sublime Text.

Windows

1. Install the Xming Windows X11 server
   1. Download the Xming installation wizard
      1. Click the Windows icon in the lower left corner of your screen to open the start menu
      2. In the start menu, search for "Edge"
      3. Click the Microsoft Edge icon in the search results
      4. In Microsoft Edge, click in the text field at the top of the window with the text Search or enter web address
      5. Type https://sourceforge.net/projects/xming/ into the text field and press enter.
      6. Click the green download button
      7. After a short delay, the web page will update and a prompt will appear at the bottom of the Microsoft Edge window.
      8. Select Run in the prompt
      9. An administrative prompt will appear. When prompted, click Yes to allow Xming installation wizard to modify your device
   2. Run the installation Wizard
      1. Click Next
      2. Select an installation location (or accept the default) and click Next
      3. Select Don't install an SSH client and click Next
      4. Click Next
      5. Click Next
      6. Click Install
2. Start the X11 server
   1. Click the Windows icon in the lower left corner of your screen to open the start menu
   2. In the start menu, search for "xming"
   3. Click the Xming icon in the search results
3. Open a Bash terminal window
   1. Click the Windows icon in the lower left corner of your screen to open the start menu
   2. In the start menu, search for "Ubuntu"
   3. Click the Ubuntu icon in the search results
   4. Click within the black Bash terminal screen that appears
4. Forward X11 output
   1. Type

      
      echo export DISPLAY=:0 >> $HOME/.bashrc
                

      into the bash terminal and press enter
   2. Type

      
      source $HOME/.bashrc
                

      into the bash terminal and press enter
   3. Type

      
      sudo apt-get install x11-apps
                

      into the bash terminal and press enter
   4. If prompted for a password, again enter the password established when installing Bash
   5. Type xeyes and press enter
   6. If a pair of cartoon eyes should appear on your screen, X11 forwarding has been configured
   7. Click the X along the edge of the window bar above the eyes
   </ol>
   8. Install a web browser within Ubuntu
      1. Type

         
         sudo apt-get install firefox
                   

         into the bash terminal and press enter
      2. If prompted for a password, enter the password established when installing Bash
   9. Install python3
      1. Type

         
         sudo apt-get install python3
                   

         into the bash terminal and press enter
      2. If prompted for a password, enter the password established when installing Bash
      </li>
      3. After accepting the installation
      4. Type which python and press enter
      5. Ensure this command prints a filepath ending in python3
   10. Install pip
       1. Type

          
          sudo apt-get install python3-pip
                    

          into the bash terminal and press enter
       2. If prompted for a password, enter the password established when installing Bash
   11. Install python packages
       1. Type

          
          sudo apt-get install python3-numpy python3-matplotlib jupyter-notebook
                    

          into the bash terminal and press enter
       2. If prompted for a password, enter the password established when installing Bash
   12. Test python
       1. Type

          
          python
                    

          into the bash terminal and press enter
       2. Within python terminal type

          
          import numpy matplotlib
          exit()
          	      

          This should return to the Bash terminal.
       3. Type jupyter-notebook into the terminal and press enter
       4. A website should launch automatically
       5. Close the browser
   </div>

   macOS

   Video Tutorial

   1. Open https://www.anaconda.com/download/#macos with your web browser.
   2. Download the Python 3 installer for OS X.
   3. Install Python 3 using all of the defaults for installation.

   Linux

   1. Open https://www.anaconda.com/download/#linux with your web browser.
   2. Download the Python 3 installer for Linux.
      (The installation requires using the shell. If you aren't comfortable doing the installation yourself stop here and request help at the workshop.)
   3. Open a terminal window.
   4. Type

      bash Anaconda3-

      and then press tab. The name of the file you just downloaded should appear. If it does not, navigate to the folder where you downloaded the file, for example with:

      cd Downloads

      Then, try again.
   5. Press enter. You will follow the text-only prompts. To move through the text, press the space key. Type yes and press enter to approve the license. Press enter to approve the default location for the files. Type yes and press enter to prepend Anaconda to your PATH (this makes the Anaconda distribution the default Python).
   6. Close the terminal window.
   </div>

   Make

   GNU make is a tool for automating your workflow

   Windows

   1. Open a Bash terminal window
      1. Click the Windows icon in the lower left corner of your screen to open the start menu
      2. In the start menu, search for "Ubuntu"
      3. Click the Ubuntu icon in the search results
      4. Click within the black Bash terminal screen that appears
   2. Install make
      1. Within the terminal, type

         
         apt install build-essential
                   

         into the bash terminal and press enter
      2. If prompted for a password, enter the password established when installing Bash
      3. Type which make and press enter to test

   macOS

   1. It should already be installed
   2. Type

      $ which make

      to test

   Linux

   1. It should already be installed
   2. Type

      $ which make

      to test
   </div>