Rename decode_kind to raster_kind

Xref 6a4e1a4 in #3919

Author: weiji14

pygmt/datasets/samples.py

@@ -203,7 +203,7 @@ def _load_earth_relief_holes() -> xr.DataArray:
         is in meters.
     """
     fname = which("@earth_relief_20m_holes.grd", download="c")
-    return xr.load_dataarray(fname, engine="gmt", decode_kind="grid")
+    return xr.load_dataarray(fname, engine="gmt", raster_kind="grid")
 
 
 class GMTSampleData(NamedTuple):

pygmt/helpers/testing.py

@@ -154,7 +154,7 @@ def load_static_earth_relief():
         A grid of Earth relief for internal tests.
     """
     fname = which("@static_earth_relief.nc", download="c")
-    return xr.load_dataarray(fname, engine="gmt", decode_kind="grid")
+    return xr.load_dataarray(fname, engine="gmt", raster_kind="grid")
 
 
 def skip_if_no(package):

pygmt/io.py

@@ -24,8 +24,8 @@ def load_dataarray(filename_or_obj, **kwargs):
 
     .. deprecated:: v0.16.0
        The 'pygmt.io.load_dataarray' function will be removed in v0.20.0. Please use
-       `xarray.load_dataarray(..., engine='gmt', decode_kind='grid')` instead if you
-       were reading grids using the engine='netcdf'; otherwise use `decode_kind='image'`
+       `xarray.load_dataarray(..., engine='gmt', raster_kind='grid')` instead if you
+       were reading grids using the engine='netcdf'; otherwise use `raster_kind='image'`
        if you were reading multi-band images using engine='rasterio'.
 
     Parameters
@@ -48,9 +48,9 @@ def load_dataarray(filename_or_obj, **kwargs):
     """
     msg = (
         "The 'pygmt.io.load_dataarray' function will be removed in v0.20.0. Please use "
-        "`xarray.load_dataarray(..., engine='gmt', decode_kind='grid')` instead if you "
+        "`xarray.load_dataarray(..., engine='gmt', raster_kind='grid')` instead if you "
         "were reading grids using the engine='netcdf'; otherwise use "
-        "`decode_kind='image'` if you were reading multi-band images using "
+        "`raster_kind='image'` if you were reading multi-band images using "
         "engine='rasterio'."
     )
     warnings.warn(message=msg, category=FutureWarning, stacklevel=1)