Knoth, C., Nüst, D., 2017. Reproducibility and Practical Adoption of GEOBIA with Open-Source Software in Docker Containers. Remote Sensing 9, 290. doi:10.3390/rs9030290
# QGIS docker load --input qgis-model_rs-jonjona.tar docker run --name rs-jonjona -it nuest/qgis-model:rs-jonjona docker cp rs-jonjona:/results /tmp/jonjona-results tree /tmp/jonjona-results # InterIMAGE - Linux only! docker load --input interimage.tar xhost + docker run -it --rm -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=unix$DISPLAY -e uid=$(id -u) -e gid=$(id -g) -v $(pwd):/home/data nuest/interimage:1.27 ./interimage xhost -
APACHE-LICENSE-2.0.txt: full text of code license
cc-by-4.0-legalcode.txt: full text of text license
create_package.sh: creation script for this package
example-analysis.log: log output of an example execution
example-results.zip: output files of an example execution
instructions-ui.pdf: step by step instructions for reproducing the QGIS workflow with a user interface
interimage-container.zip: source code for the InterIMAGE-based workflow (i.e. a clone of https://github.com/nuest/interimage-container)
interimage.tar: Docker image serialization (tarball) of InterIMAGE container
qgis-model_rs-jonjona.tar: Docker image serialization (tarball) of QGIS container for the Jonjona use case
qgis-model.zip: source code and data for the QGIS-based workflow, including Dockerfiles and the actual workspace (i.e. a clone of https://github.com/nuest/docker-qgis-model; the model and data are in
README.md: this file
software.zip: source code and installers for all required software in the versions current when conducting the research
The used software and detailed versions of all tools and libraries used in the OBIA method are listed in the example output log file
You can install Docker Engine based on these online instructions.
Just to be on the save side the software packages current when creating this package were saved in the archive
software.zip. Docker is available as source in
software/docker and as installers for all major platforms (
docker load --input qgis-model_rs-jonjona.tar
docker run --name rs-jonjona -it nuest/qgis-model:rs-jonjona
docker cp rs-jonjona:/results /tmp/jonjona-results tree /tmp/jonjona-results
You can now open the created output shapefiles (
.shp) in your favourite GIS for further inspection.
First, install Docker Engine (see above).
Second, you can run Kitematic using installers or run it from source.
Install Kitematic using provided installers for Linux and Windows from the archive
software.zip (for Linux use
Kitematic_0.12.9-amd64.deb, for Windows extract
Kitematic-Windows.zip and run
Follow the Kitematic Instructions to start the software.
nodejs --version cd software/kitematic npm start # close application with Ctrl+C
In the Kitematic UI, execute the steps as described in
The InterIMAGE analysis could not be completed, as no script-based execution is possible. It is possible (on Linux host machines!) to start InterIMAGE within a container, display the user interface, and use the tool as if it is running on the host. This requires to share the X11-server between host and container, which is a potential security risk.
# load the image from tarball docker load --input interimage.tar # enable xhost sharing for anyone xhost + # start the container: after this command the InterIMAGE UI is displayed on the host computer and the current directory is accessible under the path /home/data docker run -it --rm -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=unix$DISPLAY -e uid=$(id -u) -e gid=$(id -g) -v $(pwd):/home/data nuest/interimage:1.27 ./interimage # disable xhost sharing xhost -
This package was created by the bash script
create_package.sh, executed in the directory this README.md file is located.
Code in this package is published under the Apache License, Version 2.0, unless noted otherwise.
This file is published under CC BY 4.0 (Creative Commons Attribution 4.0 International).