Improve example for Polar projection (#2110)

Co-authored-by: Dongdong Tian <[email protected]>

Author: yvonnefroehlich

examples/projections/nongeo/polar.py

@@ -52,60 +52,57 @@
 
 fig = pygmt.Figure()
 
-pygmt.config(FONT_TITLE="14p,Helvetica,black", FORMAT_GEO_MAP="+D")
+pygmt.config(FONT_TITLE="14p,Courier,black", FORMAT_GEO_MAP="+D")
 
 # ============
-
+# top left
 fig.basemap(
     # set map limits to theta_min = 0, theta_max = 360, radius_min = 0,
     # radius_max = 1
     region=[0, 360, 0, 1],
     # set map width to 5 cm
     projection="P5c",
-    # set the frame and color
-    frame=["xa45f", "+gbisque"],
+    # set the frame, color, and title
+    # @^ allows for a line break within the title
+    frame=["xa45f", "+gbisque+tprojection='P5c' @^ region=[0, 360, 0, 1]"],
 )
 
-fig.text(position="TC", text="projection='P5c'", offset="0/2.0c", no_clip=True)
-fig.text(position="TC", text="region=[0, 360, 0, 1]", offset="0/1.5c", no_clip=True)
-
 fig.shift_origin(xshift="8c")
 
 # ============
+# top middle
 fig.basemap(
     # set map limits to theta_min = 0, theta_max = 360, radius_min = 0,
     # radius_max = 1
     region=[0, 360, 0, 1],
     # set map width to 5 cm and interpret input data as geographic azimuth
     # instead of standard angle
     projection="P5c+a",
-    # set the frame and color
-    frame=["xa45f", "+gbisque"],
+    # set the frame, color, and title
+    # @^ allows for a line break within the title
+    frame=["xa45f", "+gbisque+tprojection='P5c+a' @^ region=[0, 360, 0, 1]"],
 )
 
-fig.text(position="TC", text="projection='P5c+a'", offset="0/2.0c", no_clip=True)
-fig.text(position="TC", text="region=[0, 360, 0, 1]", offset="0/1.5c", no_clip=True)
-
 fig.shift_origin(xshift="8c")
 
 # ============
+# top right
 fig.basemap(
     # set map limits to theta_min = 0, theta_max = 90, radius_min = 0,
     # radius_max = 1
     region=[0, 90, 0, 1],
     # set map width to 5 cm and interpret input data as geographic azimuth
     # instead of standard angle
     projection="P5c+a",
-    # set the frame and color
-    frame=["xa45f", "ya0.2", "WNe+gbisque"],
+    # set the frame, color, and title
+    # @^ allows for a line break within the title
+    frame=["xa45f", "ya0.2", "WNe+gbisque+tprojection='P5c+a' @^ region=[0, 90, 0, 1]"],
 )
 
-fig.text(position="TC", text="projection='P5c+a'", offset="0/2.0c", no_clip=True)
-fig.text(position="TC", text="region=[0, 90, 0, 1]", offset="0/1.5c", no_clip=True)
-
 fig.shift_origin(xshift="-16c", yshift="-7c")
 
 # ============
+# bottom left
 fig.basemap(
     # set map limits to theta_min = 0, theta_max = 90, radius_min = 0,
     # radius_max = 1
@@ -114,16 +111,19 @@
     # instead of standard angle, rotate coordinate system counterclockwise by
     # 45 degrees
     projection="P5c+a+t45",
-    # set the frame and color
-    frame=["xa30f", "ya0.2", "WNe+gbisque"],
+    # set the frame, color, and title
+    # @^ allows for a line break within the title
+    frame=[
+        "xa30f",
+        "ya0.2",
+        "WNe+gbisque+tprojection='P5c+a+t45' @^ region=[0, 90, 0, 1]",
+    ],
 )
 
-fig.text(position="TC", text=r"projection='P5c+a\+t45'", offset="0/2.0c", no_clip=True)
-fig.text(position="TC", text="region=[0, 90, 0, 1]", offset="0/1.5c", no_clip=True)
-
 fig.shift_origin(xshift="8c", yshift="1.3c")
 
 # ============
+# bottom middle
 fig.basemap(
     # set map limits to theta_min = 0, theta_max = 90, radius_min = 3480,
     # radius_max = 6371 (Earth's radius)
@@ -132,18 +132,19 @@
     # instead of standard angle, rotate coordinate system counterclockwise by
     # 45 degrees
     projection="P5c+a+t45",
-    # set the frame and color
-    frame=["xa30f", "ya", "WNse+gbisque"],
-)
-
-fig.text(position="TC", text=r"projection='P5c+a\+t45'", offset="0/2.0c", no_clip=True)
-fig.text(
-    position="TC", text="region=[0, 90, 3480, 6371]", offset="0/1.5c", no_clip=True
+    # set the frame, color, and title
+    # @^ allows for a line break within the title
+    frame=[
+        "xa30f",
+        "ya",
+        "WNse+gbisque+tprojection='P5c+a+t45' @^ region=[0, 90, 3480, 6371]",
+    ],
 )
 
 fig.shift_origin(xshift="8c")
 
 # ============
+# bottom right
 fig.basemap(
     # set map limits to theta_min = 0, theta_max = 90, radius_min = 3480,
     # radius_max = 6371 (Earth's radius)
@@ -152,15 +153,13 @@
     # instead of standard angle, rotate coordinate system counterclockwise by
     # 45 degrees, r-axis is marked as depth
     projection="P5c+a+t45+z",
-    # set the frame and color
-    frame=["xa30f", "ya", "WNse+gbisque"],
-)
-
-fig.text(
-    position="TC", text=r"projection='P5c+a\+t45+z'", offset="0/2.0c", no_clip=True
-)
-fig.text(
-    position="TC", text="region=[0, 90, 3480, 6371]", offset="0/1.5c", no_clip=True
+    # set the frame, color, and title
+    # @^ allows for a line break within the title
+    frame=[
+        "xa30f",
+        "ya",
+        "WNse+gbisque+tprojection='P5c+a+t45+\\z' @^ region=[0, 90, 3480, 6371]",
+    ],
 )
 
 fig.show()