Merge pull request #210 from smathermather/multi_temporal

Move align into tutorials, bring multi-temporal under align

Author: smathermather

source/align.rst

@@ -1,3 +1,12 @@
+.. _align:
+
+align
+`````
+
+**Options:** *<path string>*
+
+Path to a GeoTIFF DEM or a LAS/LAZ point cloud that the reconstruction outputs should be automatically aligned to. Experimental. Default: ``None``
+
 See `Multi-temporal datasets for further usage information. </tutorials/#multi-temporal-datasets>`_
 
 Uses `CODEM <https://github.com/NCALM-UH/CODEM>`_, credits to Craig Glennie and the group at CRREL.
@@ -9,3 +18,7 @@ The details of the method are available at https://github.com/NCALM-UH/CODEM/blo
    :align: center
 
 Animated gif comparing two separately processed, but aligned digital surface models.
+
+
+`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/align.rst>`_!
+

source/arguments_edit/align.rst

@@ -820,6 +820,20 @@ For instance, point clouds properties can be modified to show elevation and also
 
 `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/tutorials.rst>`_!
 
+
+###############
+Alignment Files
+###############
+
+Georeferencing by default is done using GPS or GCPs (if provided).
+
+Starting from ODM ``3.0.2`` people can supply a reference alignment file to georeference the program outputs. The reconstruction will be initially performed using GPS/GCPs and will subsequently be aligned to the reference model via a linear scaling/rotation/shift operation. 
+
+If you supply a file called ``align.laz``, ``align.las`` or ``align.tif`` (single band GeoTIFF DEM) then ODM will automatically detect it and attempt to align outputs to this reference model. If it has another name you can specify using ``--align <path>``.
+
+The alignment file must be created in the base of your project folder. The base folder is usually where you have stored your images. If you are using WebODM or NodeODM, then upload the align file with your images. If resizing your images in WebODM, use an ``align.laz`` or ``align.las`` file instead of a tif.
+
+
 ********
 Multi-temporal Datasets
 ********