Rename id to pattern

Author: seisman

pygmt/params/pattern.py

@@ -33,8 +33,8 @@ class Pattern(BaseParam):
 
     Parameters
     ----------
-    id
-        The pattern ID. It can be specified in two forms:
+    pattern
+        The pattern to use. It can be specified in two forms:
 
         - An integer in the range of 1-90, corresponding to one of 90 predefined 64x64
           bit-patterns
@@ -69,7 +69,7 @@ class Pattern(BaseParam):
     >>> fig.show()
     """
 
-    id: int | PathLike
+    pattern: int | PathLike
     dpi: int | None = None
     bgcolor: str | None = None
     fgcolor: str | None = None
@@ -79,13 +79,13 @@ def _validate(self):
         """
         Validate the parameters.
         """
-        # Integer pattern id must be in the range 1-90.
-        if isinstance(self.id, int) and not (1 <= self.id <= 90):
+        # Integer pattern number must be in the range 1-90.
+        if isinstance(self.pattern, int) and not (1 <= self.pattern <= 90):
             raise GMTValueError(
-                self.id,
-                description="pattern id",
+                self.pattern,
+                description="pattern number",
                 reason=(
-                    "Pattern id must be an integer in the range 1-90 "
+                    "Parameter 'pattern' must be an integer in the range 1-90 "
                     "or the name of a 1-, 8-, or 24-bit image raster file."
                 ),
             )
@@ -104,7 +104,7 @@ def _aliases(self):
         Aliases for the Pattern class.
         """
         return [
-            Alias(self.id, name="id", prefix="P" if self.reversed else "p"),
+            Alias(self.pattern, name="pattern", prefix="P" if self.reversed else "p"),
             Alias(self.bgcolor, name="bgcolor", prefix="+b"),
             Alias(self.fgcolor, name="fgcolor", prefix="+f"),
             Alias(self.dpi, name="dpi", prefix="+r"),

pygmt/tests/test_params_pattern.py

@@ -12,7 +12,7 @@ def test_pattern():
     Test the Pattern class.
     """
     assert str(Pattern(1)) == "p1"
-    assert str(Pattern(id=1)) == "p1"
+    assert str(Pattern(pattern=1)) == "p1"
 
     assert str(Pattern("pattern.png")) == "ppattern.png"
 
@@ -33,15 +33,14 @@ def test_pattern():
     assert str(pattern) == "ppattern.png+bred+fblue+r300"
 
 
-def test_pattern_invalid_id():
+def test_pattern_invalid_pattern():
     """
-    Test that an invalid pattern id raises a GMTValueError.
+    Test that an invalid pattern number raises a GMTValueError.
     """
-    with pytest.raises(GMTValueError):
-        _ = str(Pattern(91))
     with pytest.raises(GMTValueError):
         _ = str(Pattern(0))
-
+    with pytest.raises(GMTValueError):
+        _ = str(Pattern(91))
 
 def test_pattern_invalid_colors():
     """