tweaks

source/flying.rst

@@ -1,7 +1,7 @@
 Flying tips
 ===========
 
-The Humanitarian OpenStreetMap team has guidelines on `flying for UAV mapping <https://uav-guidelines.openaerialmap.org/>`_:
+The `Humanitarian OpenStreetMap team <https://www.hotosm.org/>`_ has guidelines on `flying for UAV mapping <https://uav-guidelines.openaerialmap.org/>`_:
 
 - `Choosing the right UAV <https://uav-guidelines.openaerialmap.org/pages/05-choosing-the-right-uav/>`_ 
 
@@ -9,7 +9,7 @@ The Humanitarian OpenStreetMap team has guidelines on `flying for UAV mapping <h
 
 - `Mission preparation <https://uav-guidelines.openaerialmap.org/pages/07-preparing-for-the-uav-mission/>`_
 
-The guidelines are intended for mapping projects on islands, but have general use for all drone mappers.
+The guidelines are intended for drone mapping projects on islands, but have general use for all drone mappers.
 
 See also DroneDeploy's guide on `Making Successful Maps <https://support.dronedeploy.com/docs/making-successful-maps>`_, which provides great tips on mission planning.
 

source/large.rst

@@ -12,7 +12,13 @@ Split-merge works in WebODM out of the box as long as the processing nodes suppo
 Calibrate images
 ----------------
 
-Image calibration is recommended (but not required) for large datasets because error propagation due to image distortion could cause a bowl effect on the models. Calibration instructions can be found at `Calibrate Images <using.html#calibrating-the-camera>`_.
+Image calibration is recommended (but not required) for large datasets because error propagation due to image distortion could cause a bowl effect on the models. Calibration instructions can be found at 	`Calibrate Images <using.html#calibrating-the-camera>`_.
+
+.. figure:: images/msimbasi_bowling.png
+   :alt: image of lens distortion effect on bowling of data
+   :align: center
+
+Bowling effect on point cloud over 13,000+ image dataset collected by World Bank Tanzania over the flood prone Msimbasi Basin, Dar es Salaam, Tanzania.
 
 Local Split-Merge
 -----------------

source/outputs.rst

@@ -36,7 +36,6 @@ Orthophoto
    :alt: image of OpenDroneMap orthophoto
    :align: center
 
-
 DTM/DSM
 ^^^^^^^
 

source/using.rst

@@ -3,7 +3,6 @@
 Usage
 =====
 
-
 .. _docker-usage:
 
 Docker
@@ -52,11 +51,15 @@ Then sit back, grab a coffee and wait. You only have to specify ``--images </pat
 Tutorials
 ---------
 
-Below you will find step-by-step instructions for some common use cases.
+Below you will find instructions for some common use cases.
 
 Creating High Quality Orthophotos
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+.. figure:: images/orthophoto.png
+   :alt: image of OpenDroneMap orthophoto
+   :align: center
+
 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.
@@ -68,7 +71,11 @@ Without any parameter tweaks, ODM chooses a good compromise between quality, spe
 Creating Digital Elevation Models
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-By default ODM does not create DEMs. To create a digital terrain model, make sure to pass the ``--dtm`` flag.
+By default ODM does not create DEMs. To create a digital terrain model, make sure to pass the ``--dtm`` flag. To create a digital surface model, be sure to pass the ``--dsm`` flag.
+
+.. figure:: images/digitalsurfacemodel.png
+   :alt: image of OpenDroneMap derived digital surface model
+   :align: center
 
 For DTM generation, a Simple Morphological Filter (smrf) is used to classify points in ground vs. non-ground and only the ground points are used. The ``smrf`` filter can be controlled via several parameters: