Add inline example for blockmode (#1731)

Co-authored-by: Meghan Jones <[email protected]>
Co-authored-by: Dongdong Tian <[email protected]>

Author: 3 people

pygmt/src/blockm.py

@@ -303,6 +303,16 @@ def blockmode(data=None, x=None, y=None, z=None, outfile=None, **kwargs):
           is not set.
         - None if ``outfile`` is set (filtered output will be stored in file
           set by ``outfile``).
+
+    Example
+    -------
+    >>> import pygmt  # doctest: +SKIP
+    >>> # Load a table of ship observations of bathymetry off Baja California
+    >>> data = pygmt.datasets.load_sample_data(name="bathymetry")
+    >>> # Calculate block mode values within 5 by 5 minute bins
+    >>> data_bmode = pygmt.blockmode(
+    ...     data=data, region=[245, 255, 20, 30], spacing="5m"
+    ... )  # doctest: +SKIP
     """
     return _blockm(
         block_method="blockmode", data=data, x=x, y=y, z=z, outfile=outfile, **kwargs