mirror
/
OpenDroneMap-ODM
kopia lustrzana https://github.com/OpenDroneMap/ODM
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność

Redirect to new website 

Former-commit-id: b787659d61a4cc195b5bf0960ad7276fe4625873
gh-pages
Piero Toffanin 2020-01-21 10:20:08 -05:00 zatwierdzone przez GitHub
rodzic 4f4b0585e0
commit 27b129d5ea
1 zmienionych plików z 9 dodań i 202 usunięć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

211
index.html
Wyświetl plik

@ -1,204 +1,11 @@
<!DOCTYPE html>
<html lang="en-us">
<head>
<meta charset="UTF-8">
<title>Opendronemap by OpenDroneMap</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" type="text/css" href="stylesheets/normalize.css" media="screen">
<link href='https://fonts.googleapis.com/css?family=Open+Sans:400,700' rel='stylesheet' type='text/css'>
<link rel="stylesheet" type="text/css" href="stylesheets/stylesheet.css" media="screen">
<link rel="stylesheet" type="text/css" href="stylesheets/github-light.css" media="screen">
</head>
<body>
<section class="page-header">
<h1 class="project-name">Opendronemap</h1>
<h2 class="project-tagline">OpenDroneMap is a tool to postprocess drone, balloon, kite, and street view data to geographic data including orthophotos, point clouds, &amp; textured mesh. In the tradition of the Ship of Theseus, it was originally forked from qwesda/BundlerTools https://github.com/qwesda/BundlerTools.</h2>
<a href="https://github.com/OpenDroneMap/OpenDroneMap" class="btn">View on GitHub</a>
<a href="https://github.com/OpenDroneMap/OpenDroneMap/zipball/master" class="btn">Download .zip</a>
<a href="https://github.com/OpenDroneMap/OpenDroneMap/tarball/master" class="btn">Download .tar.gz</a>
</section>
<section class="main-content">
<h1>
<a id="opendronemap" class="anchor" href="#opendronemap" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>OpenDroneMap</h1>
<p><img src="https://raw.githubusercontent.com/OpenDroneMap/OpenDroneMap/master/img/odm_image.png" alt=""></p>
<h1>
<a id="what-is-it" class="anchor" href="#what-is-it" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>What is it?</h1>
<p>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.</p>
<p><img src="https://raw.githubusercontent.com/OpenDroneMap/OpenDroneMap/master/img/tol_ptcloud.png" alt=""></p>
<p>In a word, OpenDroneMap is a toolchain for processing raw civilian UAS imagery to other useful products. What kind of products?</p>
<ol>
<li>Point Clouds</li>
<li>Digital Surface Models</li>
<li>Textured Digital Surface Models</li>
<li>Orthorectified Imagery</li>
<li>Classified Point Clouds</li>
<li>Digital Elevation Models</li>
<li>etc.</li>
</ol>
<p>So far, it does Point Clouds, Digital Surface Models, Textured Digital Surface Models, and Orthorectified Imagery.</p>
<p>Users' mailing list: <a href="http://lists.osgeo.org/cgi-bin/mailman/listinfo/opendronemap-users">http://lists.osgeo.org/cgi-bin/mailman/listinfo/opendronemap-users</a></p>
<p>Developer's mailing list: <a href="http://lists.osgeo.org/cgi-bin/mailman/listinfo/opendronemap-dev">http://lists.osgeo.org/cgi-bin/mailman/listinfo/opendronemap-dev</a></p>
<p>Overview video: <a href="https://www.youtube.com/watch?v=0UctfoeNB_Y">https://www.youtube.com/watch?v=0UctfoeNB_Y</a></p>
<h1>
<a id="developers" class="anchor" href="#developers" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Developers</h1>
<p>Help improve our software!</p>
<p><a href="https://gitter.im/OpenDroneMap/OpenDroneMap?utm_source=badge&amp;utm_medium=badge&amp;utm_campaign=pr-badge&amp;utm_content=badge"><img src="https://badges.gitter.im/Join%20Chat.svg" alt="Join the chat at https://gitter.im/OpenDroneMap/OpenDroneMap"></a></p>
<ol>
<li>Try to keep commits clean and simple</li>
<li>Submit a pull request with detailed changes and test results</li>
</ol>
<h1>
<a id="steps-to-get-opendronemap-running" class="anchor" href="#steps-to-get-opendronemap-running" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Steps to get OpenDroneMap running:</h1>
<p>(Requires Ubuntu 14.04 or later, see <a href="https://github.com/OpenDroneMap/odm_vagrant">https://github.com/OpenDroneMap/odm_vagrant</a> for running on Windows in a VM)</p>
<p>Support 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. </p>
<h4>
<a id="building-opendronemap-using-git" class="anchor" href="#building-opendronemap-using-git" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Building OpenDroneMap using git</h4>
<pre><code>cd path/to/odm/dir
git clone https://github.com/OpenDroneMap/OpenDroneMap.git .
export PYTHONPATH=$PYTHONPATH:`pwd`/SuperBuild/install/lib/python2.7/dist-packages:`pwd`/SuperBuild/src/opensfm
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:`pwd`/SuperBuild/install/lib
bash configure.sh
mkdir build &amp;&amp; cd build &amp;&amp; cmake .. &amp;&amp; make &amp;&amp; cd ..
</code></pre>
<p>For Ubuntu 15.10 users, this will help you get running:</p>
<pre><code>sudo apt-get install python-xmltodict
sudo ln -s /usr/lib/x86_64-linux-gnu/libproj.so.9 /usr/lib/libproj.so
</code></pre>
<h4>
<a id="running-opendronemap" class="anchor" href="#running-opendronemap" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Running OpenDroneMap</h4>
<p>First 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 href="https://github.com/OpenDroneMap/OpenDroneMap/wiki/2.-Running-OpenDroneMap#running-odm-with-ground-control">a process detailed here</a></p>
<p>Create a project folder and places your images in an "images" directory:</p>
<pre><code>|-- /path/to/project/
|-- images/
|-- img-1234.jpg
|-- ...
</code></pre>
<p>Example data can be cloned from <a href="https://github.com/OpenDroneMap/odm_data">https://github.com/OpenDroneMap/odm_data</a></p>
<p>Then run:</p>
<pre><code>python run.py --project-path /path/to/project
</code></pre>
<p>There are many options for tuning your project. See the <a href="https://github.com/OpenDroneMap/OpenDroneMap/wiki/3.-Run-Time-Parameters">wiki</a> or run <code>python run.py -h</code></p>
<p>When the process finishes, the results will be organized as follows</p>
<pre><code>|-- images/
|-- img-1234.jpg
|-- ...
|-- images_resize/
|-- img-1234.jpg
|-- ...
|-- opensfm/
|-- not much useful in here
|-- pmvs/
|-- recon0/
|-- models/
|-- option-0000.ply # Dense point cloud
|-- odm_meshing/
|-- odm_mesh.ply # A 3D mesh
|-- odm_meshing_log.txt # Output of the meshing task. May point out errors.
|-- odm_texturing/
|-- odm_textured_model.obj # Textured mesh
|-- odm_textured_model_geo.obj # Georeferenced textured mesh
|-- texture_N.jpg # Associated textured images used by the model
|-- odm_georeferencing/
|-- odm_georeferenced_model.ply # A georeferenced dense point cloud
|-- odm_georeferenced_model.ply.laz # LAZ format point cloud
|-- odm_georeferenced_model.csv # XYZ format point cloud
|-- odm_georeferencing_log.txt # Georeferencing log
|-- odm_georeferencing_utm_log.txt # Log for the extract_utm portion
|-- odm_georeferencing/
|-- odm_orthophoto.png # Orthophoto image (no coordinates)
|-- odm_orthophoto.tif # Orthophoto GeoTiff
|-- odm_orthophoto_log.txt # Log file
|-- gdal_translate_log.txt # Log for georeferencing the png file
</code></pre>
<h5>
<a id="viewing-your-results" class="anchor" href="#viewing-your-results" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Viewing your results</h5>
<p>Any file ending in .obj or .ply can be opened and viewed in <a href="http://meshlab.sourceforge.net/">MeshLab</a> or similar software. That includes <code>pmvs/recon0/models/option-000.ply</code>, <code>odm_meshing/odm_mesh.ply</code>, <code>odm_texturing/odm_textured_model[_geo].obj</code>, or <code>odm_georeferencing/odm_georeferenced_model.ply</code>. Below is an example textured mesh:</p>
<p><img src="https://raw.githubusercontent.com/OpenDroneMap/OpenDroneMap/master/img/tol_text.png" alt=""></p>
<p>You can also view the orthophoto GeoTIFF in QGIS or other mapping software:</p>
<p><img src="https://raw.githubusercontent.com/OpenDroneMap/OpenDroneMap/master/img/bellus_map.png" alt=""></p>
<h4>
<a id="using-docker" class="anchor" href="#using-docker" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Using Docker</h4>
<p>You can build and run OpenDroneMap in a Docker container:</p>
<pre><code>export IMAGES=/absolute/path/to/your/project
docker build -t opendronemap:latest .
docker run -v $IMAGES:/images opendronemap:latest
</code></pre>
<p>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 <code>run.py</code> script, simply pass it as arguments to the <code>docker run</code> command.</p>
<hr>
<p>Here are some other videos, which may be outdated:</p>
<ul>
<li>
<a href="https://www.youtube.com/watch?v=7ZTufQkODLs">https://www.youtube.com/watch?v=7ZTufQkODLs</a> (2015-01-30)</li>
<li>
<a href="https://www.youtube.com/watch?v=m0i4GQdfl8A">https://www.youtube.com/watch?v=m0i4GQdfl8A</a> (2015-03-15)</li>
</ul>
<p>Now that texturing is in the code base, you can access the full textured meshes using MeshLab. Open MeshLab, choose <code>File:Import Mesh</code> and choose your textured mesh from a location similar to the following: <code>reconstruction-with-image-size-1200-results\odm_texturing\odm_textured_model.obj</code></p>
<hr>
<p>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 <a href="http://openaerialmap.org/">OpenAerialMap</a>, point clouds to <a href="http://opentopography.org/">OpenTopography</a>, 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.</p>
<hr>
<h1>
<a id="documentation" class="anchor" href="#documentation" aria-hidden="true"><span aria-hidden="true" class="octicon octicon-link"></span></a>Documentation:</h1>
<p>For documentation, please take a look at our <a href="https://github.com/OpenDroneMap/OpenDroneMap/wiki">wiki</a>.</p>
<footer class="site-footer">
<span class="site-footer-owner"><a href="https://github.com/OpenDroneMap/OpenDroneMap">Opendronemap</a> is maintained by <a href="https://github.com/OpenDroneMap">OpenDroneMap</a>.</span>
<span class="site-footer-credits">This page was generated by <a href="https://pages.github.com">GitHub Pages</a> using the <a href="https://github.com/jasonlong/cayman-theme">Cayman theme</a> by <a href="https://twitter.com/jasonlong">Jason Long</a>.</span>
</footer>
</section>
</body>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="Refresh" content="0; url=https://opendronemap.org" />
<title>OpenDroneMap</title>
</head>
<body>
The project has moved to <a href="https://opendronemap.org">https://opendronemap.org</a>!
</body>
</html>