Software Install Instructions for OSX

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

  1. Python 3.6.5
  2. A bunch of Python Modules
  3. Git 2.17

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 1 : 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!

Step 2: 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 http://ist256.syr.edu/content/install/osx/python-3.6.5-macosx10.9.pkg
  2. After the file is downloaded, we can install Python. Command to type:
    ./python-3.6.5-macosx10.9.pkg
    The setup will take a minute or so. Be patient.
  3. 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!
  4. 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 3: 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 download a 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 4: Install the git utility.

  1. First we will download Python to our computer. Command to type:
    curl --remote-name http://ist256.syr.edu/content/install/osx/git-2.17.0-intel-universal-mavericks.dmg
  2. After the file is downloaded, we can install Git. Command to type:
    ./git-2.17.0-intel-universal-mavericks.dmg /SILENT
    The setup will take a minute or so. Be patient.
  3. 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!
  4. Try out python to see if it works. Type this command.
    git --version
    If it works, you will see 2.17 in your terminal window as the Git version. If so you’re done!

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

  1. Git
  2. Python 3
  3. Jupyter notebook

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

  1. Install the xcode command line tools. This will install the git utility.
    1. Open the command line / terminal window.
    2. From the terminal application’s command line, type: xcode-select --install Then press the ENTER key to send the command.
    3. The on-screen prompt will say The “xcode-select” command requires the command line developer tools. Click the Install button.
    4. Verify git was installed by typing the following in the terminal window: git --version
    5. Close the terminal window.
  2. Install Miniconda. This will install Python 3 programming language and configure it on your Mac.
    1. Open the command line / terminal window.
    2. Use the Safari web browser to download the Miniconda installer at this URL: https://repo.continuum.io/miniconda/Miniconda3-latest-MacOSX-x86_64.sh
    3. Go back to your terminal window. Type the following at the command line cd ~/Downloads and press the ENTER key. This will switch the current working directory to the Downloads folder where you downloaded Miniconda.
    4. From the terminal command line, type: sh Miniconda3-latest-MacOSX-x86_64.sh and press the ENTER to execute the miniconda installer.
    5. Follow the on-screen instructions. Press the ENTER key to see the license.
    6. Press q to quit the license.
    7. Type yes then press ENTER to agree to the license terms.
    8. You will be asked where to install miniconda. Accept the default and press ENTER to install.
    9. The install will setup several packages. When asked to prepend to PATH type yes and press the ENTER key.
    10. When the install is complete, close the terminal window.
    11. To verify the setup re-open a new terminal window and type the following at the command line: python --version It should report Python 3.5 or higher. If not, please repeat these steps carefully.
  3. Install Jupyter. This will install the Jupyter Notebook environment.

    1. Open the command line / terminal window.
    2. From the command line, type pip install jupyter then press the ENTER key.
    3. This will install several other package dependencies and may take a few minutes.
    4. When the install is complete, you can verify Jupyter is working by typing the following at the command line: jupyter-notebook and press the ENTER key. If it works, you will see Jupyter open in your web browser. To exit Jupyter, close the browser, return to the command line and press CTRL+C two times.
    5. Close the terminal window.
  4. Open the command line /