pygmt.grdfilter: Migrate the 'toggle' parameter to the new alias system (#4188)

Author: seisman

pygmt/src/grdfilter.py

@@ -7,25 +7,20 @@
 
 import xarray as xr
 from pygmt._typing import PathLike
-from pygmt.alias import AliasSystem
+from pygmt.alias import Alias, AliasSystem
 from pygmt.clib import Session
 from pygmt.helpers import build_arg_list, fmt_docstring, kwargs_to_strings, use_alias
 
 
 @fmt_docstring
 @use_alias(
-    D="distance",
-    F="filter",
-    I="spacing",
-    N="nans",
-    T="toggle",
-    f="coltypes",
-    r="registration",
+    D="distance", F="filter", I="spacing", N="nans", f="coltypes", r="registration"
 )
 @kwargs_to_strings(I="sequence")
 def grdfilter(
     grid: PathLike | xr.DataArray,
     outgrid: PathLike | None = None,
+    toggle: bool = False,
     region: Sequence[float | str] | str | None = None,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
     | bool = False,
@@ -49,6 +44,7 @@ def grdfilter(
 
     {aliases}
        - R = region
+       - T = toggle
        - V = verbose
        - x = cores
 
@@ -101,9 +97,10 @@ def grdfilter(
         co-registered). **p** will force the filtered value to be NaN if any
         grid nodes with NaN-values are found inside the filter circle.
     {region}
-    toggle : bool
-        Toggle the node registration for the output grid to get the opposite of
+    toggle
+        Toggle the node registration for the output grid so as to become the opposite of
         the input grid [Default gives the same registration as the input grid].
+        Alternatively, use ``registration`` to set the registration explicitly.
     {verbose}
     {coltypes}
     {registration}
@@ -138,7 +135,9 @@ def grdfilter(
     >>> grid = pygmt.datasets.load_earth_relief()
     >>> smooth_field = pygmt.grdfilter(grid=grid, filter="g600", distance="4")
     """
-    aliasdict = AliasSystem().add_common(
+    aliasdict = AliasSystem(
+        T=Alias(toggle, name="toggle"),
+    ).add_common(
         R=region,
         V=verbose,
         x=cores,