Download¶
Docker and Singularity¶
The simplest way to download and use RSGISLib and associated packages is via Docker (https://www.docker.com). We provide stable and development Docker images:
Stable: petebunting/au-eoed
Development: petebunting/au-eoed-dev
docker pull petebunting/au-eoed
# Note. for commands below all data and script need to be available in your
# local directory and to be referenced from the /data path.
# Run your rsgislib python script
docker run -i -t -v ${PWD}:/data petebunting/au-eoed python /data/my_rsgislib_script.py
# Run an RSGISLib command line tool
docker run -i -t -v ${PWD}:/data petebunting/au-eoed rsgiscalcimgstats.py -i img.kea -n 0
# Gain access to the docker image terminal
docker run -i -t -v ${PWD}:/data petebunting/au-eoed /bin/bash
For HPC users Docker cannot be used as it requires to execute as root user. However, Singularity (https://sylabs.io) allows Docker images to be imported and executed as a local user.
singularity pull docker://petebunting/au-eoed
# Note. Singularity has the advantage that is can use local paths and does not
# need to mount the file system to access file.
# Run your rsgislib python script
singularity exec au-eoed.simg python my_rsgislib_script.py
# Run an RSGISLib command line tool
singularity exec au-eoed.simg rsgiscalcimgstats.py -i img.kea -n 0
Binary Downloads¶
We make binary downloads available for Windows, Linux and MacOD, built using Python 3, through conda. You can get conda through the Anaconda or Miniconda Python distribution (https://docs.conda.io/en/latest/miniconda.html). More details are available from http://conda.pydata.org
The recomended way to install RSGISlib locally is from conda-forge using the following commands on MacOS and Linux:
conda create -n osgeo-env-v1 python=3.7
source activate osgeo-env-v1
conda install -c conda-forge rsgislib
The following video shows the steps to undertake this installation.
Source¶
The RSGISLib source is available to download from https://bitbucket.org/petebunting/rsgislib . Releases are available from the downloads tab, for the latest version of RSGISLib you can check out the development version with mercurial using:
hg clone https://bitbucket.org/petebunting/rsgislib rsgislib-code
We have also created spack (https://spack.readthedocs.io) build instructions, which are updated on an adhoc basis. See https://github.com/spack/spack for spack source.
For help with compiling or downloading RSGISLib you can email our mailing list:
rsgislib-support@googlegroups.com
The archives can be accessed at: https://groups.google.com/forum/#!forum/rsgislib-support
