From 75b70f7af9a1ac5cee5b247f704a7e849e39c450 Mon Sep 17 00:00:00 2001
From: Piero Toffanin <pt@masseranolabs.com>
Date: Mon, 9 Mar 2020 18:03:59 -0400
Subject: [PATCH] Added multispectral section

---
 source/arguments.rst     | 13 +++++++++++++
 source/conf.py           |  4 ++--
 source/index.rst         |  1 +
 source/multispectral.rst | 25 +++++++++++++++++++++++++
 4 files changed, 41 insertions(+), 2 deletions(-)
 create mode 100644 source/multispectral.rst

diff --git a/source/arguments.rst b/source/arguments.rst
index 1d910d20f..ecab36a90 100644
--- a/source/arguments.rst
+++ b/source/arguments.rst
@@ -56,6 +56,19 @@ Arguments::
                         can help improve geometric undistortion. By default the application
                         tries to determine a lens type from the images metadata.
 						Default: auto
+  --radiometric-calibration <string>
+                        Set the radiometric calibration to perform on images.
+                        When processing multispectral images you should set
+                        this option to obtain reflectance values (otherwise
+                        you will get digital number (DN) values). [camera]
+                        applies black level, vignetting, row gradient
+                        gain/exposure compensation (if appropriate EXIF tags
+                        are found). [camera+sun] is experimental, applies all
+                        the corrections of [camera] and additionally
+                        compensates for spectral radiance registered via a
+                        downwelling light sensor (DLS) taking in consideration
+                        the angle of the sun. Can be set to one of: [none,
+                        camera, camera+sun]. Default: none
   --max-concurrency <positive integer>
                         The maximum number of processes to use in various
                         processes. Peak memory requirement is ~1GB per thread
diff --git a/source/conf.py b/source/conf.py
index 32b5fef7b..b2dc4ba54 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -14,9 +14,9 @@ copyright = '2020, OpenDroneMap'
 author = 'OpenDroneMap'
 
 # The short X.Y version
-version = '0.9.8'
+version = '0.9.9'
 # The full version, including alpha/beta/rc tags
-release = '0.9.8'
+release = '0.9.9'
 
 
 # -- General configuration ---------------------------------------------------
diff --git a/source/index.rst b/source/index.rst
index 25b8174dc..373eda498 100644
--- a/source/index.rst
+++ b/source/index.rst
@@ -35,6 +35,7 @@ Welcome to OpenDroneMap's documentation
     large
     resources
     flying
+    multispectral
     contributing
 
 `Help edit these docs! <https://github.com/OpenDroneMap/docs/blob/publish/source/index.rst>`_
\ No newline at end of file
diff --git a/source/multispectral.rst b/source/multispectral.rst
new file mode 100644
index 000000000..a93ca4025
--- /dev/null
+++ b/source/multispectral.rst
@@ -0,0 +1,25 @@
+Multispectral Support
+=====================
+
+Since version 0.9.9 ODM has basic support for radiometric normalization, which is able to generate reflectance orthophotos from multispectral cameras. Multispectral cameras capture multiple shots of the scene using different band sensors.
+
+Hardware
+--------
+
+While we aim to support as many cameras as possible, multispectral support has been developed using the following cameras, so they will work better:
+
+ * `MicaSense RedEdge-MX and Altum <https://www.micasense.com/>`_
+ * `Sentera 6X <https://sentera.com/6x/>`_
+
+Other cameras might also work. You can help us expand this list by `sharing datasets <https://community.opendronemap.org/c/datasets/10>`_ captured with other cameras.
+
+Usage
+-----
+
+Process all the images from all bands at once (do not separate the bands into multiple folders) and pass the `--radiometric-calibration` parameter to enable radiometric normalization. If the images are part of a multi-camera setup, the resulting orthophoto will have N bands, one for each camera (+ alpha).
+
+
+
+
+
+`Help edit these docs! <https://github.com/OpenDroneMap/docs/blob/publish/source/multispectral.rst>`_
\ No newline at end of file