aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations/projections/ob_tran.rst
blob: 378f133325e30ec4125b91456fd87ae2b3234e88 (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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
.. _ob_tran:

********************************************************************************
General Oblique Transformation
********************************************************************************

.. figure:: ./images/ob_tran.png
   :width: 500 px
   :align: center
   :alt:   General Oblique Transformation

   proj-string: ``+proj=ob_tran +o_proj=mill +o_lon_p=40 +o_lat_p=50 +lon_0=60``

Usage
################################################################################

All of the projections of spherical library can be used as an
oblique projection by means of the General Oblique Transformation. The user
performs the oblique transformation by selecting the oblique projection
``+proj=ob_tran``, specifying the translation factors, :option:`+o_lat_p`, and
:option:`+o_lon_p`, and the projection to be used, :option:`+o_proj`. In the
example of the Fairgrieve projection the latitude and longitude of the pole of
the new coordinates, :math:`\alpha` and :math:`\beta` respectively, are to be placed
at 45°N and 90°W and use the :ref:`moll` projection. Because the central meridian
of the translated coordinates will follow the :math:`\beta` meridian it is
necessary to translate the translated system so that the Greenwich meridian
will pass through the center of the projection by offsetting the central meridian.

The final control for this projection is::

    +proj=ob_tran +o_proj=moll +o_lat_p=45 +o_lon_p=-90 +lon_0=-90

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

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

.. option:: +o_proj=<projection>

    Oblique projection.

In addition to specifying an oblique projection, *how* to rotate the projection
should be specified. This is done in one of three ways: Define a new pole,
rotate the projection about a given point or define a new "equator" spanned by
two points on the sphere. See the details below.

New pole
................................................................................

.. option:: +o_lat_p=<latitude>

    Latitude of new pole for oblique projection.

.. option:: +o_lon_p=<longitude>

    Longitude of new pole for oblique projection.

Rotate about point
................................................................................

.. option:: +o_alpha=<value>

    Angle to rotate the projection with.

.. option:: +o_lon_c=<value>

    Longitude of the point the projection will be rotated about.

.. option:: +o_lat_c=<value>

    Latitude of the point the projection will be rotated about.

New "equator" points
................................................................................

.. option:: +lon_1=<value>

    Longitude of first point.

.. option:: +lat_1=<value>

    Latitude of first point.

.. option:: +lon_2=<value>

    Longitude of second point.

.. option:: +lat_2=<value>

    Latitude of second point.

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

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

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

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

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