thin: add examples

doc/whats-new.rst

@@ -141,6 +141,9 @@ Documentation
   examples. (:issue:`6333`, :pull:`6334`)
   By `Stan West <https://github.com/stanwest>`_.
 
+- Added examples to :py:meth:`Dataset.thin` and :py:meth:`DataArray.thin`
+  By `Emma Marshall <https://github.com/e-marshall>`_.
+
 Performance
 ~~~~~~~~~~~
 

xarray/core/dataarray.py

@@ -1474,6 +1474,41 @@ def thin(
         """Return a new DataArray whose data is given by each `n` value
         along the specified dimension(s).
 
+        Examples
+        ----------
+        >>> x_arr = np.arange(0, 26)
+        >>> x_arr
+        array([ 0,  1,  2,  3,  4,  5,  6,  7,  8,  9, 10, 11, 12, 13, 14, 15, 16,
+        17, 18, 19, 20, 21, 22, 23, 24, 25])
+        >>> x = xr.DataArray(
+        ...     np.reshape(x_arr, (2, 13)),
+        ...     dims=("x", "y"),
+        ...     coords={"x": [0, 1], "y": np.arange(0, 13)},
+        ... )
+        >>> x_arr
+        array([ 0,  1,  2,  3,  4,  5,  6,  7,  8,  9, 10, 11, 12, 13, 14, 15, 16,
+            17, 18, 19, 20, 21, 22, 23, 24, 25])
+        >>> x
+        <xarray.DataArray (x: 2, y: 13)>
+        array([[ 0,  1,  2,  3,  4,  5,  6,  7,  8,  9, 10, 11, 12],
+            [13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25]])
+        Coordinates:
+        * x        (x) int64 0 1
+        * y        (y) int64 0 1 2 3 4 5 6 7 8 9 10 11 12
+        >>>
+        >>> x.thin(3)
+        <xarray.DataArray (x: 1, y: 5)>
+        array([[ 0,  3,  6,  9, 12]])
+        Coordinates:
+        * x        (x) int64 0
+        * y        (y) int64 0 3 6 9 12
+        >>> x.thin({"x": 2, "y": 5})
+        <xarray.DataArray (x: 1, y: 3)>
+        array([[ 0,  5, 10]])
+        Coordinates:
+        * x        (x) int64 0
+        * y        (y) int64 0 5 10
+
         See Also
         --------
         Dataset.thin

xarray/core/dataset.py

@@ -2615,6 +2615,42 @@ def thin(
             The keyword arguments form of ``indexers``.
             One of indexers or indexers_kwargs must be provided.
 
+        Examples
+        ----------
+        >>> x_arr = np.arange(0, 26)
+        >>> x_arr
+        array([ 0,  1,  2,  3,  4,  5,  6,  7,  8,  9, 10, 11, 12, 13, 14, 15, 16,
+        17, 18, 19, 20, 21, 22, 23, 24, 25])
+        >>> x = xr.DataArray(
+        ...     np.reshape(x_arr, (2, 13)),
+        ...     dims=("x", "y"),
+        ...     coords={"x": [0, 1], "y": np.arange(0, 13)},
+        ... )
+        >>> x_ds = xr.Dataset({"foo": x})
+        >>> x_ds
+        <xarray.Dataset>
+        Dimensions:  (x: 2, y: 13)
+        Coordinates:
+        * x        (x) int64 0 1
+        * y        (y) int64 0 1 2 3 4 5 6 7 8 9 10 11 12
+        Data variables:
+            foo      (x, y) int64 0 1 2 3 4 5 6 7 8 9 ... 16 17 18 19 20 21 22 23 24 25
+
+        >>> x_ds.thin(3)
+        <xarray.Dataset>
+        Dimensions:  (x: 1, y: 5)
+        Coordinates:
+        * x        (x) int64 0
+        * y        (y) int64 0 3 6 9 12
+        Data variables:
+            foo      (x, y) int64 0 3 6 9 12
+        >>> x.thin({"x": 2, "y": 5})
+        <xarray.DataArray (x: 1, y: 3)>
+        array([[ 0,  5, 10]])
+        Coordinates:
+        * x        (x) int64 0
+        * y        (y) int64 0 5 10
+
         See Also
         --------
         Dataset.head