OpenDroneMap-ODM/params.json

{
  "name": "Opendronemap",
  "tagline": "OpenDroneMap is a tool to postprocess drone, balloon, kite, and street view data to geographic data including orthophotos, point clouds, & textured mesh. In the tradition of the Ship of Theseus, it was originally forked from qwesda/BundlerTools https://github.com/qwesda/BundlerTools.",
  "body": "# OpenDroneMap\r\n\r\n![](https://raw.githubusercontent.com/OpenDroneMap/OpenDroneMap/master/img/odm_image.png)\r\n\r\nWhat is it?\r\n===========\r\n\r\nOpenDroneMap 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.\r\n\r\n![](https://raw.githubusercontent.com/OpenDroneMap/OpenDroneMap/master/img/tol_ptcloud.png)\r\n\r\nIn a word, OpenDroneMap is a toolchain for processing raw civilian UAS imagery to other useful products. What kind of products?\r\n\r\n1. Point Clouds\r\n2. Digital Surface Models\r\n3. Textured Digital Surface Models\r\n4. Orthorectified Imagery\r\n5. Classified Point Clouds\r\n6. Digital Elevation Models\r\n7. etc.\r\n\r\nSo far, it does Point Clouds, Digital Surface Models, Textured Digital Surface Models, and Orthorectified Imagery.\r\n\r\nUsers' mailing list: http://lists.osgeo.org/cgi-bin/mailman/listinfo/opendronemap-users\r\n\r\nDeveloper's mailing list: http://lists.osgeo.org/cgi-bin/mailman/listinfo/opendronemap-dev\r\n\r\nOverview video: https://www.youtube.com/watch?v=0UctfoeNB_Y\r\n\r\nDevelopers\r\n=================\r\n\r\nHelp improve our software!\r\n\r\n[![Join the chat at https://gitter.im/OpenDroneMap/OpenDroneMap](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/OpenDroneMap/OpenDroneMap?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\r\n\r\n1. Try to keep commits clean and simple\r\n2. Submit a pull request with detailed changes and test results\r\n\r\nSteps to get OpenDroneMap running:\r\n==================================\r\n\r\n(Requires Ubuntu 14.04 or later, see https://github.com/OpenDroneMap/odm_vagrant for running on Windows in a VM)\r\n\r\nSupport for Ubuntu 12.04 is currently BROKEN with the addition of OpenSfM and Ceres-Solver. We are working hard to get it working again in the future. \r\n\r\n#### Building OpenDroneMap using git\r\n\r\n    cd path/to/odm/dir\r\n    git clone https://github.com/OpenDroneMap/OpenDroneMap.git .\r\n    export PYTHONPATH=$PYTHONPATH:`pwd`/SuperBuild/install/lib/python2.7/dist-packages:`pwd`/SuperBuild/src/opensfm\r\n    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`/SuperBuild/install/lib\r\n    bash configure.sh\r\n    mkdir build && cd build && cmake .. && make && cd ..\r\n\r\n For Ubuntu 15.10 users, this will help you get running:\r\n\r\n    sudo apt-get install python-xmltodict\r\n    sudo ln -s /usr/lib/x86_64-linux-gnu/libproj.so.9 /usr/lib/libproj.so\r\n    \r\n#### Running OpenDroneMap\r\n\r\nFirst you need a set of images, which may or may not be georeferenced. There are two ways OpenDroneMap can understand geographic coordinates. First, the images can be geotagged in their EXIF data. This is the default. Alternatively, you can create a GCP file, [a process detailed here](https://github.com/OpenDroneMap/OpenDroneMap/wiki/2.-Running-OpenDroneMap#running-odm-with-ground-control)\r\n\r\nCreate a project folder and places your images in an \"images\" directory:\r\n\r\n\r\n    |-- /path/to/project/\r\n        |-- images/\r\n            |-- img-1234.jpg\r\n            |-- ...\r\n\r\n\r\nExample data can be cloned from https://github.com/OpenDroneMap/odm_data\r\n\r\nThen run:\r\n\r\n    python run.py --project-path /path/to/project\r\n    \r\nThere are many options for tuning your project. See the [wiki](https://github.com/OpenDroneMap/OpenDroneMap/wiki/3.-Run-Time-Parameters) or run `python run.py -h`\r\n\r\nWhen the process finishes, the results will be organized as follows\r\n\r\n    |-- images/\r\n        |-- img-1234.jpg\r\n        |-- ...\r\n    |-- images_resize/\r\n        |-- img-1234.jpg\r\n        |-- ...\r\n    |-- opensfm/\r\n        |-- not much useful in here\r\n    |-- pmvs/\r\n        |-- recon0/\r\n            |-- models/\r
  "note": "Don't delete this file! It's used internally to help with page regeneration."
}