From 2cb9dc6423506a766dc9d6cfda662924f68fd422 Mon Sep 17 00:00:00 2001 From: Brett Carlock Date: Sat, 29 Jul 2023 01:16:30 -0400 Subject: [PATCH] Add matcher-order, sfm-no-partial, cleanup ignore-gsd and *-resolution --- source/arguments.rst | 6 +++--- source/arguments/dem-resolution.rst | 2 +- source/arguments/ignore-gsd.rst | 2 +- source/arguments/matcher-order.rst | 18 ++++++++++++++++++ source/arguments/orthophoto-resolution.rst | 2 +- source/arguments/sfm-no-partial.rst | 18 ++++++++++++++++++ source/arguments_edit/matcher-order.rst | 1 + source/arguments_edit/sfm-no-partial.rst | 1 + 8 files changed, 44 insertions(+), 6 deletions(-) create mode 100644 source/arguments/matcher-order.rst create mode 100644 source/arguments/sfm-no-partial.rst create mode 100644 source/arguments_edit/matcher-order.rst create mode 100644 source/arguments_edit/sfm-no-partial.rst diff --git a/source/arguments.rst b/source/arguments.rst index 0b82ed94e..b95e4eaa2 100644 --- a/source/arguments.rst +++ b/source/arguments.rst @@ -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` - 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` 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`` @@ -93,7 +93,7 @@ Options and Flags show this help message and exit :ref:`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` Perform image matching with the nearest images based on GPS exif data. Set to 0 to match by triangulation. Default: ``0`` @@ -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` 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` Classify the point cloud outputs. You can control the behavior of this option by tweaking the --dem-\* parameters. Default: ``False`` diff --git a/source/arguments/dem-resolution.rst b/source/arguments/dem-resolution.rst index 1449fb80d..e923c2bb8 100644 --- a/source/arguments/dem-resolution.rst +++ b/source/arguments/dem-resolution.rst @@ -10,7 +10,7 @@ dem-resolution **Options:** ** -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`` diff --git a/source/arguments/ignore-gsd.rst b/source/arguments/ignore-gsd.rst index c67fb1a9e..fa7f1cc24 100644 --- a/source/arguments/ignore-gsd.rst +++ b/source/arguments/ignore-gsd.rst @@ -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`` diff --git a/source/arguments/matcher-order.rst b/source/arguments/matcher-order.rst new file mode 100644 index 000000000..f3005ec0e --- /dev/null +++ b/source/arguments/matcher-order.rst @@ -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/.rst + +.. _matcher-order: + +matcher-order +````````````` + +**Options:** ** + +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 `_ and help improve `this page `_! diff --git a/source/arguments/orthophoto-resolution.rst b/source/arguments/orthophoto-resolution.rst index 3494a02f9..d2988d91f 100644 --- a/source/arguments/orthophoto-resolution.rst +++ b/source/arguments/orthophoto-resolution.rst @@ -10,7 +10,7 @@ orthophoto-resolution **Options:** * 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`` diff --git a/source/arguments/sfm-no-partial.rst b/source/arguments/sfm-no-partial.rst new file mode 100644 index 000000000..47e3f2b6e --- /dev/null +++ b/source/arguments/sfm-no-partial.rst @@ -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/.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 `_ and help improve `this page `_! diff --git a/source/arguments_edit/matcher-order.rst b/source/arguments_edit/matcher-order.rst new file mode 100644 index 000000000..8b1378917 --- /dev/null +++ b/source/arguments_edit/matcher-order.rst @@ -0,0 +1 @@ + diff --git a/source/arguments_edit/sfm-no-partial.rst b/source/arguments_edit/sfm-no-partial.rst new file mode 100644 index 000000000..8b1378917 --- /dev/null +++ b/source/arguments_edit/sfm-no-partial.rst @@ -0,0 +1 @@ +