Installation¶

Installing the Stable Version¶

There are two options for installing the stable version of ndcube. The first is via the anaconda distribution using the conda-forge channel. For more information on installing the anaconda distribution, see the anaconda website.

$ conda install --channel conda-forge ndcube

To update ndcube do:

$ conda update ndcube

The second option for installing the stable version of ndcube is via pip.

$ pip install ndcube

Then to update ndcube do:

$ pip install ndcube --upgrade

Installing the Development Version¶

The stable version of ndcube will be reliable. However, if you value getting the latest updates over reliablility, or want to contribute to the development of ndcube, you will need to install the development version via GitHub. Let’s step through how to do this using anaconda. For information on installing the anaconda distribution, see the anaconda website.

First, create a conda environment on your local machine to hold the ndcube bleeding edge version. Using a new environment allows you to keep your root environment for stable package releases. Let’s call the new conda environment ndcube-dev. Type the following into a terminal:

$ conda config --append channels conda-forge
$ conda create -n ndcube-dev sunpy hypothesis pytest-mock pip sphinx coverage ipython jupyter

Be sure to activate the environment, i.e. switch into it. In Linux or MacOS, type:

$ source activate ndcube-dev

In Windows, type:

> activate ndcube-dev

Next clone the ndcube repo from GitHub to a new directory. Let’s call it ndcude-git.

$ git clone https://github.com/sunpy/ndcube.git ndcube-git

To install, change into the new directory and run the install script.

$ cd ndcube-git
$ pip install -e .

Voila! The ndcube development version is now installed! Be sure you get the latest updates by regularly doing:

$ git pull origin master