Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
actions-user committed Oct 19, 2024
1 parent 01fb7d3 commit 718fe9c
Show file tree
Hide file tree
Showing 53 changed files with 72 additions and 88 deletions.
7 changes: 3 additions & 4 deletions _sources/tutorials.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ Creating High Quality Orthophotos
Without any parameter tweaks, ODM chooses a good compromise between quality, speed and memory usage. If you want to get higher quality results, you need to tweak some parameters:

* ``--orthophoto-resolution`` is the resolution of the orthophoto in cm/pixel. Decrease this value for a higher resolution result.
* ``--ignore-gsd`` is a flag that instructs ODM to skip certain memory and speed optimizations that directly affect the orthophoto. Using this flag will increase runtime and memory usage, but may produce sharper results.
* ``--texturing-data-term`` should be set to `area` in forest areas.
* ``--mesh-size`` should be increased to ``300000-600000`` and ``--mesh-octree-depth`` should be increased to ``10-11`` in urban areas to recreate better buildings / roofs.

Expand Down Expand Up @@ -496,7 +495,7 @@ Resize droplet, pull pin, run away

::

nohup python run.py myproject --split 1 --split-overlap 0 --ignore-gsd --depthmap-resolution 1000 --orthophoto-resolution 5 --dem-resolution 15 --pc-las --dsm
nohup python run.py myproject --split 1 --split-overlap 0 --depthmap-resolution 1000 --orthophoto-resolution 5 --dem-resolution 15 --pc-las --dsm

- This points ODM at the folder (in this example)
``/mnt/odmdata/myproject/``. Provided the image_groups.txt and
Expand Down Expand Up @@ -894,9 +893,9 @@ Like with docker, additional `Options and Flags <https://docs.opendronemap.org/a
singularity run --bind /my/project:/datasets/code \
--writable-tmpfs odm_latest.sif \
--orthophoto-png --mesh-octree-depth 12 --ignore-gsd --dtm \
--orthophoto-png --mesh-octree-depth 12 --dtm \
--smrf-threshold 0.4 --smrf-window 24 --dsm --pc-csv --pc-las --orthophoto-kmz \
--ignore-gsd --matcher-type flann --feature-quality ultra --max-concurrency 16 \
--matcher-type flann --feature-quality ultra --max-concurrency 16 \
--use-hybrid-bundle-adjustment --build-overviews --time --min-num-features 10000 \
--project-path /datasets
Expand Down
Binary file modified cs/.doctrees/environment.pickle
Binary file not shown.
Binary file modified cs/.doctrees/flowchart.doctree
Binary file not shown.
Binary file modified cs/.doctrees/tutorials.doctree
Binary file not shown.
7 changes: 3 additions & 4 deletions cs/_sources/tutorials.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ Creating High Quality Orthophotos
Without any parameter tweaks, ODM chooses a good compromise between quality, speed and memory usage. If you want to get higher quality results, you need to tweak some parameters:

* ``--orthophoto-resolution`` is the resolution of the orthophoto in cm/pixel. Decrease this value for a higher resolution result.
* ``--ignore-gsd`` is a flag that instructs ODM to skip certain memory and speed optimizations that directly affect the orthophoto. Using this flag will increase runtime and memory usage, but may produce sharper results.
* ``--texturing-data-term`` should be set to `area` in forest areas.
* ``--mesh-size`` should be increased to ``300000-600000`` and ``--mesh-octree-depth`` should be increased to ``10-11`` in urban areas to recreate better buildings / roofs.

Expand Down Expand Up @@ -496,7 +495,7 @@ Resize droplet, pull pin, run away

::

nohup python run.py myproject --split 1 --split-overlap 0 --ignore-gsd --depthmap-resolution 1000 --orthophoto-resolution 5 --dem-resolution 15 --pc-las --dsm
nohup python run.py myproject --split 1 --split-overlap 0 --depthmap-resolution 1000 --orthophoto-resolution 5 --dem-resolution 15 --pc-las --dsm

- This points ODM at the folder (in this example)
``/mnt/odmdata/myproject/``. Provided the image_groups.txt and
Expand Down Expand Up @@ -894,9 +893,9 @@ Like with docker, additional `Options and Flags <https://docs.opendronemap.org/a
singularity run --bind /my/project:/datasets/code \
--writable-tmpfs odm_latest.sif \
--orthophoto-png --mesh-octree-depth 12 --ignore-gsd --dtm \
--orthophoto-png --mesh-octree-depth 12 --dtm \
--smrf-threshold 0.4 --smrf-window 24 --dsm --pc-csv --pc-las --orthophoto-kmz \
--ignore-gsd --matcher-type flann --feature-quality ultra --max-concurrency 16 \
--matcher-type flann --feature-quality ultra --max-concurrency 16 \
--use-hybrid-bundle-adjustment --build-overviews --time --min-num-features 10000 \
--project-path /datasets
Expand Down
4 changes: 2 additions & 2 deletions cs/flowchart/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@
<script src="https://unpkg.com/d3/dist/d3.min.js"></script>
<script>
window.addEventListener("load", function () {
var svgs = d3.selectAll(".mermaid#id-24aa1dcf-d1e9-4ab7-94e8-c9d57b8a1778 svg");
var svgs = d3.selectAll(".mermaid#id-085ed282-b834-479a-8997-8a8c2f5238fb svg");
svgs.each(function() {
var svg = d3.select(this);
svg.html("<g>" + svg.html() + "</g>");
Expand Down Expand Up @@ -468,7 +468,7 @@

<section id="flowchart-with-options">
<h1>Flowchart with options<a class="headerlink" href="#flowchart-with-options" title="Permalink to this heading"></a></h1>
<div id="id-24aa1dcf-d1e9-4ab7-94e8-c9d57b8a1778" class="mermaid">
<div id="id-085ed282-b834-479a-8997-8a8c2f5238fb" class="mermaid">
flowchart TB


Expand Down
2 changes: 1 addition & 1 deletion cs/searchindex.js

Large diffs are not rendered by default.

7 changes: 3 additions & 4 deletions cs/tutorials/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -461,7 +461,6 @@ <h2>Vytváření vysoce kvalitních ortofotomap<a class="headerlink" href="#crea
<blockquote>
<div><ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">--orthophoto-resolution</span></code> je rozlišení ortofota v cm/pixel. Snižte tuto hodnotu pro výsledek s vyšším rozlišením.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">--ignore-gsd</span></code> je příznak, který dává ODM pokyn k vynechání určitých optimalizací paměti a rychlosti, které přímo ovlivňují ortofoto. Použití tohoto příznaku zvýší dobu běhu a spotřebu paměti, ale může přinést ostřejší výsledky.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">--texturing-data-term</span></code> by měl být v lesních oblastech nastaven na <cite>area</cite>.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">--mesh-size</span></code> by měla být zvýšena na <code class="docutils literal notranslate"><span class="pre">300000-600000</span></code> a <code class="docutils literal notranslate"><span class="pre">--mesh-octree-depth</span></code> by měla být zvýšena na <code class="docutils literal notranslate"><span class="pre">10-11</span></code> v městských oblastech, aby bylo možné vytvořit lepší budovy/střechy.</p></li>
</ul>
Expand Down Expand Up @@ -749,7 +748,7 @@ <h4>Resize droplet, pull pin, run away<a class="headerlink" href="#resize-drople
</ul>
</li>
</ul>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">nohup</span> <span class="n">python</span> <span class="n">run</span><span class="o">.</span><span class="n">py</span> <span class="n">myproject</span> <span class="o">--</span><span class="n">split</span> <span class="mi">1</span> <span class="o">--</span><span class="n">split</span><span class="o">-</span><span class="n">overlap</span> <span class="mi">0</span> <span class="o">--</span><span class="n">ignore</span><span class="o">-</span><span class="n">gsd</span> <span class="o">--</span><span class="n">depthmap</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">1000</span> <span class="o">--</span><span class="n">orthophoto</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">5</span> <span class="o">--</span><span class="n">dem</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">15</span> <span class="o">--</span><span class="n">pc</span><span class="o">-</span><span class="n">las</span> <span class="o">--</span><span class="n">dsm</span>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">nohup</span> <span class="n">python</span> <span class="n">run</span><span class="o">.</span><span class="n">py</span> <span class="n">myproject</span> <span class="o">--</span><span class="n">split</span> <span class="mi">1</span> <span class="o">--</span><span class="n">split</span><span class="o">-</span><span class="n">overlap</span> <span class="mi">0</span> <span class="o">--</span><span class="n">depthmap</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">1000</span> <span class="o">--</span><span class="n">orthophoto</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">5</span> <span class="o">--</span><span class="n">dem</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">15</span> <span class="o">--</span><span class="n">pc</span><span class="o">-</span><span class="n">las</span> <span class="o">--</span><span class="n">dsm</span>
</pre></div>
</div>
<ul class="simple">
Expand Down Expand Up @@ -990,9 +989,9 @@ <h4>Using Singularity SIF image<a class="headerlink" href="#using-singularity-si
<p>Like with docker, additional <a class="reference external" href="https://docs.opendronemap.org/arguments/">Options and Flags</a> can be added to the command :</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>singularity<span class="w"> </span>run<span class="w"> </span>--bind<span class="w"> </span>/my/project:/datasets/code<span class="w"> </span><span class="se">\</span>
--writable-tmpfs<span class="w"> </span>odm_latest.sif<span class="w"> </span><span class="se">\</span>
--orthophoto-png<span class="w"> </span>--mesh-octree-depth<span class="w"> </span><span class="m">12</span><span class="w"> </span>--ignore-gsd<span class="w"> </span>--dtm<span class="w"> </span><span class="se">\</span>
--orthophoto-png<span class="w"> </span>--mesh-octree-depth<span class="w"> </span><span class="m">12</span><span class="w"> </span>--dtm<span class="w"> </span><span class="se">\</span>
--smrf-threshold<span class="w"> </span><span class="m">0</span>.4<span class="w"> </span>--smrf-window<span class="w"> </span><span class="m">24</span><span class="w"> </span>--dsm<span class="w"> </span>--pc-csv<span class="w"> </span>--pc-las<span class="w"> </span>--orthophoto-kmz<span class="w"> </span><span class="se">\</span>
--ignore-gsd<span class="w"> </span>--matcher-type<span class="w"> </span>flann<span class="w"> </span>--feature-quality<span class="w"> </span>ultra<span class="w"> </span>--max-concurrency<span class="w"> </span><span class="m">16</span><span class="w"> </span><span class="se">\</span>
--matcher-type<span class="w"> </span>flann<span class="w"> </span>--feature-quality<span class="w"> </span>ultra<span class="w"> </span>--max-concurrency<span class="w"> </span><span class="m">16</span><span class="w"> </span><span class="se">\</span>
--use-hybrid-bundle-adjustment<span class="w"> </span>--build-overviews<span class="w"> </span>--time<span class="w"> </span>--min-num-features<span class="w"> </span><span class="m">10000</span><span class="w"> </span><span class="se">\</span>
--project-path<span class="w"> </span>/datasets
</pre></div>
Expand Down
Binary file modified es/.doctrees/environment.pickle
Binary file not shown.
Binary file modified es/.doctrees/flowchart.doctree
Binary file not shown.
Binary file modified es/.doctrees/tutorials.doctree
Binary file not shown.
7 changes: 3 additions & 4 deletions es/_sources/tutorials.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ Creating High Quality Orthophotos
Without any parameter tweaks, ODM chooses a good compromise between quality, speed and memory usage. If you want to get higher quality results, you need to tweak some parameters:

* ``--orthophoto-resolution`` is the resolution of the orthophoto in cm/pixel. Decrease this value for a higher resolution result.
* ``--ignore-gsd`` is a flag that instructs ODM to skip certain memory and speed optimizations that directly affect the orthophoto. Using this flag will increase runtime and memory usage, but may produce sharper results.
* ``--texturing-data-term`` should be set to `area` in forest areas.
* ``--mesh-size`` should be increased to ``300000-600000`` and ``--mesh-octree-depth`` should be increased to ``10-11`` in urban areas to recreate better buildings / roofs.

Expand Down Expand Up @@ -496,7 +495,7 @@ Resize droplet, pull pin, run away

::

nohup python run.py myproject --split 1 --split-overlap 0 --ignore-gsd --depthmap-resolution 1000 --orthophoto-resolution 5 --dem-resolution 15 --pc-las --dsm
nohup python run.py myproject --split 1 --split-overlap 0 --depthmap-resolution 1000 --orthophoto-resolution 5 --dem-resolution 15 --pc-las --dsm

- This points ODM at the folder (in this example)
``/mnt/odmdata/myproject/``. Provided the image_groups.txt and
Expand Down Expand Up @@ -894,9 +893,9 @@ Like with docker, additional `Options and Flags <https://docs.opendronemap.org/a
singularity run --bind /my/project:/datasets/code \
--writable-tmpfs odm_latest.sif \
--orthophoto-png --mesh-octree-depth 12 --ignore-gsd --dtm \
--orthophoto-png --mesh-octree-depth 12 --dtm \
--smrf-threshold 0.4 --smrf-window 24 --dsm --pc-csv --pc-las --orthophoto-kmz \
--ignore-gsd --matcher-type flann --feature-quality ultra --max-concurrency 16 \
--matcher-type flann --feature-quality ultra --max-concurrency 16 \
--use-hybrid-bundle-adjustment --build-overviews --time --min-num-features 10000 \
--project-path /datasets
Expand Down
4 changes: 2 additions & 2 deletions es/flowchart/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@
<script src="https://unpkg.com/d3/dist/d3.min.js"></script>
<script>
window.addEventListener("load", function () {
var svgs = d3.selectAll(".mermaid#id-234ecbde-6621-4699-8043-a44478631313 svg");
var svgs = d3.selectAll(".mermaid#id-a48cdc88-be5a-4965-b303-57859526dd06 svg");
svgs.each(function() {
var svg = d3.select(this);
svg.html("<g>" + svg.html() + "</g>");
Expand Down Expand Up @@ -468,7 +468,7 @@

<section id="flowchart-with-options">
<h1>Flowchart with options<a class="headerlink" href="#flowchart-with-options" title="Enlace permanente a este encabezado"></a></h1>
<div id="id-234ecbde-6621-4699-8043-a44478631313" class="mermaid">
<div id="id-a48cdc88-be5a-4965-b303-57859526dd06" class="mermaid">
flowchart TB


Expand Down
2 changes: 1 addition & 1 deletion es/searchindex.js

Large diffs are not rendered by default.

7 changes: 3 additions & 4 deletions es/tutorials/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -461,7 +461,6 @@ <h2>Creación de Ortofotos de Alta Calidad<a class="headerlink" href="#creating-
<blockquote>
<div><ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">--orthophoto-resolution</span></code> es la resolución de la ortofoto en cm/pixel. Disminuya este valor para obtener un resultado de mayor resolución.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">--ignore-gsd</span></code> es un indicador de instruye a ODM a omitir ciertas optimizaciones de memoria y velocidad que afectan la ortofoto. El uso de este indicador aumentará el tiempo de ejecución y el uso de la memoria, pero puede producir resultados mas nítidos.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">--texturing-data-term</span></code> debe establecerse en <cite>area</cite> para áreas forestales.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">--mesh-size</span></code> debe incrementarse a <code class="docutils literal notranslate"><span class="pre">300000-600000</span></code> y <code class="docutils literal notranslate"><span class="pre">--mesh-octree-depth</span></code> debe incrementarse a <code class="docutils literal notranslate"><span class="pre">10-11</span></code> en áreas urbanas para recrear mejor los edificios/techos.</p></li>
</ul>
Expand Down Expand Up @@ -749,7 +748,7 @@ <h4>Cambie el tamaño del Droplet, quite el seguro, huya<a class="headerlink" hr
</ul>
</li>
</ul>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">nohup</span> <span class="n">python</span> <span class="n">run</span><span class="o">.</span><span class="n">py</span> <span class="n">myproject</span> <span class="o">--</span><span class="n">split</span> <span class="mi">1</span> <span class="o">--</span><span class="n">split</span><span class="o">-</span><span class="n">overlap</span> <span class="mi">0</span> <span class="o">--</span><span class="n">ignore</span><span class="o">-</span><span class="n">gsd</span> <span class="o">--</span><span class="n">depthmap</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">1000</span> <span class="o">--</span><span class="n">orthophoto</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">5</span> <span class="o">--</span><span class="n">dem</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">15</span> <span class="o">--</span><span class="n">pc</span><span class="o">-</span><span class="n">las</span> <span class="o">--</span><span class="n">dsm</span>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">nohup</span> <span class="n">python</span> <span class="n">run</span><span class="o">.</span><span class="n">py</span> <span class="n">myproject</span> <span class="o">--</span><span class="n">split</span> <span class="mi">1</span> <span class="o">--</span><span class="n">split</span><span class="o">-</span><span class="n">overlap</span> <span class="mi">0</span> <span class="o">--</span><span class="n">depthmap</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">1000</span> <span class="o">--</span><span class="n">orthophoto</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">5</span> <span class="o">--</span><span class="n">dem</span><span class="o">-</span><span class="n">resolution</span> <span class="mi">15</span> <span class="o">--</span><span class="n">pc</span><span class="o">-</span><span class="n">las</span> <span class="o">--</span><span class="n">dsm</span>
</pre></div>
</div>
<ul class="simple">
Expand Down Expand Up @@ -990,9 +989,9 @@ <h4>Using Singularity SIF image<a class="headerlink" href="#using-singularity-si
<p>Like with docker, additional <a class="reference external" href="https://docs.opendronemap.org/arguments/">Options and Flags</a> can be added to the command :</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>singularity<span class="w"> </span>run<span class="w"> </span>--bind<span class="w"> </span>/my/project:/datasets/code<span class="w"> </span><span class="se">\</span>
--writable-tmpfs<span class="w"> </span>odm_latest.sif<span class="w"> </span><span class="se">\</span>
--orthophoto-png<span class="w"> </span>--mesh-octree-depth<span class="w"> </span><span class="m">12</span><span class="w"> </span>--ignore-gsd<span class="w"> </span>--dtm<span class="w"> </span><span class="se">\</span>
--orthophoto-png<span class="w"> </span>--mesh-octree-depth<span class="w"> </span><span class="m">12</span><span class="w"> </span>--dtm<span class="w"> </span><span class="se">\</span>
--smrf-threshold<span class="w"> </span><span class="m">0</span>.4<span class="w"> </span>--smrf-window<span class="w"> </span><span class="m">24</span><span class="w"> </span>--dsm<span class="w"> </span>--pc-csv<span class="w"> </span>--pc-las<span class="w"> </span>--orthophoto-kmz<span class="w"> </span><span class="se">\</span>
--ignore-gsd<span class="w"> </span>--matcher-type<span class="w"> </span>flann<span class="w"> </span>--feature-quality<span class="w"> </span>ultra<span class="w"> </span>--max-concurrency<span class="w"> </span><span class="m">16</span><span class="w"> </span><span class="se">\</span>
--matcher-type<span class="w"> </span>flann<span class="w"> </span>--feature-quality<span class="w"> </span>ultra<span class="w"> </span>--max-concurrency<span class="w"> </span><span class="m">16</span><span class="w"> </span><span class="se">\</span>
--use-hybrid-bundle-adjustment<span class="w"> </span>--build-overviews<span class="w"> </span>--time<span class="w"> </span>--min-num-features<span class="w"> </span><span class="m">10000</span><span class="w"> </span><span class="se">\</span>
--project-path<span class="w"> </span>/datasets
</pre></div>
Expand Down
Binary file modified fil/.doctrees/environment.pickle
Binary file not shown.
Binary file modified fil/.doctrees/flowchart.doctree
Binary file not shown.
Binary file modified fil/.doctrees/tutorials.doctree
Binary file not shown.
Loading

0 comments on commit 718fe9c

Please sign in to comment.