From d775b0b07bf8b7f3c78ec259238265d15abac224 Mon Sep 17 00:00:00 2001
From: Even Rouault <even.rouault@spatialys.com>
Date: Sat, 23 Feb 2019 15:16:56 +0100
Subject: Doc: add minimal documentation for sch projection

---
 docs/source/operations/projections/index.rst |  1 +
 docs/source/operations/projections/sch.rst   | 65 ++++++++++++++++++++++++++++
 docs/source/references.bib                   |  8 ++++
 3 files changed, 74 insertions(+)
 create mode 100644 docs/source/operations/projections/sch.rst

(limited to 'docs')

diff --git a/docs/source/operations/projections/index.rst b/docs/source/operations/projections/index.rst
index 1e893e97..b2f57987 100644
--- a/docs/source/operations/projections/index.rst
+++ b/docs/source/operations/projections/index.rst
@@ -118,6 +118,7 @@ Projections map the spherical 3D space to a flat 2D space.
    robin
    rouss
    rpoly
+   sch
    sinu
    somerc
    stere
diff --git a/docs/source/operations/projections/sch.rst b/docs/source/operations/projections/sch.rst
new file mode 100644
index 00000000..f987d75d
--- /dev/null
+++ b/docs/source/operations/projections/sch.rst
@@ -0,0 +1,65 @@
+.. _sch:
+
+********************************************************************************
+Spherical Cross-track Height
+********************************************************************************
++---------------------+--------------------------------------------------------+
+| **Classification**  | Miscellaneous                                          |
++---------------------+--------------------------------------------------------+
+| **Available forms** | Forward and inverse.                                   |
++---------------------+--------------------------------------------------------+
+| **Defined area**    | Global                                                 |
++---------------------+--------------------------------------------------------+
+| **Alias**           | sch                                                    |
++---------------------+--------------------------------------------------------+
+| **Domain**          | 3D                                                     |
++---------------------+--------------------------------------------------------+
+| **Input type**      | 3D coordinates                                         |
++---------------------+--------------------------------------------------------+
+| **Output type**     | Projected coordinates                                  |
++---------------------+--------------------------------------------------------+
+
+   proj-string: ``+proj=sch +plat_0=XX +plon_0=XX +phdg_0=XX``
+
+The SCH coordinate system is a sensor aligned coordinate system developed at
+JPL (Jet Propulsion Laboratory) for radar mapping missions.
+
+See :cite:`Hensley2002`
+
+
+Parameters
+################################################################################
+
+Required
+-------------------------------------------------------------------------------
+
+.. option:: +plat_0=<value>
+
+    Peg latitude (in degree)
+
+.. option:: +plon_0=<value>
+
+    Peg longitude (in degree)
+
+.. option:: +phdg_0=<value>
+
+    Peg heading (in degree)
+
+Optional
+-------------------------------------------------------------------------------
+
+.. option:: +h_0=<value>
+
+    Average height (in metre)
+
+    *Defaults to 0.0.*
+
+.. include:: ../options/lon_0.rst
+
+.. include:: ../options/x_0.rst
+
+.. include:: ../options/y_0.rst
+
+.. include:: ../options/ellps.rst
+
+.. include:: ../options/R.rst
diff --git a/docs/source/references.bib b/docs/source/references.bib
index fe332eab..8a0de291 100644
--- a/docs/source/references.bib
+++ b/docs/source/references.bib
@@ -140,6 +140,14 @@
   Doi                      = {10.5281/zenodo.32050}
 }
 
+@Article{Hensley2002,
+  Title                    = {Improved Processing of AIRSAR Data Based on the GeoSAR Processor},
+  Author                   = {Scott Hensley and Elaine Chapin and Adam Freedman and Thierry Michel},
+  Journal                  = {Airsar earth science and applications workshop},
+  Year                     = {2002},
+  Url                      = {https://airsar.jpl.nasa.gov/documents/workshop2002/papers/T3.pdf}
+}
+
 @Article{Jenny2014,
   Title                    = {A compromise aspect-adaptive cylindrical projection for world maps},
   Author                   = {Bernhard Jenny, Bojan Šavrič, Tom Patterson},
-- 
cgit v1.2.3