Installing ndcube

ndcube requires Python 3.7+, astropy 4.2+, and matplotlib.

Installing the Stable Version

There are two options for installing the stable version of ndcube.

The first is via the miniconda distribution using the conda-forge channel. (The anaconda distribution can also be used but because miniconda is more lightweight we recommend it.) For more information on installing the miniconda or anaconda distribution, see the miniconda website.

$ conda config --add channels conda-forge
$ conda config --set channel_priority strict
$ conda install 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 reliability, or want to contribute to the development of ndcube, you will need to install the development version via ndcube GitHub repository. Let’s step through how to do this using miniconda. For information on installing the miniconda distribution, see the miniconda 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 pip

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

$ conda activate ndcube-dev

In Windows, type:

> conda ndcube-dev

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

Note

If you want to develop ndcube, you should fork the repository and then clone your fork here and not the main ndcube repository.

$ 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 .[dev]

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

$ git pull origin main