An open source command line toolkit for processing aerial drone imagery
 
 
 
 
 
 
Go to file
Stephen Mather 6fcae9d3bd Update and rename licenses to licenses/libext_copyright.txt
Former-commit-id: e3bc02d98f
2015-03-01 14:20:31 -05:00
img add odm_image 2014-09-13 15:11:37 -07:00
licenses Update and rename licenses to licenses/libext_copyright.txt 2015-03-01 14:20:31 -05:00
odm_extract_utm add Spotscale orthophoto/textured mesh additions 2014-12-21 13:14:51 -05:00
odm_georef add orthophoto refinement and GCP capacity 2015-02-04 20:28:50 +00:00
odm_meshing Remove all backup(~) files 2015-01-22 18:15:33 -07:00
odm_orthophoto add orthophoto refinement and GCP capacity 2015-02-04 20:28:50 +00:00
odm_texturing fix texturing bug 2015-02-09 22:55:40 -05:00
patched_files/src add downloads to repo 2014-05-20 13:41:39 -04:00
.gitignore Git Ignore build files 2015-01-22 20:09:25 -07:00
PoissonRecon.zip add downloads to repo 2014-05-20 13:41:39 -04:00
README.md add CR between mailing lists 2015-02-16 13:33:43 -05:00
bundler.zip.REMOVED.git-id rename downloads + remove cmvs from extract 2014-05-23 13:31:11 +00:00
ccd_defs.json add new camera spec in ccd_defs.json 2015-02-25 21:15:49 -05:00
clapack.tgz.REMOVED.git-id rename downloads + remove cmvs from extract 2014-05-23 13:31:11 +00:00
cmvs.tar.gz.part-aa.REMOVED.git-id add cmvs.tar.gz parts 2014-09-26 13:20:40 +00:00
cmvs.tar.gz.part-ab.REMOVED.git-id add cmvs.tar.gz parts 2014-09-26 13:20:40 +00:00
cmvs.tar.gz.part-ac.REMOVED.git-id add cmvs.tar.gz parts 2014-09-26 13:20:40 +00:00
cmvs.tar.gz.part-ad.REMOVED.git-id add cmvs.tar.gz parts 2014-09-26 13:20:40 +00:00
cmvs.tar.gz.part-ae.REMOVED.git-id add cmvs.tar.gz parts 2014-09-26 13:20:40 +00:00
code_of_conduct.md Create code_of_conduct.md 2014-12-24 00:10:44 -05:00
convert_vlsift_to_lowesift.pl big update 2011-11-01 20:32:58 +01:00
graclus.tar.gz rename downloads + remove cmvs from extract 2014-05-23 13:31:11 +00:00
install.sh add libjson-perl for 12.04 2015-02-07 12:46:01 -05:00
run.pl fix args info on resize 2015-02-23 06:45:59 -05:00
vlfeat.tar.gz.REMOVED.git-id rename downloads + remove cmvs from extract 2014-05-23 13:31:11 +00:00

README.md

What is it?

OpenDroneMap is a toolchain for processing raw civilian UAS imagery to other useful products. What kind of products?

  1. Point Clouds
  2. Digital Surface Models
  3. Textured Digital Surface Models
  4. Orthorectified Imagery
  5. Classified Point Clouds
  6. Digital Elevation Models
  7. etc.

So far, it does Point Clouds, Digital Surface Models, Textured Digital Surface Models, and Orthorectified Imagery.

Users' mailing list: http://lists.osgeo.org/cgi-bin/mailman/listinfo/opendronemap-users

Developer's mailing list: http://lists.osgeo.org/cgi-bin/mailman/listinfo/opendronemap-dev

Steps to get OpenDroneMap running:

(Requires Ubuntu 12.04 32-bit at this time. May also work with Ubuntu 12.04 64-bit.

(Requires Ubuntu 12.04 or later, see https://github.com/OpenDroneMap/odm_vagrant for running on Windows in a VM)

Run install.sh to build.

./install.sh

From a directory full of your images, run

./run.pl

An overview of installing and running OpenDroneMap on Ubuntu can be found here: https://www.youtube.com/watch?v=e2qp3o8caPs

and here:

https://www.youtube.com/watch?v=7ZTufQkODLs

Now that texturing is in the code base, you can access the full textured meshes using MeshLab. Open MeshLab, and 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


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, point clouds to OpenTopography, 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.


Troubleshooting:

If you run ODM with your own camera, it is possible you will see something like this:

  - configuration:
    --cmvs-maxImages: 100
    --end-with: pmvs
    --match-size: 200
    --matcher-ratio: 0.6
    --matcher-threshold: 2
    --pmvs-csize: 2
    --pmvs-level: 1
    --pmvs-minImageNum: 3
    --pmvs-threshold: 0.7
    --pmvs-wsize: 7
    --resize-to: 1200
    --start-with: resize


  - source files - Fri Sep 19 13:47:42 UTC 2014


    no CCD width or focal length found for DSC05391.JPG - camera: "SONY DSC-HX5V"
    no CCD width or focal length found for DSC05392.JPG - camera: "SONY DSC-HX5V"
    no CCD width or focal length found for DSC05393.JPG - camera: "SONY DSC-HX5V"
    no CCD width or focal length found for DSC05394.JPG - camera: "SONY DSC-HX5V"
    no CCD width or focal length found for DSC05395.JPG - camera: "SONY DSC-HX5V"
    no CCD width or focal length found for DSC05396.JPG - camera: "SONY DSC-HX5V"
    no CCD width or focal length found for DSC05397.JPG - camera: "SONY DSC-HX5V"
    no CCD width or focal length found for DSC05398.JPG - camera: "SONY DSC-HX5V"
    no CCD width or focal length found for DSC05399.JPG - camera: "SONY DSC-HX5V"

    found no usable images - quitting
Died at ../../OpenDroneMap/./run.pl line 364.


This means that your camera is not in the database, https://github.com/OpenDroneMap/OpenDroneMap/blob/gh-pages/ccd_defs.json

This problem is easily remedied. We need to know CCD size in the camera. We'll get these for our Sony Cyber-shot DSC-HX5 from dpreview: http://www.dpreview.com/products/sony/compacts/sony_dschx5/specifications

So, we'll add the following line to our ccd_defs.json:

 "SONY DSC-HX5V": 6.104,

And so others can use it, we'll do a pull request to add it to our array for everyone else.