Mac OS X

Miniconda

  1. Download and install Miniconda using the following instructions https://conda.io/docs/user-guide/install/macos.html
  2. Open Terminal to execute the following commands.
  1. 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/

  2. Create a virtual environment in conda
    conda create --name cubeenv python=3.6 datacube
    
  3. Activate the virtual environment
    source activate cubeenv
    

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

  4. 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