-
Notifications
You must be signed in to change notification settings - Fork 751
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
eqc documentation matching template (version 3) #415
Merged
Merged
Changes from all commits
Commits
Show all changes
3 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,10 +1,109 @@ | ||
.. _eqc: | ||
|
||
******************************************************************************** | ||
Equidistant Cylindrical (Plate Caree) | ||
Equidistant Cylindrical (Plate Carrée) | ||
******************************************************************************** | ||
|
||
The simplest of all projections. Standard parallels (0° when omitted) may be specified that determine latitude of true scale (k=h=1). | ||
|
||
+---------------------+----------------------------------------------------------+ | ||
| **Classification** | Conformal cylindrical | | ||
+---------------------+----------------------------------------------------------+ | ||
| **Available forms** | Forward and inverse | | ||
+---------------------+----------------------------------------------------------+ | ||
| **Defined area** | Global, but best used near the equator | | ||
+---------------------+----------------------------------------------------------+ | ||
| **Implemented by** | Gerald I. Evenden | | ||
+---------------------+----------------------------------------------------------+ | ||
| **Options** | | ||
+---------------------+----------------------------------------------------------+ | ||
| `+lat_ts` | Latitude of true scale. Defaults to 0.0 | | ||
+---------------------+----------------------------------------------------------+ | ||
| `+lat_0` | Center of the map : latitude of origin | | ||
+---------------------+----------------------------------------------------------+ | ||
|
||
.. image:: ./images/eqc.png | ||
:scale: 50% | ||
:alt: Equidistant Cylindrical (Plate Caree) | ||
:alt: Equidistant Cylindrical (Plate Carrée) | ||
|
||
Usage | ||
######## | ||
|
||
Because of the distortions introduced by this projection, it has little use in navigation or cadastral mapping and finds its main use in thematic mapping. In particular, the plate carrée has become a standard for global raster datasets, such as Celestia and NASA World Wind, because of the particularly simple relationship between the position of an image pixel on the map and its corresponding geographic location on Earth. | ||
|
||
The following table gives special cases of the cylindrical equidistant projection. | ||
|
||
+---------------------------------------------------------+--------------------------+ | ||
| Projection Name | (lat ts=) :math:`\phi_0` | | ||
+---------------------------------------------------------+--------------------------+ | ||
| Plain/Plane Chart | 0° | | ||
+---------------------------------------------------------+--------------------------+ | ||
| Simple Cylindrical | 0° | | ||
+---------------------------------------------------------+--------------------------+ | ||
| Plate Carrée | 0° | | ||
+---------------------------------------------------------+--------------------------+ | ||
| Ronald Miller—minimum overall scale distortion | 37°30′ | | ||
+---------------------------------------------------------+--------------------------+ | ||
| E.Grafarend and A.Niermann | 42° | | ||
+---------------------------------------------------------+--------------------------+ | ||
| Ronald Miller—minimum continental scale distortion | 43°30′ | | ||
+---------------------------------------------------------+--------------------------+ | ||
| Gall Isographic | 45° | | ||
+---------------------------------------------------------+--------------------------+ | ||
| Ronald Miller Equirectangular | 50°30′ | | ||
+---------------------------------------------------------+--------------------------+ | ||
| E.Grafarend and A.Niermann minimum linear distortion | 61°7′ | | ||
+---------------------------------------------------------+--------------------------+ | ||
|
||
|
||
Example using EPSG 32662 (WGS84 Plate Carrée):: | ||
|
||
$ echo 2 47 | proj +proj=eqc +lat_ts=0 +lat_0=0 +lon_0=0 +x_0=0 +y_0=0 +ellps=WGS84 +datum=WGS84 +units=m +no_defs | ||
222638.98 5232016.07 | ||
|
||
Example using Plate Carrée projection with shorelines : 30° graticule and central meridian 90°W:: | ||
|
||
$ echo -88 30 | proj +proj=eqc +lat_ts=30 +lat_0=90w | ||
-8483684.61 13358338.90 | ||
|
||
|
||
Mathematical definition | ||
####################### | ||
|
||
The formulas describing the Equidistant Cylindrical projection are all taken from proj4 sources. | ||
|
||
:math:`phi_{ts}` is the latitude of true scale, that mean the standard parallels where the scale of the projection is true. It can be set with "lat_ts". | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I think there's a backslash missing here. Same for the line below. |
||
|
||
:math:`phi_0` is the latitude of origin that match the center of the map. It can be set with "lat_0". | ||
|
||
|
||
Forward projection | ||
================== | ||
|
||
.. math:: | ||
|
||
x = \lambda \cos \phi_{ts} | ||
|
||
.. math:: | ||
|
||
y = \phi - \phi_0 | ||
|
||
Inverse projection | ||
================== | ||
|
||
.. math:: | ||
|
||
\lambda = x / cos \phi_{ts} | ||
|
||
.. math:: | ||
|
||
\phi = y + \phi_0 | ||
|
||
|
||
Further reading | ||
############### | ||
|
||
#. `Wikipedia <https://en.wikipedia.org/wiki/Equirectangular_projection>`_ | ||
#. `Wolfram Mathworld <http://mathworld.wolfram.com/CylindricalEquidistantProjection.html>`_ | ||
|
||
|
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This section would be more clear if some of the variables are defined here. Like phi_ts is the latitude of true scale and can be set with +lat_ts.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I tryed something with the parameters.
You may have a look on it ?
I feel it is important to evaluate the quality before stepping to an other projection doc.