Skip to content

Latest commit

 

History

History
30 lines (23 loc) · 1.42 KB

docker.md

File metadata and controls

30 lines (23 loc) · 1.42 KB

Using Docker to run the Stucture From Motion Pipeline

To facilitate running the pipeline with as little effort as possible we have created a docker image.

Docker is a system for fast deployment of applications using virtual machines. See here for more information: https://www.docker.com/

Quick HOWTO:

  1. Install Docker: sudo apt-get install docker.io,
  2. retrieve the docker image by running docker pull nlesc/structure-from-motion,
  3. go to the examples directory 'examples/rock',
  4. start the image using sudo docker run -u $UID -v "$PWD:/data" nlesc/structure-from-motion. To process your own set of images, run this command inside the directory containing your image files.

By default the docker image will run the entire structure-from-motion pipeline on all pictures in the current working directory. If instead you would like a terminal session to play around with the image try this command:

sudo docker run -u $UID -v "$PWD:/data" -i -t nlesc/structure-from-motion /bin/bash

The main script to run the pipeline is called run-sfm.py'. The image can also be built from source. To do this yourself, you need to checkout the submodules:

git submodule checkout --init --recursive

Then, build the image using the Dockerfile in the repository root directory:

sudo docker build -t sfm_image .
sudo docker run -u $UID -v $PWD:/data sfm_image