Figure.set_panel: Migrate the 'panel' parameter to the new alias system (#4175)

Author: seisman

pygmt/src/subplot.py

@@ -203,10 +203,9 @@ def subplot(
 @fmt_docstring
 @contextlib.contextmanager
 @use_alias(A="fixedlabel", C="clearance")
-@kwargs_to_strings(panel="sequence_comma")
 def set_panel(
     self,
-    panel=None,
+    panel: int | Sequence[int] | None = None,
     verbose: Literal["quiet", "error", "warning", "timing", "info", "compat", "debug"]
     | bool = False,
     **kwargs,
@@ -227,17 +226,16 @@ def set_panel(
 
     Parameters
     ----------
-    panel : str or list
-        *row,col*\|\ *index*.
-        Sets the current subplot until further notice. **Note**: First *row*
-        or *col* is 0, not 1. If not given we go to the next subplot by order
-        specified via ``autolabel`` in :meth:`pygmt.Figure.subplot`. As an
-        alternative, you may bypass using :meth:`pygmt.Figure.set_panel` and
-        instead supply the common option **panel**\ =[*row,col*] to the first
-        plot command you issue in that subplot. GMT maintains information about
-        the current figure and subplot. Also, you may give the one-dimensional
-        *index* instead which starts at 0 and follows the row or column order
-        set via ``autolabel`` in :meth:`pygmt.Figure.subplot`.
+    panel
+        *index* or (*row*, *col*).
+        Sets the current subplot until further notice. **Note**: First *row* or *col* is
+        0, not 1. If not given we go to the next subplot by order specified via
+        ``autolabel`` in :meth:`pygmt.Figure.subplot`. As an alternative, you may bypass
+        using :meth:`pygmt.Figure.set_panel` and instead supply the common option
+        **panel**=(*row*, *col*) to the first plot command you issue in that subplot.
+        GMT maintains information about the current figure and subplot. Also, you may
+        give the one-dimensional *index* instead which starts at 0 and follows the row
+        or column order set via ``autolabel`` in :meth:`pygmt.Figure.subplot`.
 
     fixedlabel : str
         Overrides the automatic labeling with the given string. No modifiers
@@ -268,6 +266,11 @@ def set_panel(
 
     with Session() as lib:
         lib.call_module(
-            module="subplot", args=["set", str(panel), *build_arg_list(aliasdict)]
+            module="subplot",
+            args=[
+                "set",
+                Alias(panel, name="panel", sep=",", size=2)._value,
+                *build_arg_list(aliasdict),
+            ],
         )
         yield