Software Install Instructions for Windows

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 (PowerShell)

  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:
    wget http://ist256.syr.edu/content/install/win/install.txt -OutFile install.ps1 | Powershell -File install.ps1
    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:
    python --version
    jupyter-notebook --version
    pip --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 need to update PowerShell to use the latest SSL protocol. Type:
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  2. Now we will download Python to our computer. Command to type:
    wget https://www.python.org/ftp/python/3.6.6/python-3.6.6-amd64.exe -OutFile python-3.6.6-amd64.exe
  3. After the file is downloaded, we can install Python. Command to type:
    .\python-3.6.6-amd64.exe /passive InstallAllUsers=0 PrependPath=1 SimpleInstall=1
    The setup will take a minute or so. Be patient.
  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. Try out python to see if it works. Type this command.
    python -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 components 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:
    python -m pip install --upgrade pip
  2. Next we install the Python JupyterLab environment we will use to write our code.
    pip 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:
    pip 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:
    pip 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. Again, first we need to update PowerShell to use the latest SSL protocol. Type:
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  2. First we will download Git to our computer. Command to type:
    wget https://github.com/git-for-windows/git/releases/download/v2.18.0.windows.1/Git-2.18.0-64-bit.exe -OutFile git-2.18.0-64-bit.exe
  3. After the file is downloaded, we can install Git. Command to type:
    ./git-2.18.0-64-bit.exe /SILENT
    The setup will take a minute or so. Be patient.
  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. 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!