Ubuntu¶
Miniconda¶
- Download and install Miniconda using the following instructions https://conda.io/docs/user-guide/install/linux.html
- Open your favourite terminal to execute the following commands.
- 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/
- Create a virtual environment in conda
conda create --name cubeenv python=3.6 datacube
- Activate the virtual environment
source activate cubeenv
Find out more about managing virtual environments here https://conda.io/docs/using/envs.html
- 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 a terminal by activating the cubeenv environment.
Manual Installation (Fallback)¶
Only follow these steps if the Miniconda installation does not suit your needs.
Required software¶
HDF5, and netCDF4:
apt-get install libhdf5-serial-dev libnetcdf-dev
GDAL:
apt-get install libgdal1-dev
Optional packages (useful utilities, docs):
apt-get install postgresql-doc-9.5 libhdf5-doc netcdf-doc libgdal1-doc
apt-get install hdf5-tools netcdf-bin gdal-bin pgadmin3
Python and packages¶
Python 3.5+ is required. Python 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