Set Up Your Development Environment

Before we can get down to the business, we need to make sure we have the right tools for the job. If you follow these instructions (with help from our amazing NINJA team), your computer will be primed and ready to do some serious computational work.

Initially, the amount of new stuff here may seem intimidating. Please do not let this discourage you! We (NINJAs and faculty) will provide lots of help and guidance along the way to help you setup, and then gain comfort with your new toolset. The process will start at the end of the first class, and will continue with additional NINJA / faculty office hours to help you complete the process successfully. Additionally, you will gain familiarity and comfort with this toolset as the semester progresses. In other words, you should think of learning the toolset as a process and not something that you need to do all at once.

A note about variations on the instructions

The instructions below will allow you to setup the “officially supported” environment for SoftDes. Some deviations from the setup below are okay while others are not (when in doubt please ask). That being said, it will likely be more difficult for us to help you debug problems with your setup if you have a nonstandard environment.

Step 1: Install Ubuntu

Our officially supported OS is Ubuntu 16.04.3 64-bit (link to ISO - huge file). There are two ways configure Ubuntu on your computer: dual boot and virtual machine.

Dual Boot (preferred)

The preferred method for installing Ubuntu is to use what’s known as a dual boot. In this setup, you will have Ubuntu installed alongside Windows. Upon startup of your computer, you will be able to choose which OS to boot into. If you are going to be using a dual boot setup, the easiest way to get up and running is to use one of the provided SoftDes thumb drives. These thumb drives have been pre-loaded with a bootable installer for Ubuntu 16.04.3.

Creating Space for an Ubuntu Partition

In order to install Ubuntu on your computer, you will need to create a partition on your disk drive. Luckily, Ubuntu’s installer can do most of this for you, however, this will only work if you have unpartitioned space on your drive. The easiest way to create unpartitioned space on your drive is to shrink the size of your Windows partition. In this way, unused drive space that is currently allocated to Windows will now be allocated to Ubuntu.

To shrink your Windows volume, you need to open up the Windows “Disk Management” utility. The easiest way to do this is to click the Windows button in the lower lefthand corner of the screen and enter “diskmgmt.msc” into the box and press enter. Once you are in the Disk Management utility, check to see if you have any unallocated (or unpartitioned space). If you do (about 50 GB is a good number), there is no need to do anything. If you don’t (which is the likely case), click on the largest partition and then click the “Shrink Volume” button. This button will prompt you to enter how much you’d like to shrink your volume by. We recommend choosing at least 50GB (you will enter 50,000 into the utility since it uses MB as its default units). Once you have shrunk your volume, you will now have space to use for installation of Ubuntu.

Before beginning the Ubuntu install, you should restart your computer to make sure that Windows has a chance to scan the new partition and update its boot loader.

Installing from the Bootable USB Drive

Next, insert the thumb drive, reboot your computer, and hold the F12 key before your computer starts to load Windows. Depending on your system, one of two things will happen. If you have an Olin first-year laptop, you will be able to select which device you’d like to boot from (go ahead and select the USB drive). If you have another type of system, you may see your computer’s BIOS menu. Use the arrow keys to select boot from “USB Storage Device”. If everything has gone properly, you will see a menu with entries such as “Install Ubuntu” and “Try Ubuntu”. Select “Install Ubuntu” and the installation process will begin.

Most of the Ubuntu installation should proceed without much intervention on your part. Here are a few things to keep in mind.

  1. When it asks you what type of installation you’d like, make sure to select the option that says something like “install Ubuntu beside Windows”.
  2. Don’t worry about connecting to a network during install (you can click the box that says “Don’t connect to a network”).
  3. Click the option “Install 3rd Party Software”

Once you’ve booted into Ubuntu, the first thing you’ll probably want to do is get setup with the wireless. For your convenience, we have copied the instructions from IT’s Linux Wiki on how to sign into the Olin network.

Wireless configuration:

  1. Click the NetworkManager icon in the system tray, which is normally just to the left of the speaker icon.
  2. Select the OLIN wireless network.
  3. Set Authentication to Protected EAP (PEAP).
  4. In the Username: field, enter your Windows username followed by “@olin.edu”. Note that this is not your email address! For example, Joe Student would enter jstudent@olin.edu.
  5. In the Password: field, enter your Windows password.
  6. Click Connect.
  7. You will receive a warning reading “No Certificate Authority certificate chosen”. Click the box to the left of Don’t warn me again to ignore future warnings and click Ignore.

Virtual Machine

Another option is to use a virtual machine. In this variant you will run Ubuntu inside of a window inside of the Windows operating system (or Mac OSX if that is what you have). We will also have thumb drives on hand that can be used to install Ubuntu as a virtual machine. We recommend the freely available program Virtual Box if you are running a VM. Here are some guidelines to follow if you wind up using a VM.

  1. Make sure to allocate at least 2 CPUs (preferably 4) and at least 2 GB (preferably 4GB) of RAM to your Ubuntu VM.
  2. If you are using VirtualBox, make sure to install the VirtualBox Guest Additions once your Ubuntu is up and running.
  3. If you are using VirtualBox and are experiencing sluggish performance, consider checking the “Use Host I/O Cache” box in the settings.

Post Installation Configuration

To make sure your installation is up to date, you should run the following commands at the Linux terminal. To open the terminal you can click on the “Search Your Computer” button in the top left of the Ubuntu desktop and type “terminal”. Note: that we use the convention of preceding a terminal command with the dollar sign (you don’t actually need to type the dollar sign into the terminal).

$ sudo apt-get update
$ sudo apt-get upgrade

You may find IT’s instructions useful for completing tasks such as setting up printers and the like (warning: these are somewhat out of date).

Step 2: Install Python

[Adapted from Modeling and Simulation in Python, by Allen Downey.]

You might already have Python installed on your computer, but you might not have the latest version. To use the materials in this course, you need Python 3.6, or later. Even if you have the latest version, you probably don’t have all of the libraries we need.

You could update Python and install these libraries, but I strongly recommend that you don’t go down that road. I think you will find it easier to use Anaconda, which is a free Python distribution that includes many of the libraries you need in this course (and lots more).

Anaconda is available for Linux, macOS, and Windows. By default, it puts all files in your home directory, so you don’t need administrator (root) permission to install it, and if you have a version of Python already, Anaconda will not remove or modify it.

To install Anaconda, visit the Anaconda install page. One quick note is that at the end of the install process you will be asked whether to prepend the path to anaconda to your .bashrc file. You should select ‘yes’ to this prompt. As the installer says, you will then need to open a terminal for this change to take effect.

Step 3: Verify Jupyter

Run jupyter -h to check if Jupyter is installed.

If Jupyter was not installed automatically with Anaconda, you should run

$ conda install jupyter

Step 4: Get Started with Git

We will make heavy use of Git (and GitHub in this class). Haven’t heard of Git? That’s totally fine (and totally expected). Before we do some course-specific Git stuff, take some time to read Chapter 1 of Allen’s excellent online book called AmGit.

Install Git

If you just installed Ubuntu, you will need to install Git using the instructions below. If you had an existing Ubuntu installation, Git may already be installed on your system. Enter git --version into a terminal window to test. If this prints something like git version 2.14.1, you are good to go. (The exact number doesn’t matter, so long as it’s 2.something.)

Otherwise, you can install it from the terminal by running the command

$ sudo apt-get install git

Set up your Git identity by following the instructions in Chapter 1.

Create a GitHub Account

Now that you have the basic idea of what version control is and what it is good for, you are going to take the next step and sign up for an account on a website called GitHub. The second chapter of Allen’s book has a nice description of GitHub, and how to make an account.

GitHub is a web-based hosting service for Git users. In general a hosting service provides storage space on remote servers, network access, and tools and applications for interacting with stored data. GitHub provides storage for Git repositories and tools for interacting with them.

There are other hosting services for Git, but GitHub is one of the most popular. It is so popular that people sometimes say “GitHub” when they mean “Git”, so just to be clear:

  • Git is an application that runs on your computer and helps you manage repositories.
  • You can use Git to manage repos stored on your own computer or on any computer configured as a Git server.
  • Anybody can set up and run a Git server. A company that runs Git servers professionally is a Git hosting service.
  • GitHub is one of many Git hosting services.

Ok, go to https://github.com. If you already have an account, log in. Otherwise, you will have to create one.

You can choose any available username you like, but there are a few things you might want to think about:

  1. Working on GitHub involves interacting with other people. They will see your username, so choose wisely.
  2. Some people, like AllenDowney, use their full names, but the most common schema seems to be one-word lower-case usernames. For example, Scott Chacon is schacon.
  3. If you want to be anonymous, you can choose a username unrelated to your real name; however,
  4. Many software engineers use GitHub as part of their professional portfolio. If a potential employer wants to check out your skills, they might look at your GitHub repositories.

It is probably a good idea to think of everything you do on GitHub as part of your public professional reputation.

Get the Reading Journal

We will be using GitHub for a number of use cases in the class.

Since there’s reading due next class, you will need to perform the steps below to setup your personal ReadingJournal repository.

  1. Click on the invitation link https://classroom.github.com/a/wVVupiFP
  2. Click the green button “Accept this assignment”.
  3. Follow the remaining instructions until you get to your repository page. It will looks something like https://github.com/sd18spring/ReadingJournal-myname, except with your GitHub user id instead of myname.
  4. Clone the repository to your computer by typing the following into your terminal program. Replace myname with your GitHub user id.
$ git clone https://github.com/sd18spring/ReadingJournal-myname.git ReadingJournal

Now you have a copy of the ReadingJournal folder (directory) on your drive. Use the terminal or Ubuntu File Manager to verify that it is present.

Next, you can fire up Jupyter notebook and load the reading journal for day X.

$ cd ReadingJournal
$ jupyter notebook reading-journal-01.ipynb

If all goes well, this should bring up a web-browser with the reading questions.

Step 5. Install Atom

  1. Download and install the Atom text editor onto your computer. Note: if you have a brand new install of Ubuntu, you may need to run sudo apt-get install curl before following these instructions.
  2. Follow the Atom Basics instructions to create a text file and save it.
  3. Follow the Atom Packages instructions to find and install the following packages: python-tools, trailing-spaces, Hydrogen.