starplot 0.15.8__py2.py3-none-any.whl → 0.16.1__py2.py3-none-any.whl

starplot/styles/ext/blue_medium.yml

@@ -1,7 +1,7 @@
 # blue_medium
 
 background_color: hsl(218, 88%, 97%)
-figure_background_color: '#fff'
+figure_background_color: hsl(212, 27%, 48%)
 
 text_border_color: '#f1f6ff'
 
@@ -20,11 +20,11 @@ bayer_labels:
 
 # Constellations
 constellation_labels:
-  font_alpha: 0.75
-  font_color: hsl(212, 20%, 34%)
+  font_alpha: 1
+  font_color: hsl(212, 20%, 36%)
 constellation_lines:
-  alpha: 0.5
-  color: '#6ba832'
+  alpha: 0.45
+  color: hsl(91, 60%, 43%)
 
 celestial_equator:
   label:
@@ -65,7 +65,7 @@ sun:
 
 horizon:
   line:
-    color: hsl(212, 27%, 56%)
+    color: hsl(212, 27%, 48%)
     edge_color: '#2f4358'
   label:
     font_color: '#f1f6ff'
@@ -130,7 +130,6 @@ dso_unknown: &DSO
   label:
     font_color: hsl(91, 53%, 40%)
 dso_dark_nebula: *DSO
-dso_hii_ionized_region: *DSO
 dso_supernova_remnant: *DSO
 dso_nova_star: *DSO
 dso_nonexistant: *DSO
@@ -139,3 +138,4 @@ dso_duplicate: *DSO
 
 legend:
   background_color: '#f1f6ff'
+  border_color: '#c9daf8'

starplot/styles/ext/blue_night.yml

@@ -0,0 +1,178 @@
+background_color: hsl(210, 29%, 15%)
+figure_background_color: hsl(210, 29%, 8%)
+
+text_border_color: hsl(210, 29%, 15%)
+
+border_bg_color: hsl(210, 29%, 5%)
+border_font_color: hsl(209, 56%, 86%)
+border_line_color: hsl(209, 38%, 50%)
+
+title:
+  font_color: hsl(210, 29%, 94%)
+
+legend:
+  background_color: hsl(210, 29%, 20%)
+  background_alpha: 1.0
+  font_color: hsl(210, 29%, 94%)
+
+info_text:
+  font_color: hsl(210, 29%, 8%)
+
+gridlines:
+  label:
+    font_alpha: 1
+    font_color: hsl(209, 53%, 94%)
+  line:
+    alpha: 0.8
+    # color: hsl(209, 53%, 54%)
+    color: hsl(210, 19%, 45%)
+    style: solid
+    width: 1
+
+zenith:
+  marker:
+    color: hsl(209, 20%, 75%)
+  label:
+    font_color: hsl(209, 20%, 75%)
+
+horizon:
+  line:
+    color: hsl(210, 29%, 8%)
+    edge_color: hsl(209, 38%, 50%)
+  label:
+    font_color: hsl(210, 29%, 94%)
+
+celestial_equator:
+  label:
+    font_color: hsl(211deg 47% 81%)
+  line:
+    color: hsl(211deg 47% 61%)
+
+ecliptic:
+  label:
+    font_color: '#e33b3b'
+  line:
+    color: hsl(1, 80%, 40%)
+    alpha: 1
+
+# Stars
+star:
+  label:
+    font_color: hsl(210, 29%, 94%)
+    font_weight: bold
+  marker:
+    color: hsl(210, 29%, 98%)
+    edge_color: hsl(210, 29%, 15%)
+
+bayer_labels:
+  font_alpha: 0.9
+  font_color: hsl(210, 29%, 94%)
+  font_size: 24
+
+flamsteed_labels:
+  font_alpha: 0.9
+  font_color: hsl(210, 29%, 94%)
+
+
+# Constellations
+constellation_lines:
+  alpha: 0.64
+  color: hsl(91, 60%, 70%)
+constellation_labels:
+  font_alpha: 1
+  font_color: hsl(210, 10%, 56%)
+  border_color: hsl(210, 29%, 15%)
+constellation_borders:
+  width: 2
+  color: hsl(209, 50%, 74%)
+
+# Milky Way
+milky_way:
+  alpha: 0.4
+  fill_color: hsl(210, 29%, 25%)
+  edge_width: 0
+
+# DSOs
+dso_double_star:
+  label:
+    font_color: hsl(209, 23%, 72%)
+  marker:
+    alpha: 0.8
+    color: '#88c0d0'
+    edge_color: '#88c0d0'
+
+dso_galaxy:
+  marker:
+    alpha: 1
+    color: hsl(323, 34%, 54%)
+    edge_color: hsl(321, 97%, 83%)
+    edge_width: 2
+  label:
+    font_color: hsl(321, 95%, 80%)
+
+dso_nebula: &DSO-NEB
+  marker:
+    alpha: 1
+    color: hsl(160, 13%, 37%)
+    edge_color: hsl(119, 100%, 95%)
+  label:
+    font_color: hsl(119, 95%, 90%)
+dso_planetary_nebula: *DSO-NEB
+
+dso_open_cluster: &DSO-OC
+  marker:
+    alpha: 1
+    color: hsl(62, 48%, 33%)
+    edge_color: hsl(58, 98%, 74%)
+    edge_width: 1
+  label:
+    font_color: hsl(58, 98%, 58%)
+dso_association_stars: *DSO-OC
+
+dso_globular_cluster:
+  marker:
+    alpha: 1
+    color: hsl(62, 29%, 14%)
+    edge_color: hsl(58, 98%, 72%)
+  label:
+    font_color: hsl(58, 98%, 58%)
+
+dso_unknown: &DSO
+  label:
+    font_color: hsl(209, 23%, 72%)
+  marker:
+    alpha: 0.46
+    color: hsl(209, 50%, 78%)
+    edge_color: hsl(209, 50%, 20%)
+    zorder: -500
+dso_dark_nebula: *DSO
+dso_supernova_remnant: *DSO
+dso_nova_star: *DSO
+dso_nonexistant: *DSO
+dso_unknown: *DSO
+dso_duplicate: *DSO
+
+# Solar System
+sun:
+  label:
+    font_color: hsl(60, 92%, 71%)
+    font_size: 9
+    font_weight: bold
+  marker:
+    color: hsl(209, 50%, 90%)
+    edge_color: hsl(209, 50%, 94%)
+
+moon:
+  label:
+    font_color: '#f2f2f2'
+    font_alpha: 0.8
+  marker:
+    color: '#e9e9e9'
+
+planets:
+  label:
+    font_color: hsl(37, 80%, 76%)
+  marker:
+    alpha: 1
+    color: hsl(37, 80%, 56%)
+    fill: full

starplot/styles/ext/cb_wong.yml

@@ -98,7 +98,6 @@ dso_unknown: &DSO
     color: hsl(163, 99%, 31%)
     edge_color: hsl(163, 99%, 21%)
 dso_dark_nebula: *DSO
-dso_hii_ionized_region: *DSO
 dso_supernova_remnant: *DSO
 dso_nova_star: *DSO
 dso_nonexistant: *DSO

starplot/styles/ext/gradient_presets.yml

@@ -0,0 +1,158 @@
+bold_sunset:
+    - [0.0, '#FFAF36']
+    - [0.1, '#F56140']
+    - [0.25, '#932885']
+    - [0.4, '#591D76']
+    - [0.7, '#0B0C40']
+    - [1.0, '#000033']
+
+civil_twilight:
+    - [0.0, "#F6C9A1"]
+    - [0.1, "#DCD4BB"]
+    - [0.3, "#96C6D6"]
+    - [0.55, "#4199CF"]
+    - [1.0, "#3A73A1"]
+
+nautical_twilight:
+    - [0.0, '#F3C176']
+    - [0.1, '#9292C9']
+    - [0.25, '#4661D6']
+    - [0.4, '#5428B2']
+    - [0.7, '#2C105F']
+    - [1.0, '#14012C']
+
+astronomical_twilight:
+    - [0.0, "#00184C"]
+    - [0.1, "#001B42"]
+    - [0.4, "#000D37"]
+    - [0.7, "#00061D"]
+    - [1.0, '#000000']
+
+true_night:
+    - [0.0, '#00002B']
+    - [0.3, '#000022']
+    - [0.7, '#000018']
+    - [1.0, '#000000']
+
+pre_dawn:
+    - [0.0, '#FEDCAF']
+    - [0.05, "#BEB0D0"]
+    - [0.15, '#8274C9']
+    - [0.3, '#444294']
+    - [0.45, '#222164']
+    - [0.7, '#000033']
+    - [1.0, '#000000']
+
+bold_sunset_radial:
+    - [0.0, '#FFAF36']
+    - [0.03, '#F56140']
+    - [0.08, '#932885']
+    - [0.15, '#591D76']
+    - [0.30, '#0B0C40']
+    - [1.0, '#000033']
+
+civil_twilight_radial:
+    - [0.0, "#F6C9A1"]
+    - [0.05, "#DCD4BB"]
+    - [0.1, "#96C6D6"]
+    - [0.2, "#4199CF"]
+    - [0.6, "#3A73A1"]
+    - [1.0, "#266191"]
+
+nautical_twilight_radial:
+    - [0.0, '#F3C176']
+    - [0.05, '#9292C9']
+    - [0.15, '#5428B2']
+    - [0.27, '#2C105F']
+    - [0.40, '#1A0539']
+    - [1.0, '#14012C']
+
+astronomical_twilight_radial:
+    - [0.0, "#00184C"]
+    - [0.05, "#001B42"]
+    - [0.15, "#000D37"]
+    - [0.3, "#00061D"]
+    - [1.0, '#000000']
+
+true_night_radial:
+    - [0.0, '#00002B']
+    - [0.1, '#000022']
+    - [0.2, '#000018']
+    - [1.0, '#000000']
+
+pre_dawn_radial:
+    - [0.0, '#FEDCAF']
+    - [0.025, "#BEB0D0"]
+    - [0.05, '#8274C9']
+    - [0.1, '#444294']
+    - [0.2, '#222164']
+    - [0.4, '#000033']
+    - [1.0, '#000000']
+
+blue_mollweide:
+    - [0.0, "#00000F"]
+    - [0.15, "#000015"]
+    - [0.4, "#070D27"]
+    - [0.45, "#0C123B"]
+    - [0.5, "#180F55"]
+    - [0.55, "#0C123B"]
+    - [0.6, "#070D27"]
+    - [0.85, "#000015"]
+    - [1.0, "#00000F"]
+
+purple_mollweide:
+    - [0.0, "#00000F"]
+    - [0.15, "#000015"]
+    - [0.35, "#130013"]
+    - [0.4, "#200020"]
+    - [0.45, "#270020"]
+    - [0.5, "#410034"]
+    - [0.55, "#270020"]
+    - [0.6, "#200020"]
+    - [0.65, "#130013"]
+    - [0.85, "#000015"]
+    - [1.0, "#00000F"]
+
+milky_way_mollweide:
+    - [0.0, "#00000f"]
+    - [0.25, "#00001f"]
+    - [0.4, "#27112C"]
+    - [0.45, "#4E2238"]
+    - [0.5, "#793A4D"]
+    - [0.55, "#4E2238"]
+    - [0.6, "#27112C"]
+    - [0.75, "#00001f"]
+    - [1.0, "#00000f"]
+
+dust_lane_mollweide:
+    - [0.0, "#000010"]
+    - [0.25, "#000020"]
+    - [0.4, "#27181B"]
+    - [0.45, "#4E3016"]
+    - [0.5, "#6E3F0C"]
+    - [0.55, "#4E3016"]
+    - [0.6, "#27181B"]
+    - [0.75, "#000020"]
+    - [1.0, "#000010"]
+
+gas_cloud_mollweide:
+    - [0.0, "#000000"]
+    - [0.25, "#000B18"]
+    - [0.4, "#04132B"]
+    - [0.45, "#0C1B3B"]
+    - [0.5, "#0A243D"]
+    - [0.55, "#0C1B3B"]
+    - [0.6, "#04132B"]
+    - [0.75, "#000B18"]
+    - [1.0, "#000000"]
+
+naked_eye_mollweide:
+    - [0.0, "#000010"]
+    - [0.25, "#000020"]
+    - [0.4, "#1E1522"]
+    - [0.45, "#271A15"]
+    - [0.5, "#35251A"]
+    - [0.55, "#2E1F1A"]
+    - [0.6, "#1E1522"]
+    - [0.75, "#000020"]
+    - [1.0, "#000010"]

starplot/styles/ext/grayscale.yml

@@ -53,7 +53,6 @@ dso_unknown: &DSO
     color: '#000'
     alpha: 0.28
 dso_dark_nebula: *DSO
-dso_hii_ionized_region: *DSO
 dso_supernova_remnant: *DSO
 dso_nova_star: *DSO
 dso_nonexistant: *DSO

starplot/styles/ext/grayscale_dark.yml

@@ -104,7 +104,6 @@ dso_unknown: &DSO
     color: 'hsl(136, 0%, 97%)'
     alpha: 0.28
 dso_dark_nebula: *DSO
-dso_hii_ionized_region: *DSO
 dso_supernova_remnant: *DSO
 dso_nova_star: *DSO
 dso_nonexistant: *DSO

starplot/styles/ext/nord.yml

@@ -94,7 +94,6 @@ dso_unknown: &DSO
   label:
     font_color: '#52896e'
 dso_dark_nebula: *DSO
-dso_hii_ionized_region: *DSO
 dso_supernova_remnant: *DSO
 dso_nova_star: *DSO
 dso_nonexistant: *DSO

starplot/styles/extensions.py

@@ -23,7 +23,97 @@ BLUE_LIGHT = load("blue_light.yml")
 BLUE_MEDIUM = load("blue_medium.yml")
 BLUE_DARK = load("blue_dark.yml")
 BLUE_GOLD = load("blue_gold.yml")
+BLUE_NIGHT = load("blue_night.yml")
 ANTIQUE = load("antique.yml")
 NORD = load("nord.yml")
 CB_WONG = load("cb_wong.yml")
 COLOR_PRINT = load("color_print.yml")
+
+# Horizon Background Gradient Presets
+GRADIENTS = load("gradient_presets.yml")
+
+GRADIENT_BOLD_SUNSET = {
+    "background_color": [
+        [0.0, "#FFAF36"],
+        [0.1, "#F56140"],
+        [0.25, "#932885"],
+        [0.4, "#591D76"],
+        [0.7, "#0B0C40"],
+        [1.0, "#000033"],
+    ]
+}
+
+
+GRADIENT_CIVIL_TWILIGHT = {
+    "background_color": [
+        [0.0, "#F6C9A1"],
+        [0.1, "#DCD4BB"],
+        [0.3, "#96C6D6"],
+        [0.55, "#4199CF"],
+        [1.0, "#3A73A1"],
+    ]
+}
+
+GRADIENT_NAUTICAL_TWILIGHT = {
+    "background_color": [
+        [0.0, "#F3C176"],
+        [0.1, "#9292C9"],
+        [0.25, "#4661D6"],
+        [0.4, "#5428B2"],
+        [0.7, "#2C105F"],
+        [1.0, "#14012C"],
+    ]
+}
+
+GRADIENT_ASTRONOMICAL_TWILIGHT = {
+    "background_color": [
+        [0.0, "#00184C"],
+        [0.1, "#001B42"],
+        [0.4, "#000D37"],
+        [0.7, "#00061D"],
+        [1.0, "#000000"],
+    ]
+}
+
+GRADIENT_TRUE_NIGHT = {
+    "background_color": [
+        [0.0, "#00002B"],
+        [0.1, "#00002B"],
+        [0.3, "#000022"],
+        [0.7, "#000018"],
+        [1.0, "#000000"],
+    ]
+}
+
+GRADIENT_PRE_DAWN = {
+    "background_color": [
+        [0.0, "#FEDCAF"],
+        [0.05, "#BEB0D0"],
+        [0.15, "#8274C9"],
+        [0.3, "#444294"],
+        [0.45, "#222164"],
+        [0.7, "#000033"],
+        [1.0, "#000000"],
+    ]
+}
+
+GRADIENT_OPTIC_FALLOFF = {
+    "background_color": [
+        [0.0, "hsl(0, 0%, 0%)"],
+        [0.1, "hsl(0, 0%, 8%)"],
+        [0.3, "hsl(0, 0%, 12%)"],
+        [0.6, "hsl(0, 0%, 14%)"],
+        [1.0, "hsl(0, 0%, 20%)"],
+    ]
+}
+
+# needs work
+GRADIENT_OPTIC_FALL_IN = {
+    "background_color": [
+        [0.0, "hsl(0, 0%, 50%)"],
+        [0.3, "hsl(0, 0%, 25%)"],
+        [0.45, "hsl(0, 0%, 20%)"],
+        [0.7, "hsl(0, 0%, 10%)"],
+        [1.0, "hsl(0, 0%, 0%)"],
+    ]
+}

starplot/zenith.py

@@ -0,0 +1,174 @@
+import numpy as np
+from matplotlib import path, patches
+
+from starplot.coordinates import CoordinateSystem
+from starplot.map import MapPlot
+from starplot.observer import Observer
+from starplot.projections import Stereographic
+from starplot.styles import LabelStyle, PlotStyle, PathStyle, GradientDirection
+from starplot.styles.helpers import use_style
+
+
+DEFAULT_MAP_STYLE = PlotStyle()  # .extend(extensions.MAP)
+
+
+class ZenithPlot(MapPlot):
+    """Creates a new zenith plot.
+
+    Args:
+        observer: Observer instance which specifies a time and place
+        ephemeris: Ephemeris to use for calculating planet positions (see [Skyfield's documentation](https://rhodesmill.org/skyfield/planets.html) for details)
+        style: Styling for the plot (colors, sizes, fonts, etc)
+        resolution: Size (in pixels) of largest dimension of the map
+        hide_colliding_labels: If True, then labels will not be plotted if they collide with another existing label
+        scale: Scaling factor that will be applied to all sizes in styles (e.g. font size, marker size, line widths, etc). For example, if you want to make everything 2x bigger, then set the scale to 2. At `scale=1` and `resolution=4096` (the default), all sizes are optimized visually for a map that covers 1-3 constellations. So, if you're creating a plot of a _larger_ extent, then it'd probably be good to decrease the scale (i.e. make everything smaller) -- and _increase_ the scale if you're plotting a very small area.
+        autoscale: If True, then the scale will be set automatically based on resolution.
+        suppress_warnings: If True (the default), then all warnings will be suppressed
+
+    Returns:
+        ZenithPlot: A new instance of a ZenithPlot
+
+    """
+
+    _coordinate_system = CoordinateSystem.RA_DEC
+    _gradient_direction = GradientDirection.RADIAL
+
+    def __init__(
+        self,
+        observer: Observer = Observer(),
+        ephemeris: str = "de421_2001.bsp",
+        style: PlotStyle = DEFAULT_MAP_STYLE,
+        resolution: int = 4096,
+        hide_colliding_labels: bool = True,
+        scale: float = 1.0,
+        autoscale: bool = False,
+        suppress_warnings: bool = True,
+        *args,
+        **kwargs,
+    ) -> "ZenithPlot":
+        projection = Stereographic(
+            center_ra=observer.lst,
+            center_dec=observer.lat,
+        )
+
+        super().__init__(
+            projection,
+            0,
+            360,
+            -90,
+            90,
+            observer,
+            ephemeris,
+            style,
+            resolution,
+            hide_colliding_labels,
+            clip_path=None,
+            scale=scale,
+            autoscale=autoscale,
+            suppress_warnings=suppress_warnings,
+            *args,
+            **kwargs,
+        )
+
+    @use_style(PathStyle, "horizon")
+    def horizon(
+        self,
+        style: PathStyle = None,
+        labels: list = ["N", "E", "S", "W"],
+    ):
+        """
+        Draws a [great circle](https://en.wikipedia.org/wiki/Great_circle) representing the horizon for the given `lat`, `lon` at time `dt` (so you must define these when creating the plot to use this function)
+
+        Args:
+            style: Style of the horizon path. If None, then the plot's style definition will be used.
+            labels: List of labels for cardinal directions. **NOTE: labels should be in the order: North, East, South, West.**
+        """
+        if self.observer is None:
+            raise ValueError("observer is required for plotting the horizon")
+
+        """
+        For zenith projections, we plot the horizon as a patch to make a more perfect circle
+        """
+        style_kwargs = style.line.matplot_kwargs(self.scale)
+        style_kwargs["clip_on"] = False
+        style_kwargs["edgecolor"] = style_kwargs.pop("color")
+        patch = patches.Circle(
+            (0.50, 0.50),
+            radius=0.454,
+            facecolor=None,
+            fill=False,
+            transform=self.ax.transAxes,
+            **style_kwargs,
+        )
+        self.ax.add_patch(patch)
+        self._background_clip_path = patch
+        self._update_clip_path_polygon(
+            buffer=style.line.width / 2 + 2 * style.line.edge_width + 20
+        )
+
+        if not labels:
+            return
+
+        label_ax_coords = [
+            (0.5, 0.95),  # north
+            (0.045, 0.5),  # east
+            (0.5, 0.045),  # south
+            (0.954, 0.5),  # west
+        ]
+        for label, coords in zip(labels, label_ax_coords):
+            self.ax.annotate(
+                label,
+                coords,
+                xycoords=self.ax.transAxes,
+                clip_on=False,
+                **style.label.matplot_kwargs(self.scale),
+            )
+
+    def _set_extent(self):
+        theta = np.linspace(0, 2 * np.pi, 100)
+        center, radius = [0.5, 0.5], 0.45
+        verts = np.vstack([np.sin(theta), np.cos(theta)]).T
+        circle = path.Path(verts * radius + center)
+        extent = self.ax.get_extent(crs=self._proj)
+        self.ax.set_extent((p / 3.548 for p in extent), crs=self._proj)
+        self.ax.set_boundary(circle, transform=self.ax.transAxes)
+
+    @use_style(LabelStyle, "info_text")
+    def info(self, style: LabelStyle = None):
+        """
+        Plots info text in the lower left corner, including date/time and lat/lon.
+
+        Args:
+            style: Styling of the info text. If None, then the plot's style definition will be used.
+        """
+        dt_str = self.dt.strftime("%m/%d/%Y @ %H:%M:%S") + " " + self.dt.tzname()
+        info = f"{str(self.observer.lat)}, {str(self.observer.lon)}\n{dt_str}"
+        self.ax.text(
+            0.05,
+            0.05,
+            info,
+            transform=self.ax.transAxes,
+            **style.matplot_kwargs(self.scale),
+        )
+
+    def _plot_background_clip_path(self):
+        if self.style.has_gradient_background():
+            background_color = "#ffffff00"
+            self._plot_gradient_background(self.style.background_color)
+        else:
+            background_color = self.style.background_color.as_hex()
+
+        self._background_clip_path = patches.Circle(
+            (0.50, 0.50),
+            radius=0.45,
+            fill=True,
+            facecolor=background_color,
+            # edgecolor=self.style.border_line_color.as_hex(),
+            linewidth=0,
+            zorder=-2_000,
+            transform=self.ax.transAxes,
+        )
+        self.ax.set_facecolor(background_color)
+
+        self.ax.add_patch(self._background_clip_path)
+        self._update_clip_path_polygon()