|
|
|
|
@ -1,3 +1,5 @@
|
|
|
|
|
# OpenDroneMap
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
What is it?
|
|
|
|
|
@ -5,6 +7,8 @@ What is it?
|
|
|
|
|
|
|
|
|
|
OpenDroneMap is an open source toolkit for processing aerial drone imagery. Typical drones use simple point-and-shoot cameras, so the images from drones, while from a different perspective, are similar to any pictures taken from point-and-shoot cameras, i.e. non-metric imagery. OpenDroneMap turns those simple images into three dimensional geographic data that can be used in combination with other geographic datasets.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
In a word, OpenDroneMap is a toolchain for processing raw civilian UAS imagery to other useful products. What kind of products?
|
|
|
|
|
|
|
|
|
|
1. Point Clouds
|
|
|
|
|
@ -48,6 +52,11 @@ Support for Ubuntu 12.04 is currently BROKEN with the addition of OpenSfM and Ce
|
|
|
|
|
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`/SuperBuild/install/lib
|
|
|
|
|
bash configure.sh
|
|
|
|
|
mkdir build && cd build && cmake .. && make && cd ..
|
|
|
|
|
|
|
|
|
|
For Ubuntu 15.10 users, this will help you get running:
|
|
|
|
|
|
|
|
|
|
sudo apt-get install python-xmltodict
|
|
|
|
|
sudo ln -s /usr/lib/x86_64-linux-gnu/libproj.so.9 /usr/lib/libproj.so
|
|
|
|
|
|
|
|
|
|
#### Running OpenDroneMap
|
|
|
|
|
|
|
|
|
|
@ -62,6 +71,8 @@ Create a project folder and places your images in an "images" directory:
|
|
|
|
|
|-- ...
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example data can be cloned from https://github.com/OpenDroneMap/odm_data
|
|
|
|
|
|
|
|
|
|
Then run:
|
|
|
|
|
|
|
|
|
|
python run.py --project-path /path/to/project
|
|
|
|
|
@ -101,6 +112,29 @@ When the process finishes, the results will be organized as follows
|
|
|
|
|
|-- odm_orthophoto_log.txt # Log file
|
|
|
|
|
|-- gdal_translate_log.txt # Log for georeferencing the png file
|
|
|
|
|
|
|
|
|
|
##### Viewing your results
|
|
|
|
|
|
|
|
|
|
Any file ending in .obj or .ply can be opened and viewed in [MeshLab](http://meshlab.sourceforge.net/) or similar software. That includes `pmvs/recon0/models/option-000.ply`, `odm_meshing/odm_mesh.ply`, `odm_texturing/odm_textured_model[_geo].obj`, or `odm_georeferencing/odm_georeferenced_model.ply`. Below is an example textured mesh:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
You can also view the orthophoto GeoTIFF in QGIS or other mapping software:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Using Docker
|
|
|
|
|
|
|
|
|
|
You can build and run OpenDroneMap in a Docker container:
|
|
|
|
|
|
|
|
|
|
export IMAGES=/absolute/path/to/your/project
|
|
|
|
|
docker build -t opendronemap:latest .
|
|
|
|
|
docker run -v $IMAGES:/images opendronemap:latest
|
|
|
|
|
|
|
|
|
|
Replace /absolute/path/to/your/images with an absolute path to the directory containing your project (where the images are)
|
|
|
|
|
To pass in custom parameters to the `run.py` script, simply pass it as arguments to the `docker run` command.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Here are some other videos, which may be outdated:
|
|
|
|
|
|
|
|
|
|
- https://www.youtube.com/watch?v=7ZTufQkODLs (2015-01-30)
|
|
|
|
|
@ -108,25 +142,6 @@ Here are some other videos, which may be outdated:
|
|
|
|
|
|
|
|
|
|
Now that texturing is in the code base, you can access the full textured meshes using MeshLab. Open MeshLab, choose `File:Import Mesh` and choose your textured mesh from a location similar to the following: `reconstruction-with-image-size-1200-results\odm_texturing\odm_textured_model.obj`
|
|
|
|
|
|
|
|
|
|
__For Ubuntu 15.10 users, this will help you get running:__
|
|
|
|
|
|
|
|
|
|
sudo apt-get install python-xmltodict
|
|
|
|
|
sudo ln -s /usr/lib/x86_64-linux-gnu/libproj.so.9 /usr/lib/libproj.so
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Alternatively, you can also run OpenDroneMap in a Docker container:
|
|
|
|
|
|
|
|
|
|
export IMAGES=/absolute/path/to/your/images
|
|
|
|
|
docker build -t opendronemap:latest .
|
|
|
|
|
docker run -v $IMAGES:/images opendronemap:latest
|
|
|
|
|
|
|
|
|
|
To pass in custom parameters to the `run.py` script, simply pass it as arguments to the `docker run` command.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Example data can be found at https://github.com/OpenDroneMap/odm_data
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Long term, the aim is for the toolchain to also be able to optionally push to a variety of online data repositories, pushing hi-resolution aerials to [OpenAerialMap](http://opentopography.org/), point clouds to [OpenTopography](http://opentopography.org/), and pushing digital elevation models to an emerging global repository (yet to be named...). That leaves only digital surface model meshes and UV textured meshes with no global repository home.
|
|
|
|
|
|
Dakota Benjamin
