Skip to content

Commit

Permalink
Mention the jitter_solve --reference-terrain option where needed
Browse files Browse the repository at this point in the history
  • Loading branch information
oleg-alexandrov committed Sep 15, 2024
1 parent 858a45d commit 4ca5f58
Show file tree
Hide file tree
Showing 2 changed files with 10 additions and 4 deletions.
7 changes: 6 additions & 1 deletion docs/next_steps.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1457,10 +1457,15 @@ These are the various approaches of integrating well-aligned prior terrain data.
- The ``jitter_solve`` program (:numref:`jitter_solve`) can be called in the
same way with the option ``--heights-from-dem``.

- For rather sparse lidar data, the ``bundle_adjust`` option named
- For sparse point clouds or DEM data, the ``bundle_adjust`` option named
``--reference-terrain`` can be invoked (:numref:`reference_terrain`).
This one is harder to use as it takes as input stereo disparities.

- The ``jitter_solve`` program also has the option ``--reference-terrain``.
This one is easier to use than the analogous ``bundle_adjust`` option, as the
unaligning of the disparity is done for the user on the fly
(:numref:`jitter_ref_terrain`).

- Low-resolution stereo disparity can be initialized from a DEM, with the
option ``--corr-seed-mode 2`` (:numref:`d_sub_dem`).

Expand Down
7 changes: 4 additions & 3 deletions docs/tools/jitter_solve.rst
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ Extrinsic constraint
This ties the triangulated ground points obtained from interest point matches to
an external DEM, which may be at a lower resolution than the images. It is
expected that this external DEM is *well-aligned* with the input cameras (see
:numref:`ba_pc_align` for how do the alignment).
:numref:`ba_pc_align` for how do the alignment).

This option is named ``--heights-from-dem``, and it is controlled via
``--heights-from-dem-uncertainty`` and ``--heights-from-dem-robust-threshold``.
Expand Down Expand Up @@ -1769,7 +1769,7 @@ Point cloud constraint

In this scenario it is assumed that a reference point cloud is available that
can constrain the jitter solution. The cloud can be in CSV format or a DEM. *The
cloud must be well-aligned with the input cameras.*
cloud must be well-aligned with the input cameras.* The cloud can be sparse.

This workflow requires having filtered stereo disparity files (``F.tif``,
:numref:`outputfiles`) as made by ``parallel_stereo``
Expand Down Expand Up @@ -1800,7 +1800,8 @@ out how they relate to the images passed in to the solver. It will undo any
alignment or mapprojection transforms as appropriate.

This workflow does not preclude using the ``--heights-from-dem`` option or
anchor points. It assumes that no rig is present and that all cameras are linescan.
anchor points. It assumes that no rig is present and that all cameras are
linescan.

If the images are mapprojected, *this option loads fully in memory the DEM that
was used for mapprojecting them*, for performance reasons, so it should not be
Expand Down

0 comments on commit 4ca5f58

Please sign in to comment.