AliasSystem: Migrate the 'spacing' parameter to the new alias system

Author: seisman

pygmt/src/binstats.py

@@ -9,24 +9,23 @@
 from pygmt._typing import PathLike, TableLike
 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
+from pygmt.helpers import build_arg_list, fmt_docstring, use_alias
 
 
 @fmt_docstring
 @use_alias(
     E="empty",
-    I="spacing",
     N="normalize",
     S="search_radius",
     W="weight",
     a="aspatial",
     b="binary",
     h="header",
 )
-@kwargs_to_strings(I="sequence")
 def binstats(
     data: PathLike | TableLike,
     outgrid: PathLike | None = None,
+    spacing: Sequence[float | str] | None = None,
     statistic: Literal[
         "mean",
         "mad",
@@ -68,6 +67,7 @@ def binstats(
 
     {aliases}
        - C = statistic
+       - I = spacing
        - R = region
        - V = verbose
        - i = incols
@@ -157,6 +157,7 @@ def binstats(
                 "sum": "z",
             },
         ),
+        I=Alias(spacing, name="spacing", sep="/", size=2),
     ).add_common(
         R=region,
         V=verbose,

pygmt/src/blockm.py

@@ -8,12 +8,11 @@
 import numpy as np
 import pandas as pd
 from pygmt._typing import PathLike, TableLike
-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,
     validate_output_table_type,
 )
@@ -73,7 +72,6 @@ def _blockm(
 
 @fmt_docstring
 @use_alias(
-    I="spacing",
     S="summary",
     a="aspatial",
     b="binary",
@@ -84,14 +82,14 @@ def _blockm(
     o="outcols",
     w="wrap",
 )
-@kwargs_to_strings(I="sequence", o="sequence_comma")
 def blockmean(
     data: PathLike | TableLike | None = None,
     x=None,
     y=None,
     z=None,
     output_type: Literal["pandas", "numpy", "file"] = "pandas",
     outfile: PathLike | None = None,
+    spacing: Sequence[float | str] | None = None,
     region: Sequence[float | str] | str | None = None,
     registration: Literal["gridline", "pixel"] | bool = False,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
@@ -114,6 +112,7 @@ def blockmean(
     Full GMT docs at :gmt-docs:`blockmean.html`.
 
     {aliases}
+       - I = spacing
        - R = region
        - V = verbose
        - i = incols
@@ -169,7 +168,9 @@ def blockmean(
     >>> # Calculate block mean values within 5 by 5 arc-minute bins
     >>> data_bmean = pygmt.blockmean(data=data, region=[245, 255, 20, 30], spacing="5m")
     """
-    aliasdict = AliasSystem().add_common(
+    aliasdict = AliasSystem(
+        I=Alias(spacing, name="spacing", sep="/", size=2),
+    ).add_common(
         R=region,
         V=verbose,
         i=incols,
@@ -191,7 +192,6 @@ def blockmean(
 
 @fmt_docstring
 @use_alias(
-    I="spacing",
     a="aspatial",
     b="binary",
     d="nodata",
@@ -201,14 +201,14 @@ def blockmean(
     o="outcols",
     w="wrap",
 )
-@kwargs_to_strings(I="sequence", o="sequence_comma")
 def blockmedian(
     data: PathLike | TableLike | None = None,
     x=None,
     y=None,
     z=None,
     output_type: Literal["pandas", "numpy", "file"] = "pandas",
     outfile: PathLike | None = None,
+    spacing: Sequence[float | str] | None = None,
     region: Sequence[float | str] | str | None = None,
     registration: Literal["gridline", "pixel"] | bool = False,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
@@ -231,6 +231,7 @@ def blockmedian(
     Full GMT docs at :gmt-docs:`blockmedian.html`.
 
     {aliases}
+       - I = spacing
        - R = region
        - V = verbose
        - i = incols
@@ -280,7 +281,9 @@ def blockmedian(
     ...     data=data, region=[245, 255, 20, 30], spacing="5m"
     ... )
     """
-    aliasdict = AliasSystem().add_common(
+    aliasdict = AliasSystem(
+        I=Alias(spacing, name="spacing", sep="/", size=2),
+    ).add_common(
         R=region,
         V=verbose,
         i=incols,
@@ -302,7 +305,6 @@ def blockmedian(
 
 @fmt_docstring
 @use_alias(
-    I="spacing",
     a="aspatial",
     b="binary",
     d="nodata",
@@ -312,14 +314,14 @@ def blockmedian(
     o="outcols",
     w="wrap",
 )
-@kwargs_to_strings(I="sequence", o="sequence_comma")
 def blockmode(
     data: PathLike | TableLike | None = None,
     x=None,
     y=None,
     z=None,
     output_type: Literal["pandas", "numpy", "file"] = "pandas",
     outfile: PathLike | None = None,
+    spacing: Sequence[float | str] | None = None,
     region: Sequence[float | str] | str | None = None,
     registration: Literal["gridline", "pixel"] | bool = False,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
@@ -342,6 +344,7 @@ def blockmode(
     Full GMT docs at :gmt-docs:`blockmode.html`.
 
     {aliases}
+       - I = spacing
        - R = region
        - V = verbose
        - i = incols
@@ -389,7 +392,9 @@ def blockmode(
     >>> # Calculate block mode values within 5 by 5 arc-minute bins
     >>> data_bmode = pygmt.blockmode(data=data, region=[245, 255, 20, 30], spacing="5m")
     """
-    aliasdict = AliasSystem().add_common(
+    aliasdict = AliasSystem(
+        I=Alias(spacing, name="spacing", sep="/", size=2),
+    ).add_common(
         R=region,
         V=verbose,
         i=incols,

pygmt/src/dimfilter.py

@@ -7,20 +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.exceptions import GMTInvalidInput
-from pygmt.helpers import build_arg_list, fmt_docstring, kwargs_to_strings, use_alias
+from pygmt.helpers import build_arg_list, fmt_docstring, use_alias
 
 __doctest_skip__ = ["dimfilter"]
 
 
 @fmt_docstring
-@use_alias(D="distance", F="filter", I="spacing", N="sectors")
-@kwargs_to_strings(I="sequence")
+@use_alias(D="distance", F="filter", N="sectors")
 def dimfilter(
     grid: PathLike | xr.DataArray,
     outgrid: PathLike | None = None,
+    spacing: Sequence[float | str] | None = None,
     region: Sequence[float | str] | str | None = None,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
     | bool = False,
@@ -48,6 +48,7 @@ def dimfilter(
     Full GMT docs at :gmt-docs:`dimfilter.html`.
 
     {aliases}
+       - I = spacing
        - R = region
        - V = verbose
 
@@ -148,7 +149,9 @@ def dimfilter(
         )
         raise GMTInvalidInput(msg)
 
-    aliasdict = AliasSystem().add_common(
+    aliasdict = AliasSystem(
+        I=Alias(spacing, name="spacing", sep="/", size=2),
+    ).add_common(
         R=region,
         V=verbose,
     )

pygmt/src/grdfilter.py

@@ -9,16 +9,16 @@
 from pygmt._typing import PathLike
 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
+from pygmt.helpers import build_arg_list, fmt_docstring, use_alias
 
 
 @fmt_docstring
-@use_alias(D="distance", F="filter", I="spacing", N="nans", f="coltypes")
-@kwargs_to_strings(I="sequence")
+@use_alias(D="distance", F="filter", N="nans", f="coltypes")
 def grdfilter(
     grid: PathLike | xr.DataArray,
     outgrid: PathLike | None = None,
     toggle: bool = False,
+    spacing: Sequence[float | str] | None = None,
     region: Sequence[float | str] | str | None = None,
     registration: Literal["gridline", "pixel"] | bool = False,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
@@ -42,6 +42,7 @@ def grdfilter(
     Full GMT docs at :gmt-docs:`grdfilter.html`.
 
     {aliases}
+       - I = spacing
        - R = region
        - T = toggle
        - V = verbose
@@ -136,6 +137,7 @@ def grdfilter(
     >>> smooth_field = pygmt.grdfilter(grid=grid, filter="g600", distance="4")
     """
     aliasdict = AliasSystem(
+        I=Alias(spacing, name="spacing", sep="/", size=2),
         T=Alias(toggle, name="toggle"),
     ).add_common(
         R=region,

pygmt/src/grdlandmask.py

@@ -10,16 +10,16 @@
 from pygmt.alias import Alias, AliasSystem
 from pygmt.clib import Session
 from pygmt.exceptions import GMTInvalidInput
-from pygmt.helpers import build_arg_list, fmt_docstring, kwargs_to_strings, use_alias
+from pygmt.helpers import build_arg_list, fmt_docstring, use_alias
 
 __doctest_skip__ = ["grdlandmask"]
 
 
 @fmt_docstring
-@use_alias(A="area_thresh", I="spacing")
-@kwargs_to_strings(I="sequence")
+@use_alias(A="area_thresh")
 def grdlandmask(
     outgrid: PathLike | None = None,
+    spacing: Sequence[float | str] | None = None,
     maskvalues: Sequence[float] | None = None,
     bordervalues: bool | float | Sequence[float] | None = None,
     resolution: Literal[
@@ -46,6 +46,7 @@ def grdlandmask(
     {aliases}
        - D = resolution
        - E = bordervalues
+       - I = spacing
        - N = maskvalues
        - R = region
        - V = verbose
@@ -127,6 +128,7 @@ def grdlandmask(
                 "crude": "c",
             },
         ),
+        I=Alias(spacing, name="spacing", sep="/", size=2),
         N=Alias(maskvalues, name="maskvalues", sep="/", size=(2, 5)),
         E=Alias(bordervalues, name="bordervalues", sep="/", size=4),
     ).add_common(

pygmt/src/grdsample.py

@@ -14,7 +14,6 @@
     build_arg_list,
     deprecate_parameter,
     fmt_docstring,
-    kwargs_to_strings,
     use_alias,
 )
 
@@ -24,12 +23,12 @@
 # TODO(PyGMT>=0.21.0): Remove the deprecated "translate" parameter.
 @fmt_docstring
 @deprecate_parameter("translate", "toggle", "v0.18.0", remove_version="v0.21.0")
-@use_alias(I="spacing", f="coltypes", n="interpolation")
-@kwargs_to_strings(I="sequence")
+@use_alias(f="coltypes", n="interpolation")
 def grdsample(
     grid: PathLike | xr.DataArray,
     outgrid: PathLike | None = None,
     toggle: bool = False,
+    spacing: Sequence[float | str] | None = None,
     region: Sequence[float | str] | str | None = None,
     registration: Literal["gridline", "pixel"] | bool = False,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
@@ -56,6 +55,7 @@ def grdsample(
     Full GMT docs at :gmt-docs:`grdsample.html`.
 
     {aliases}
+       - I = spacing
        - R = region
        - V = verbose
        - r = registration
@@ -105,6 +105,7 @@ def grdsample(
         raise GMTInvalidInput(msg)
 
     aliasdict = AliasSystem(
+        I=Alias(spacing, name=spacing),
         T=Alias(toggle, name="toggle"),
     ).add_common(
         R=region,

pygmt/src/info.py

@@ -7,24 +7,21 @@
 
 import numpy as np
 from pygmt._typing import PathLike, TableLike
-from pygmt.alias import AliasSystem
+from pygmt.alias import Alias, AliasSystem
 from pygmt.clib import Session
 from pygmt.helpers import (
     GMTTempFile,
     build_arg_list,
     fmt_docstring,
-    kwargs_to_strings,
     use_alias,
 )
 
 
 @fmt_docstring
-@use_alias(
-    C="per_column", I="spacing", T="nearest_multiple", a="aspatial", f="coltypes"
-)
-@kwargs_to_strings(I="sequence")
+@use_alias(C="per_column", T="nearest_multiple", a="aspatial", f="coltypes")
 def info(
     data: PathLike | TableLike,
+    spacing: Sequence[float | str] | None = None,
     registration: Literal["gridline", "pixel"] | bool = False,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
     | bool = False,
@@ -50,6 +47,7 @@ def info(
     Full GMT docs at :gmt-docs:`gmtinfo.html`.
 
     {aliases}
+       - I = spacing
        - V = verbose
        - i = incols
        - r = registration
@@ -88,7 +86,9 @@ def info(
         - :class:`numpy.ndarray` if either of the above parameters are used.
         - str if none of the above parameters are used.
     """
-    aliasdict = AliasSystem().add_common(
+    aliasdict = AliasSystem(
+        I=Alias(spacing, name="spacing", sep="/", size=2),
+    ).add_common(
         V=verbose,
         i=incols,
         r=registration,