Link Search Menu Expand Document

Getting ready for the workshop

In our workshop, we will be using Python 3 and the Jupyter Notebook environment in order to work with our data. We highly encourage participants to install everything in advance of the session and download the sample files, if possible. If anyone gets stuck, don’t hesitate to reach out to the workshop conveners, Andrew Battista, Katie Wissel, and Daniel Hickey.

Table of Contents

Installation instructions

  1. Download and Install Python with the Anaconda 3 distribution. Although there are many ways to install and run Python, and still many more ways to install the Anaconda 3 distribution and accompanying libraries, we are going to recommend using the appropriate graphical installer from Anaconda.
    • Mac instructions (Note: When you get to step 6, select “install for me only” and install it in a location on your personal user account.)
    • Windows instructions (Note: Make sure to select “just for me” and select the box that registers your Anaconda as the default Python 3.x. You may find these instructions and video tutorial to be helpful.)
    • Linux instructions
  2. Install the pyjanitor library
    Our workshop will be using several libraries that come standard with the Anaconda distribution, but one does not: pyjanitor. In order to install it, we recommend using the conda command.
    • On Mac or Linux: Open a bash prompt, e.g., Terminal and run the command
        conda install pyjanitor -c conda-forge
      
    • On Windows: Your new Anacondas installation should have installed a program called Anaconda Prompt. Open it and run the command
        conda install pyjanitor -c conda-forge
      

Getting the Data

Download the contents of this private Box folder. To do so, you will need a Box account using the email address you used when registering for the workshop. If this is not tenable, please reach out and we will find a different way to give you the data.

Troubleshooting

We have discovered that problems can occur when users have previously installed Anaconda 3 on their machine. If this is happening, the best thing to do is uninstall your Anaconda 3 and then re-install it, making sure you have followed the above directions.

The installation of Anaconda 3 is fairly straightforward, but the Pyjanitor library is not standard and must be installed on top of Anaconda. In our experience, installing cleanly for only a single user on your machine should do the trick.