Mac OS X

Miniconda

1. Download and install Miniconda using the following instructions https://docs.conda.io/projects/conda/en/latest/user-guide/install/macos.html

2. Open Terminal to execute the following commands.

3. Add the conda-forge channel

   conda config --add channels conda-forge
   

   The conda-forge channel provides multitude of community maintained packages. Find out more about it here https://conda-forge.org/

4. Create a virtual environment in conda

   conda create --name cubeenv python=3.6 datacube
   

5. Activate the virtual environment

   source activate cubeenv
   

   Find out more about managing virtual environments here https://conda.io/docs/using/envs.html

6. Install other packages

   conda install jupyter matplotlib scipy
   

   Find out more about managing packages here https://conda.io/docs/using/pkgs.html

Datacube is now installed and can be used in Terminal by activating the cubeenv environment.

Manual Installation (Fallback)

Only follow these steps if the Miniconda installation does not suit your needs.

Note

This section was typed up from memory. Verification and input would be appreciated.

See also Mac and Homebrew install instructions.

Required software

Homebrew:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

HDF5, netCDF4, and GDAL:

brew install hdf5 netcdf gdal

Python and packages

Python 3.5+ is required (3.6 is recommended)

Download the latest version of the software from the repository and install it:

git clone https://github.com/opendatacube/datacube-core
cd datacube-core
git checkout develop
python setup.py install

It may be useful to use conda to install binary packages:

conda install psycopg2 gdal libgdal hdf5 rasterio netcdf4 libnetcdf pandas

Note

Usage of virtual environments is recommended