Software

OS		Status
Linux & macOS
Windows

This course is best followed if you can reproduce the examples and tutorials provided with it. To do so, you will need to install in your machine a series of software packages. These are all open-source and available for free to download. Although there are several ways to approach this process, we first enumerate here the list of dependencies and then show two simple approaches to install them in different platforms.

Complementary material to this guide

This guide assumes you have the following additional files, available to download by clicking (to download them, right click on the link and select the “save as” option):

Installation

Anaconda

The easiest way to install locally and natively the software stack required is to install a full scientific Python distribution. Although other good alternatives are also available (e.g. Canopy, Sage), we recommend to install Anaconda. Make sure, whichever option you pick, to install a Python 3.5 version, NOT Python 2. Please follow the instructions provided in the link for installation.

Once you have a fully working Anaconda distribution installed in your computer, you can setup an isolated environment that contains all the required libraries by running the install script provided with this guide. Exact instructions vary depending on the platform you are on.

macOS/Linux

Open up a terminal (“Applications –> Utilities –> Terminal” in macOS and “ctr+alt+T” in Linux) and run the following commands:

Navigate to the folder where this file is (e.g. Downloads):
```
  cd /path/to/folder/
```

Execute the following command:

  conda-env create -f install_gds_stack.yml

Once this has run, you should be able to activate the environment:
```
  source activate gds
```

Windows

Open up the Anaconda Command Prompt (search for it on the Startup Menu) and run the following commands:

Navigate to the folder where this file is (e.g. Downloads):
```
  cd /path/to/folder/
```

Execute the following command:

  conda-env create -f install_gds_stack.yml

Once this has run, you should be able to activate the environment:
```
  activate gds
```

Check

To check things have installed correctly, an additional file is included, check_gds_stack.ipynb. To run the check, open a terminal (macOS/Linux) or the Anaconda Command Prompt (Windows), navigate to the folder as showed above and activate the environment:

macOS/Linux:
```
  source activate gds
```
Windows:
```
  activate gds
```

You should now see (gds) on the beginning of the line at the terminal/command prompt. You can now run the test as:

jupyter nbconvert --execute check_gds_stack.ipynb

This will run and, when finished, produce an HTML file in the same folder. Open it and check there are no errors reported. If that is the case, you are good to go!

Dependencies

The course requires the following libraries to be installed on your machine. The guide above provides instructions to install them satisfactory but, in case you want to install them separately on your own (recommended only if you know what you’re doing), this is the list: