Software Install Instructions for OSX

For this course you will need to install the following applications:

  1. Python 3.6.6
  2. A bunch of Python Modules
  3. Git 2.18

Each of these applications are free / open-source and will not cost you any money. Detailed instructions for how to install these applications are provided below.

Before You Begin

Setup Procedure

Step 0 : Folder and Command Line

  1. Create a folder called IST256. You can make this folder where ever you want: on your desktop, in your Documents, etc… What’s most important is to remember where it is and how to find it!
  2. Open the command line on your computer inside this folder. For more info, read: How Do I Open The Command Line?
  3. Check yourself. From the command line, type: pwd and press the ENTER key. Does the Path have IST256 at the end? Then you are in the correct folder and may proceed!

Automatic Setup Instructions (Beta)

Why not try the automated setup first? If it works for you, woot!

  1. From the command line, type:
    curl -o install.sh http://ist256.syr.edu/content/install/osx/install.txt && bash install.sh
    This will start the process of installing everything.
    This will take a few minutes to complete.
    NOTE: You may have to enter your administrator password.
  2. When the setup is complete, check the reported versions output by the setup script. They should be:
    Python 3.6.6
    Jupyter 5.6.0
    Pip 18.0
    Git 2.18.0
  3. You can check these yourself if you like with these commands: python3 --version
    jupyter-notebook --version
    pip3 --version and
    git --version

If everything reports correctly, you are done!
Complete the rest of the Course Setup Checklist

Manual Setup Instructions

ONLY DO THESE IF YOUR AUTOMATIC SETUP DOES NOT WORK!

Step 1: Install Python

First we will install Python. From the command line, type each of these and press ENTER to execute them:

  1. First we will download Python to our computer. Command to type:
    curl --remote-name https://www.python.org/ftp/python/3.6.6/python-3.6.6-macosx10.9.pkg
  2. After the file is downloaded, we can install Python. Command to type:
    sudo installer -pkg python-3.6.6-macosx10.9.pkg -target /
    NOTE: You will need to type your admin password at the command prompt. The setup will take a minute or so. Be patient.
    When it is finished it will say: installer: The install was successful
  3. Execute the following command to setup the python environment:
    sh /Applications/Python\ 3.6/Update\ Shell\ Profile.command
  4. Close the command line window, then re-open the command line in your IST256 folder. This is an important step. Python will not work unless you do this!
  5. Make sure you’re using the correct version. When you type: python3 --version it should say. Python 3.6.6.
  6. Try out python to see if it works. Type this command.
    python3 -c "print('YAY')"
    If it works, you will see YAY in your terminal window. If so, it’s time to move on to the next step. If you see errors, something went wrong with the previous steps.

Step 2: Install Python modules

Next we will install the common Python modules we will use in this course. This will save you a lot of time and headaches later on!

  1. First we will upgrade pip Python’s package manager. From the command line, type:
    python3 -m pip install --upgrade pip
  2. Next we install the Python JupyterLab environment we will use to write our code.
    pip3 install --upgrade ipython jupyter jupyterlab setuptools wheel
    This will take a while as it downloads these modules and their dependencies from the internet.
  3. Next we install more modules we will use in this course. Type:
    pip3 install -U geocoder lxml terminado numpy scipy requests
    Again, this might take a few minutes, so be patient.
  4. Finally, we install the last round of Python modules we will use in this course. Type:
    pip3 install -U pandas matplotlib plotly cufflinks folium bs4
    And as usual it will take some time to install these modules.
  5. You can verify Jupyter is working by typing the following at the command line:
    jupyter-lab
    If it works, you will see Jupyter Lab open in your web browser. To exit Jupyter, close the browser, return to the command line and press CTRL+C two times.
  6. Close the terminal window.

Step 3: Install the git utility.

  1. First we will download Python to our computer. Command to type:
    curl -o git-2.18.0-intel-universal-mavericks.dmg -L https://sourceforge.net/projects/git-osx-installer/files/git-2.18.0-intel-universal-mavericks.dmg/download?use_mirror=autoselect -O
  2. After the download we can mount the image:
    hdiutil attach git-2.18.0-intel-universal-mavericks.dmg
  3. After the mount completes, we can install Git. Command to type:
    sudo installer -pkg /Volumes/Git\ 2.18.0\ Mavericks\ Intel\ Universal/git-2.18.0-intel-universal-mavericks.pkg -target /
    The setup will take a minute or so. Be patient.
    When it is finished it will say: installer: The install was successful.
  4. Umount the the image:
    hdiutil detach /Volumes/Git\ 2.18.0\ Mavericks\ Intel\ Universal
  5. Close the command line window, then re-open the command line in your IST256 folder. This is an important step. Python will not work unless you do this!
  6. Try out python to see if it works. Type this command.
    git --version
    If it works, you will see 2.18 in your terminal window as the Git version. If so you’re done!