WIP + POC: Figure.clip_xxx methods

doc/_templates/autosummary/class.rst

@@ -8,8 +8,8 @@
 .. rubric:: Attributes
 
 {% for item in attributes %}
-.. autoattribute::
-    {{ objname }}.{{ item }}
+.. autoattribute:: {{ objname }}.{{ item }}
+    :no-index:
 {% endfor %}
 {% endif %}
 

doc/api/index.rst

@@ -70,6 +70,19 @@ Plotting raster data
     Figure.image
     Figure.tilemap
 
+Clipping
+~~~~~~~~
+
+.. autosummary::
+    :toctree: generated
+
+    Figure.clip_land
+    Figure.clip_water
+    Figure.clip_dcw
+    Figure.clip_solar
+    Figure.clip_polygon
+    Figure.clip_mask
+
 Configuring layout
 ~~~~~~~~~~~~~~~~~~
 

pygmt/figure.py

@@ -11,6 +11,12 @@
 from pygmt._typing import PathLike
 from pygmt.src.basemap import basemap as _basemap
 from pygmt.src.choropleth import choropleth as _choropleth
+from pygmt.src.clip import clip_dcw as _clip_dcw
+from pygmt.src.clip import clip_land as _clip_land
+from pygmt.src.clip import clip_mask as _clip_mask
+from pygmt.src.clip import clip_polygon as _clip_polygon
+from pygmt.src.clip import clip_solar as _clip_solar
+from pygmt.src.clip import clip_water as _clip_water
 from pygmt.src.coast import coast as _coast
 from pygmt.src.colorbar import colorbar as _colorbar
 from pygmt.src.contour import contour as _contour
@@ -446,6 +452,12 @@ def _repr_html_(self) -> str:
     # Attach plotting functions implemented in pygmt/src as Figure methods.
     basemap = _basemap
     choropleth = _choropleth
+    clip_dcw = _clip_dcw
+    clip_land = _clip_land
+    clip_mask = _clip_mask
+    clip_polygon = _clip_polygon
+    clip_solar = _clip_solar
+    clip_water = _clip_water
     coast = _coast
     colorbar = _colorbar
     contour = _contour