aboutsummaryrefslogtreecommitdiff
path: root/docs/source/apps
diff options
context:
space:
mode:
authorEven Rouault <even.rouault@spatialys.com>2020-11-30 16:39:18 +0100
committerGitHub <noreply@github.com>2020-11-30 16:39:18 +0100
commitdc7a0c3c6f6c91cb97a991bdb8e51b805230f901 (patch)
tree515ff8780b19821e66095a8c1173aabb0e8aefdd /docs/source/apps
parente9f7439946d9a6de799b0ba02af549875aae9979 (diff)
parentebe3425bf66287e004958eb53976d3837f88b9e1 (diff)
downloadPROJ-dc7a0c3c6f6c91cb97a991bdb8e51b805230f901.tar.gz
PROJ-dc7a0c3c6f6c91cb97a991bdb8e51b805230f901.zip
Merge pull request #2466 from rouault/fix_2423
cs2cs: add --area and --bbox options to restrict candidate coordinate operations (fixes #2423)
Diffstat (limited to 'docs/source/apps')
-rw-r--r--docs/source/apps/cs2cs.rst29
1 files changed, 27 insertions, 2 deletions
diff --git a/docs/source/apps/cs2cs.rst b/docs/source/apps/cs2cs.rst
index e214a5c0..7fe570d9 100644
--- a/docs/source/apps/cs2cs.rst
+++ b/docs/source/apps/cs2cs.rst
@@ -11,11 +11,15 @@ cs2cs
Synopsis
********
- **cs2cs** [**-eEfIlrstvwW** [args]] [*+opt[=arg]* ...] [+to *+opt[=arg]* ...] file ...
+ **cs2cs** [**-eEfIlrstvwW** [args]]
+ [[--area name_or_code] | [--bbox west_long,south_lat,east_long,north_lat]]
+ [*+opt[=arg]* ...] [+to *+opt[=arg]* ...] file ...
or
- **cs2cs** [**-eEfIlrstvwW** [args]] {source_crs} {target_crs} file ...
+ **cs2cs** [**-eEfIlrstvwW** [args]] [--area name_or_code]
+ [[--area name_or_code] | [--bbox west_long,south_lat,east_long,north_lat]]
+ {source_crs} {target_crs} file ...
where {source_crs} or {target_crs} is one of the possibilities accepted
by :c:func:`proj_create`, provided it expresses a CRS
@@ -144,6 +148,27 @@ The following control parameters can appear in any order:
Causes a listing of cartographic control parameters tested for and used by
the program to be printed prior to input data.
+.. option:: --area name_or_code
+
+ .. versionadded:: 8.0.0
+
+ Specify an area of interest to restrict the results when researching
+ coordinate operations between 2 CRS. The area of interest can be specified either
+ as a name (e.g "Denmark - onshore") or a AUTHORITY:CODE (EPSG:3237)
+
+ This option is mutually exclusive with :option:`--bbox`.
+
+.. option:: --bbox west_long,south_lat,east_long,north_lat
+
+ .. versionadded:: 8.0.0
+
+ Specify an area of interest to restrict the results when researching
+ coordinate operations between 2 CRS. The area of interest is specified as a
+ bounding box with geographic coordinates, expressed in degrees in a
+ unspecified geographic CRS.
+ `west_long` and `east_long` should be in the [-180,180] range, and
+ `south_lat` and `north_lat` in the [-90,90]. `west_long` is generally lower than
+ `east_long`, except in the case where the area of interest crosses the antimeridian.
.. only:: man