aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations/projections/tpers.rst
blob: 1d36b07cfd3b2dccd74ccd7aa2c032d460ab2f1d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
.. _tpers:

********************************************************************************
Tilted perspective
********************************************************************************
+---------------------+----------------------------------------------------------+
| **Classification**  | Azimuthal                                                |
+---------------------+----------------------------------------------------------+
| **Available forms** | Forward and inverse, spherical projection                |
+---------------------+----------------------------------------------------------+
| **Defined area**    | Global                                                   |
+---------------------+----------------------------------------------------------+
| **Alias**           | tpers                                                    |
+---------------------+----------------------------------------------------------+
| **Domain**          | 2D                                                       |
+---------------------+----------------------------------------------------------+
| **Input type**      | Geodetic coordinates                                     |
+---------------------+----------------------------------------------------------+
| **Output type**     | Projected coordinates                                    |
+---------------------+----------------------------------------------------------+



.. image:: ./images/tpers.png
   :scale: 50%
   :alt:   Tilted perspective


Tilted Perspective is similar to :ref:`nsper` (``nsper``) in that it simulates a
perspective view from a height. Where ``nsper`` projects onto a plane tangent to
the surface, Tilted Perspective orients the plane towards the direction of the
view. Thus, extra parameters specifying azimuth and tilt are required beyond
`nsper``'s ``h``. As with ``nsper``, ``lat_0`` & ``lon_0`` are
also required for satellite position.

Parameters
################################################################################

Required
-------------------------------------------------------------------------------

.. include:: ../options/h.rst

Optional
-------------------------------------------------------------------------------

.. option:: +azi=<value>

    Bearing in degrees away from north.

    *Defaults to 0.0.*

.. option:: +tilt=<value>

    Angle in degrees away from nadir.

    *Defaults to 0.0.*

.. include:: ../options/lon_0.rst

.. include:: ../options/lat_0.rst

.. include:: ../options/R.rst

.. include:: ../options/x_0.rst

.. include:: ../options/y_0.rst