A Docker image for InterIMAGE

June 7, 2016 · View on GitHub

These Dockerfiles are based on the InterIMAGE installation instructions on Ubuntu: http://www.lvc.ele.puc-rio.br/projects/interimage/download/files/install_interimage_ubuntu.txt

1.43

Status: The instructions linked above are not transferable directly to the latest source code.

Build and run

To execute the container, install Docker and open a command prompt in the directory /1.27. Then build the container with

docker build -t interimage/143 .

and start it with

docker run -it --user interimage interimage/143

1.27

Status: Based on the existing Linux download of InterIMAGE, the Dockerfile successfully downloads and compiles InterIMAGE and the required binaries.

Build and run

To execute the container, install Docker and open a command prompt in the directory /1.27. Then build the container with

docker build -t interimage/1.27 .

and start it with

docker run -it --user interimage interimage/1.27

(To remove the image directly after, add the --rm flag.)

This opens a bash prompt. Interimage is can be started with the following command (the image should start in the directory cd /home/interimage/InterIMAGE_Source_1.27/bin, if not, cd there).

./interimage

Build and run with UI

(Based on https://hub.docker.com/r/toddstavish/orfeo_toolbox/ and https://github.com/adrienandrem/interimage-docker/blob/1.27/Makefile)

Background on GUI applications in Docker:

http://fabiorehm.com/blog/2014/09/11/running-gui-apps-with-docker/
http://wiki.ros.org/docker/Tutorials/GUI
On Linux, we simply forward our X11 info with the Docker container. This is a potential security risk because the container can receive all X11 events that happen on the host computer desktop (via).

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 /<path to workdir>:/home/data interimage/1.27 ./interimage
xhost -

Development

docker build .
docker run -it --rm <imageid>

Image content

The image has a user interimage which should be used to run analysis in the container if you have security considerations.

The downloads and built libraries are in the directory home/interimage:

root@a096be168745:/home/interimage# ll
total 154516
drwxr-xr-x 11 interimage interimage      4096 Feb 24 08:55 ./
drwxr-xr-x  8 root       root            4096 Feb 24 08:55 ../
drwx------ 29 interimage interimage      4096 Feb 24 08:55 InterIMAGE_Source_1.27/
drwx------  4 interimage interimage      4096 Feb 24 08:30 bin_1.27/
-rw-r--r--  1 root       root       158198233 Feb 22 16:34 interimage-src.tar.gz
drwx------  8 interimage interimage      4096 Feb 24 08:29 ta_operators/
drwx------  6 interimage interimage      4096 Feb 24 08:26 terralib_cvs/

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.