Migrate Figure.coast tests to dvc

doc/api/index.rst

@@ -38,6 +38,7 @@ Plotting data and laying out the map:
     Figure.plot3d
     Figure.set_panel
     Figure.shift_origin
+    Figure.solar
     Figure.subplot
     Figure.text
 

examples/gallery/embellishments/solar.py

@@ -0,0 +1,46 @@
+"""
+Day-night terminator line and twilights
+---------------------------------------
+
+Use :meth:`pygmt.Figure.solar` to plot the day-night terminator line, 
+and civil, nautical, astronomical twilights.
+"""
+import datetime
+
+import pygmt
+
+fig = pygmt.Figure()
+# Create a figure showing the global region on a Mollweide projection
+# Land color is set to dark green and water color is set to light blue
+fig.coast(region="d", projection="W0/15c", land="darkgreen", water="lightblue")
+# Set a time for the day-night terminator and twilights, 1700 UTC on January 1, 2000
+terminator_datetime = datetime.datetime(
+    year=2000, month=1, day=1, hour=17, minute=0, second=0
+)
+# Set the pen line to be 1p thick
+# Set the fill for the night area to be navy blue at different transparency levels
+fig.solar(
+    terminator="day_night",
+    terminator_datetime=terminator_datetime,
+    fill="navyblue@95",
+    pen="0.5p",
+)
+fig.solar(
+    terminator="civil",
+    terminator_datetime=terminator_datetime,
+    fill="navyblue@85",
+    pen="0.5p",
+)
+fig.solar(
+    terminator="nautical",
+    terminator_datetime=terminator_datetime,
+    fill="navyblue@80",
+    pen="0.5p",
+)
+fig.solar(
+    terminator="astronomical",
+    terminator_datetime=terminator_datetime,
+    fill="navyblue@80",
+    pen="0.5p",
+)
+fig.show()

pygmt/figure.py

@@ -391,6 +391,7 @@ def _repr_html_(self):
         plot,
         plot3d,
         set_panel,
+        solar,
         subplot,
         text,
     )

pygmt/src/__init__.py

@@ -25,6 +25,7 @@
 from pygmt.src.meca import meca
 from pygmt.src.plot import plot
 from pygmt.src.plot3d import plot3d
+from pygmt.src.solar import solar
 from pygmt.src.subplot import set_panel, subplot
 from pygmt.src.surface import surface
 from pygmt.src.text import text_ as text  # "text" is an argument within "text_"

pygmt/src/solar.py

@@ -0,0 +1,99 @@
+"""
+solar - Plot day-night terminators.
+"""
+
+import datetime
+
+import pandas as pd
+from pygmt.clib import Session
+from pygmt.exceptions import GMTInvalidInput
+from pygmt.helpers import build_arg_string, fmt_docstring, kwargs_to_strings, use_alias
+
+
+@fmt_docstring
+@use_alias(
+    B="frame",
+    G="fill",
+    J="projection",
+    R="region",
+    U="timestamp",
+    V="verbose",
+    W="pen",
+    X="xshift",
+    Y="yshift",
+    c="panel",
+    p="perspective",
+    t="transparency",
+)
+@kwargs_to_strings(R="sequence", c="sequence_comma", p="sequence")
+def solar(self, terminator="d", terminator_datetime=None, **kwargs):
+    r"""
+    Plot day-light terminators.
+
+    This function plots the day-night terminator. Additionally, it can
+    plot the terminators for civil twilight, nautical twilight, and
+    astronomical twilight.
+
+    Full parameter list at :gmt-docs:`solar.html`
+
+    {aliases}
+
+    Parameters
+    ----------
+    terminator : str
+        Set the type of terminator displayed. Valid arguments are
+        **day_night**, **civil**, **nautical**, and **astronomical**, which
+        can be set with either the full name or the first letter of the name.
+        [Default is **day_night**]
+    terminator_datetime : str or datetime object
+        Set the UTC date and time of the displayed terminator. It can be
+        passed as a string or a datetime object.
+        [Default is the current UTC date and time]
+    {R}
+    {J}
+    {B}
+    fill : str
+        Color or pattern for filling of terminators.
+    pen : str
+        Set pen attributes for lines. The default pen
+        is ``default,black,solid``.
+    {U}
+    {V}
+    {XY}
+    {c}
+    {p}
+    {t}
+    """
+    # TODO: Incorporate "-T+zTZ"
+
+    kwargs = self._preprocess(**kwargs)  # pylint: disable=protected-access
+    if "T" in kwargs:
+        raise GMTInvalidInput(
+            "Use 'terminator' and 'terminator_datetime' instead of 'T'."
+        )
+    if terminator not in [
+        "day_night",
+        "nautical",
+        "civil",
+        "astronomical",
+        "astro",
+        "d",
+        "n",
+        "c",
+        "a",
+    ]:
+        raise GMTInvalidInput(
+            f"Unrecognized solar terminator type '{terminator}'. Valid values "
+            "are 'day_night', 'civil', 'nautical', and 'astronomical'."
+        )
+    kwargs["T"] = terminator[0]
+    if terminator_datetime:
+        try:
+            datetime_string = pd.to_datetime(terminator_datetime).strftime(
+                "%Y-%m-%dT%H:%M:%S.%f"
+            )
+        except ValueError as verr:
+            raise GMTInvalidInput("Unrecognized datetime format.") from verr
+        kwargs["T"] += f"+d{datetime_string}"
+    with Session() as lib:
+        lib.call_module("solar", build_arg_string(kwargs))

pygmt/tests/baseline/test_coast.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: a054a1df3a6eb6f6799ba0fc104ade45
+  size: 135451
+  path: test_coast.png

pygmt/tests/baseline/test_coast_aliases.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: d53aa16264ebd5ae546c95b88855b16a
+  size: 519870
+  path: test_coast_aliases.png

pygmt/tests/baseline/test_coast_dcw_continent.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: 479f5ea4fb662289c4bf0e9fc1d4ae4b
+  size: 91352
+  path: test_coast_dcw_continent.png

pygmt/tests/baseline/test_coast_dcw_list.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: 30c3f4c90ba740b7d9edae97d9d3b853
+  size: 93411
+  path: test_coast_dcw_list.png

pygmt/tests/baseline/test_coast_dcw_multiple.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: c68c4ecaffdda779a6b20aba786dd919
+  size: 94025
+  path: test_coast_dcw_multiple.png

pygmt/tests/baseline/test_coast_dcw_single.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: 40fcf70e1f73ba2be60cbf9e3f15794d
+  size: 83794
+  path: test_coast_dcw_single.png

pygmt/tests/baseline/test_coast_dcw_state.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: faddbe172a81a10563eebf75744d7339
+  size: 110297
+  path: test_coast_dcw_state.png

pygmt/tests/baseline/test_coast_iceland.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: c4efb846d4f0a26c7c3b4900ae0043bf
+  size: 23420
+  path: test_coast_iceland.png

pygmt/tests/baseline/test_coast_world_mercator.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: 12884b768aa463d575019347dedfa6b0
+  size: 322546
+  path: test_coast_world_mercator.png

pygmt/tests/baseline/test_solar_default_terminator.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: 0a7f4959b500b6fa3a560a6368db0f90
+  size: 25982
+  path: test_solar_default_terminator.png

pygmt/tests/baseline/test_solar_set_terminator_datetime_object.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: 0a7f4959b500b6fa3a560a6368db0f90
+  size: 25982
+  path: test_solar_set_terminator_datetime_object.png

pygmt/tests/baseline/test_solar_set_terminator_datetime_string.png.dvc

@@ -0,0 +1,4 @@
+outs:
+- md5: 9437b5fd846526c7cac12ab327a4d78f
+  size: 26501
+  path: test_solar_set_terminator_datetime_string.png