aboutsummaryrefslogtreecommitdiff
path: root/docs/source/operations/pipeline.rst
diff options
context:
space:
mode:
authorKristian Evers <kristianevers@gmail.com>2018-03-26 23:36:15 +0200
committerKristian Evers <kristianevers@gmail.com>2018-03-27 11:37:13 +0200
commit234eba764d7fea67b597d8f9ed5225e651f4a945 (patch)
tree21895b6b3c38a93c2cb2dbe17f19115d22129587 /docs/source/operations/pipeline.rst
parent0962d1ecf116e2eeeccfa6ce5c9613407691f38c (diff)
downloadPROJ-234eba764d7fea67b597d8f9ed5225e651f4a945.tar.gz
PROJ-234eba764d7fea67b597d8f9ed5225e651f4a945.zip
Validate that units match between pipeline steps
As suggested in [0], steps in a pipeline are now checked for compliance. If the right side units in step n differ from the left side units in step n+1 the pipeline can't be constructed and an error is raised. [0] https://lists.osgeo.org/pipermail/grass-dev/2018-March/088123.html
Diffstat (limited to 'docs/source/operations/pipeline.rst')
-rw-r--r--docs/source/operations/pipeline.rst13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/source/operations/pipeline.rst b/docs/source/operations/pipeline.rst
index d7694041..abe98776 100644
--- a/docs/source/operations/pipeline.rst
+++ b/docs/source/operations/pipeline.rst
@@ -95,4 +95,17 @@ In the following the GRS80 ellipsoid will be applied to all steps.
+step +proj=cart +inv
+step +proj=merc
+**5. Units of operations must match between steps.**
+
+.. versionadded:: 5.1.0
+
+The output units of step *n* must match the expected input unit of step *n+1*. E.g., you can't
+pass an operation that outputs projected coordinates to an operation that expects angular units
+(degrees). An example of such a unit mismatch is displayed below.
+
+::
+
+ +proj=pipeline
+ +step +proj=merc # Mercator outputs projected coordinates
+ +step +proj=robin # The Robinson projection expects angular input