Skip to content

Commit

Permalink
Add matcher-order, sfm-no-partial, cleanup ignore-gsd and *-resolution
Browse files Browse the repository at this point in the history
  • Loading branch information
Brett Carlock authored and Brett Carlock committed Jul 29, 2023
1 parent 2fef9f6 commit 2cb9dc6
Show file tree
Hide file tree
Showing 8 changed files with 44 additions and 6 deletions.
6 changes: 3 additions & 3 deletions source/arguments.rst
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ Options and Flags
Number of steps used to fill areas with gaps. Set to 0 to disable gap filling. Starting with a radius equal to the output resolution, N different DEMs are generated with progressively bigger radius using the inverse distance weighted (IDW) algorithm and merged together. Remaining gaps are then merged using nearest neighbor interpolation. Default: ``3``

:ref:`dem-resolution<dem-resolution>` <float>
DSM/DTM resolution in cm / pixel. Note that this value is capped to 2x the ground sampling distance (GSD) estimate. To remove the cap, check --ignore-gsd also. Default: ``5``
DSM/DTM resolution in cm / pixel. Note that this value is capped by a ground sampling distance (GSD) estimate. Default: ``5``

:ref:`dsm<dsm>`
Use this tag to build a DSM (Digital Surface Model, ground + objects) using a progressive morphological filter. Check the --dem\* parameters for finer tuning. Default: ``False``
Expand Down Expand Up @@ -93,7 +93,7 @@ Options and Flags
show this help message and exit

:ref:`ignore-gsd<ignore-gsd>`
Ignore Ground Sampling Distance (GSD). GSD caps the maximum resolution of image outputs and resizes images when necessary, resulting in faster processing and lower memory usage. Since GSD is an estimate, sometimes ignoring it can result in slightly better image output quality. Default: ``False``
Ignore Ground Sampling Distance (GSD).A memory and processor hungry change relative to the default behavior if set to true. Ordinarily, GSD estimates are used to cap the maximum resolution of image outputs and resizes images when necessary, resulting in faster processing and lower memory usage. Since GSD is an estimate, sometimes ignoring it can result in slightly better image output quality. Never set --ignore-gsd to true unless you are positive you need it, and even then: do not use it. Default: ``False``

:ref:`matcher-neighbors<matcher-neighbors>` <positive integer>
Perform image matching with the nearest images based on GPS exif data. Set to 0 to match by triangulation. Default: ``0``
Expand Down Expand Up @@ -144,7 +144,7 @@ Options and Flags
Set this parameter if you want to generate a PNG rendering of the orthophoto. Default: ``False``

:ref:`orthophoto-resolution<orthophoto-resolution>` <float > 0.0>
Orthophoto resolution in cm / pixel. Note that this value is capped by a ground sampling distance (GSD) estimate. To remove the cap, check --ignore-gsd also. Default: ``5``
Orthophoto resolution in cm / pixel. Note that this value is capped by a ground sampling distance (GSD) estimate.Default: ``5``

:ref:`pc-classify<pc-classify>`
Classify the point cloud outputs. You can control the behavior of this option by tweaking the --dem-\* parameters. Default: ``False``
Expand Down
2 changes: 1 addition & 1 deletion source/arguments/dem-resolution.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ dem-resolution

**Options:** *<float>*

DSM/DTM resolution in cm / pixel. Note that this value is capped to 2x the ground sampling distance (GSD) estimate. To remove the cap, check --ignore-gsd also. Default: ``5``
DSM/DTM resolution in cm / pixel. Note that this value is capped by a ground sampling distance (GSD) estimate. Default: ``5``



Expand Down
2 changes: 1 addition & 1 deletion source/arguments/ignore-gsd.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ ignore-gsd



Ignore Ground Sampling Distance (GSD). GSD caps the maximum resolution of image outputs and resizes images when necessary, resulting in faster processing and lower memory usage. Since GSD is an estimate, sometimes ignoring it can result in slightly better image output quality. Default: ``False``
Ignore Ground Sampling Distance (GSD).A memory and processor hungry change relative to the default behavior if set to true. Ordinarily, GSD estimates are used to cap the maximum resolution of image outputs and resizes images when necessary, resulting in faster processing and lower memory usage. Since GSD is an estimate, sometimes ignoring it can result in slightly better image output quality. Never set --ignore-gsd to true unless you are positive you need it, and even then: do not use it. Default: ``False``



Expand Down
18 changes: 18 additions & 0 deletions source/arguments/matcher-order.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
..
AUTO-GENERATED by extract_odm_strings.py! DO NOT EDIT!
If you want to add more details to a command, edit a
.rst file in arguments_edit/<argument>.rst
.. _matcher-order:

matcher-order
`````````````

**Options:** *<positive integer>*

Perform image matching with the nearest N images based on image filename order. Can speed up processing of sequential images, such as those extracted from video. It is applied only on non-georeferenced datasets. Set to 0 to disable. Default: ``0``




`Learn to edit <https://github.com/opendronemap/docs#how-to-make-your-first-contribution>`_ and help improve `this page <https://github.com/OpenDroneMap/docs/blob/publish/source/arguments_edit/matcher-order.rst>`_!
2 changes: 1 addition & 1 deletion source/arguments/orthophoto-resolution.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ orthophoto-resolution

**Options:** *<float > 0.0>*

Orthophoto resolution in cm / pixel. Note that this value is capped by a ground sampling distance (GSD) estimate. To remove the cap, check --ignore-gsd also. Default: ``5``
Orthophoto resolution in cm / pixel. Note that this value is capped by a ground sampling distance (GSD) estimate.Default: ``5``



Expand Down
18 changes: 18 additions & 0 deletions source/arguments/sfm-no-partial.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
..
AUTO-GENERATED by extract_odm_strings.py! DO NOT EDIT!
If you want to add more details to a command, edit a
.rst file in arguments_edit/<argument>.rst
.. _sfm-no-partial:

sfm-no-partial
``````````````



Do not attempt to merge partial reconstructions. This can happen when images do not have sufficient overlap or are isolated. Default: ``False``




`Learn to edit <https://github.com/opendronemap/docs#how-to-make-your-first-contribution>`_ and help improve `this page <https://github.com/OpenDroneMap/docs/blob/publish/source/arguments_edit/sfm-no-partial.rst>`_!
1 change: 1 addition & 0 deletions source/arguments_edit/matcher-order.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@

1 change: 1 addition & 0 deletions source/arguments_edit/sfm-no-partial.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@

0 comments on commit 2cb9dc6

Please sign in to comment.