Clone this repository locally on your laptop.
- Go to the green Clone or download button at the top of the repository page and copy the https link.
- From the command line run the command:
git clone https://github.com/cmawer/pycon-2017-eda-tutorial.git
We recommend using conda for managing your python environments. Specifically, we like miniconda, which is the most lightweight installation. You can install miniconda here. However, the full anaconda is good for beginners as it comes with many packages already installed.
Once installed, you can create the environment necessary for running this tutorial by running the following command from the command line in the setup/
directory of this repository:
conda update conda
then:
conda env create -f environment.yml
This command will create a new environment named eda3
. If you are on Windows or run into errors, try:
conda env create -f environment-noversions.yml
If that still doesn't work:
conda env create -f environment-basic.yml
If that doesn't work, you'll have to trouble shoot!
To activate the environment you can run this command from any directory:
source activate eda3
(Mac/Linux)
activate eda3
(Windows)
If you are experienced in python and do not use conda, the requirements.txt
file is available also in the setup/
directory for pip installation.
We will be using widgets to create interactive visualizations. They will have been installed during your environment setup but you still need to run the following from the commandline:
jupyter nbextension enable --py --sys-prefix widgetsnbextension
Now that your environment is set up, let's check that it works.
- Go to the
setup/
directory from the command line and start a Jupyter notebook instance:
jupyter notebook
a lot of text should appear -- you need to leave this terminal running for your Jupyter instance to work.
-
Assuming this worked, open up the notebook titled
test-my-environment.ipynb
-
Once the notebook is open, go to the
Cell
menu and selectRun All
. -
Check that every cell in the notebook ran (i.e did not produce error as output).
test-my-environment.html
shows what the notebook should look like after running.
If there were errors upon running your notebook (or during any step prior), feel free to ask for help before from your fellow classmates on slack in the operating system channel relevant to you.
However, in an effort to keep this tutorial about EDA and not python package installation, if you cannot get the notebook to run prior to Wednesday, please sign up for an account on Azure Notebooks where we will provide a library that can be cloned and ran in the cloud without any setup or installation.
We recommend everyone sign up just in case problems are ran into during the tutorial.