Docker

Docker

Installation

(Instructions below apply to Ubuntu 14.04, but the Docker image workflow has equivalent procedures for Mac OS X and Windows. See docs.docker.com)

OpenDroneMap is Dockerized, meaning you can use containerization to build and run it without tampering with the configuration of libraries and packages already installed on your machine. Docker software is free to install and use in this context. If you don't have it installed, see the Docker Ubuntu installation tutorial and follow the instructions up until "Create a Docker group" inclusive. Once Docker is installed, an OpenDroneMap Docker image can be created like so:

git clone https://github.com/OpenDroneMap/OpenDroneMap.git
cd OpenDroneMap
docker build -t packages -f packages.Dockerfile .
docker build -t odm_image .
docker run -it --user root\
     -v $(pwd)/images:/code/images\
     -v $(pwd)/odm_orthophoto:/code/odm_orthophoto\
     -v $(pwd)/odm_texturing:/code/odm_texturing\
     --rm odm_image

Running

Using this method, the containerized ODM will process the images in the OpenDroneMap/images directory and output results to the OpenDroneMao/odm_orthophoto and OpenDroneMap/odm_texturing directories as described in the Viewing Results section. If you want to view other results outside the Docker image simply add which directories you're interested in to the run command in the same pattern established above. For example, if you're interested in the dense cloud results generated by PMVS and in the orthophoto, simply use the following docker run command after building the image:

docker run -it --user root\
     -v $(pwd)/images:/code/images\
     -v $(pwd)/pmvs:/code/pmvs\
     -v $(pwd)/odm_orthophoto:/code/odm_orthophoto\
     --rm odm_image

To pass in custom parameters to the run.py script, simply pass it as arguments to the docker run command.