Alias connection (F), intensity (I) and zvalue (Z) for plot

Author: weiji14

pygmt/base_plotting.py

@@ -611,7 +611,9 @@ def grdview(self, grid, **kwargs):
         C="cmap",
         D="offset",
         E="error_bars",
+        F="connection",
         G="color",
+        I="intensity",
         J="projection",
         L="close",
         N="no_clip",
@@ -622,6 +624,7 @@ def grdview(self, grid, **kwargs):
         W="pen",
         X="xshift",
         Y="yshift",
+        Z="zvalue",
         i="columns",
         l="label",
         p="perspective",
@@ -696,7 +699,43 @@ def plot(self, x=None, y=None, data=None, sizes=None, direction=None, **kwargs):
             ``[x|y|X|Y][+a][+cl|f][+n][+wcap][+ppen]``.
             Draw symmetrical error bars. Full documentation is at
             :gmt-docs:`plot.html#e`.
+        connection : str
+            ``[c|n|r][a|f|s|r|refpoint]``.
+            Alter the way points are connected (by specifying a *scheme*) and
+            data are grouped (by specifying a *method*). Append one of three
+            line connection schemes:
+
+            - **c**\ : Draw continuous line segments for each group [Default].
+            - **r**\ : Draw line segments from a reference point reset for each
+              group.
+            - **n**\ : Draw networks of line segments between all points in
+              each group.
+
+            Optionally, append the one of four segmentation methods to define
+            the group:
+
+            - **a**\ : Ignore all segment headers, i.e., let all points belong
+              to a single group, and set group reference point to the very
+              first point of the first file.
+            - **f**\ : Consider all data in each file to be a single separate
+              group and reset the group reference point to the first point of
+              each group.
+            - **s**\ : Segment headers are honored so each segment is a group;
+              the group reference point is reset to the first point of each
+              incoming segment [Default].
+            - **r**\ : Same as **s**, but the group reference point is reset
+              after each record to the previous point (this method is only
+              available with the ``connection='r'`` scheme).
+
+            Instead of the codes **a**\|\ **f**\|\ **s**\|\ **r** you may
+            append the coordinates of a *refpoint* which will serve as a fixed
+            external reference point for all groups.
         {G}
+        intensity : float or bool
+            Provide an *intens* value (nominally in the -1 to +1 range) to
+            modulate the fill color by simulating illumination [None]. If
+            using ``intensity=True``, we will instead read *intens* from the
+            first data column after the symbol parameters (if given).
         close : str
             ``[+b|d|D][+xl|r|x0][+yl|r|y0][+ppen]``.
             Force closed polygons. Full documentation is at
@@ -720,6 +759,15 @@ def plot(self, x=None, y=None, data=None, sizes=None, direction=None, **kwargs):
         {U}
         {V}
         {XY}
+        zvalue : str
+            ``value|file``.
+            Instead of specifying a symbol or polygon fill and outline color
+            via **color** and **pen**, give both a *value* via **zvalue** and a
+            color lookup table via **cmap**.  Alternatively, give the name of a
+            *file* with one z-value (read from the last column) for each
+            polygon in the input data. To apply it to the fill color, use
+            ``color='+z'``. To apply it to the pen color, append **+z** to
+            **pen**.
         label : str
             Add a legend entry for the symbol or line being plotted.