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