Skip to content

Document the -R+U option in the global -R #7606

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

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions doc/rst/source/explain_-R.rst_
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ The **-R** option

.. _-R:

**-R**\ *xmin*/*xmax*/*ymin*/*ymax*\ [**+r**][**+u**\ *unit*]
**-R**\ *xmin*/*xmax*/*ymin*/*ymax*\ [**+r**][**+u|U**\ *unit*]
Specify the region of interest. |Add_-R|

**Description**
Expand All @@ -17,12 +17,12 @@ The **-R** option defines the map region or data domain of interest. It may be s
geographic regions when using map projections where meridians and parallels are rectilinear, where *xmin*, *xmax*,
*ymin*, and *ymax* refer to the data limits.

#. **-R**\ *xmin*/*xmax*/*ymin*/*ymax*\ **+u**\ *unit*. Append **+u**\ *unit* to the option 1 to specify a region in
#. **-R**\ *xmin*/*xmax*/*ymin*/*ymax*\ **+u|U**\ *unit*. Append **+u**\ *unit* to the option 1 to specify a region in
projected units (e.g., UTM meters) where *xmin*/*xmax*/*ymin*/*ymax* are Cartesian projected coordinates compatible
with the chosen projection and *unit* is an allowable :ref:`distance unit <dist-units>` [e]. The coordinates are relative
to the standard longitude and latitude indicated in the projection (**-J**). For projected regions centered on
to the standard longitude and latitude indicated in the projection (**-J**). For projected regions centered on
(0,0) you may use the short-hand **-R**\ *halfwidth*\ [/*halfheight*]\ **+u**\ *unit*, where *halfheight* defaults
to *halfwidth* if not given. This short-hand requires the **+u** modifier.
to *halfwidth* if not given. This short-hand requires the **+u** modifier. For convenience, we also support the inverse translation, i.e., +Uunit. This modifier can be used to convert your grid coordinates from meters to the specified unit.

#. **-R**\ *xlleft*/*ylleft*/*xuright*/*yuright*\ **+r**. This form is useful for map projections that are oblique,
making meridians and parallels poor choices for map boundaries. Here, we instead specify the lower left corner and
Expand Down