Alias resolution (D), gridmask (G) and mask (N) for gmtselect

Author: weiji14

pygmt/src/select.py

@@ -15,11 +15,11 @@
 @fmt_docstring
 @use_alias(
     A="area_thresh",
-    # D="resolution",
-    # G="gridmask",
+    D="resolution",
+    G="gridmask",
     I="reverse",
     J="projection",
-    # N="mask",
+    N="mask",
     R="region",
     V="verbose",
     Z="z_subregion",
@@ -35,7 +35,7 @@
     s="skiprows",
     w="wrap",
 )
-@kwargs_to_strings(R="sequence", i="sequence_comma", o="sequence_comma")
+@kwargs_to_strings(M="sequence", R="sequence", i="sequence_comma", o="sequence_comma")
 def select(data=None, outfile=None, **kwargs):
     r"""
     Select data table subsets based on multiple spatial criteria.
@@ -68,6 +68,19 @@ def select(data=None, outfile=None, **kwargs):
     outfile : str
         The file name for the output ASCII file.
     {A}
+    resolution : str
+        *resolution*\ [**+f**].
+        Ignored unless **mask** is set. Selects the resolution of the coastline
+        data set to use ((**f**)ull, (**h**)igh, (**i**)ntermediate, (**l**)ow,
+        or (**c**)rude). The resolution drops off by ~80% between data sets.
+        [Default is **l**]. Append (**+f**) to automatically select a lower
+        resolution should the one requested not be available [Default is abort
+        if not found]. Note that because the coastlines differ in details it is
+        not guaranteed that a point will remain inside [or outside] when a
+        different resolution is selected.
+    gridmask : str
+        Pass all locations that are inside the valid data area of the grid
+        *gridmask*. Nodes that are outside are either NaN or zero.
     reverse : str
         [**cflrsz**].
         Reverses the sense of the test for each of the criteria specified:
@@ -83,6 +96,16 @@ def select(data=None, outfile=None, **kwargs):
         - **z** select records NOT within the range specified by
           **z_subregion**.
     {J}
+    mask : str or list
+        Pass all records whose location is inside specified geographical
+        features. Specify if records should be skipped (s) or kept (k) using
+        1 of 2 formats:
+
+        - *wet/dry*.
+        - *ocean/land/lake/island/pond*.
+
+        [Default is s/k/s/k/s (i.e., s/k), which passes all points on dry
+        land].
     {R}
     {V}
     z_subregion : str