configure_anaconda.md

Configure and Manage Your Environment with Anaconda

Per the Anaconda docs:

Conda is an open source package management system and environment management system for installing multiple versions of software packages and their dependencies and switching easily between them. It works on Linux, OS X and Windows, and was created for Python programs but can package and distribute any software.

Overview

Using Anaconda consists of the following:

1. Install miniconda on your computer
2. Create a new conda environment
3. Each time you wish to work, activate your conda environment

---

Installation

Download the version of miniconda that matches your system. Make sure you download the version for Python 3.6.

NOTE: There have been reports of issues creating an environment using miniconda v4.3.13. If it gives you issues try versions 4.3.11 or 4.2.12 from here.

	Linux	Mac	Windows
64-bit	64-bit (bash installer)	64-bit (bash installer)	64-bit (exe installer)
32-bit	32-bit (bash installer)		32-bit (exe installer)

Install miniconda on your machine. Detailed instructions:

• Linux: http://conda.pydata.org/docs/install/quick.html#linux-miniconda-install
• Mac: http://conda.pydata.org/docs/install/quick.html#os-x-miniconda-install (Mac users please see this thread for possible issues with Jupyter if you have recently updated OSX)
• Windows: http://conda.pydata.org/docs/install/quick.html#windows-miniconda-install

Setup your NumPy environment.

OS X and Linux

Open the terminal and cd to your project directory

Windows

Navigate to your project folder. Right click and click GIT bash here

Clone the repository

git clone https://github.com/allthatido/NumPy_beginner_tutorial.git
cd NumPy_beginner_tutorial

Create NumPy_tut. Running this command will create a new conda environment that is provisioned with all libraries you need in this program.
NOTE: if you get an error when you try to run this command that conda doesn't exist, try closing and re-opening your terminal window.

conda env create -f environment.yml

NOTE: If the above command fails due to internet issues or timed out HTTP request then remove the partially built environment using the following command (then run the above create command again):

conda env remove -n NumPy_tut
conda env create -f environment.yml

Verify that the NumPy_tut (listed NumPy_tut) environment was created in your environments:

conda info --envs

Cleanup downloaded libraries (remove tarballs, zip files, etc):

conda clean -tp

Using Anaconda

Now that you have created an environment, in order to use it, you will need to activate the environment. This must be done each time you begin a new working session i.e. open a new terminal window.

Activate the NumPy_tut environment:

OS X and Linux

$ source activate NumPy_tut

Windows

Depending on shell either:

$ source activate NumPy_tut

or

$ activate NumPy_tut

Uninstalling

If you ever want to delete or remove an environment

To delete/remove the "NumPy_tut" environment:

conda env remove -n NumPy_tut