starplot 0.10.2__py2.py3-none-any.whl → 0.11.1__py2.py3-none-any.whl

starplot/styles/base.py

@@ -2,12 +2,14 @@ import json
 from enum import Enum
 from pathlib import Path
 from typing import Optional
+from functools import cache
 
 import yaml
 
 from pydantic import BaseModel
 from pydantic.color import Color
 from pydantic.functional_serializers import PlainSerializer
+from matplotlib import patheffects
 from typing_extensions import Annotated
 
 from starplot.data.dsos import DsoType
@@ -27,6 +29,8 @@ HERE = Path(__file__).resolve().parent
 
 
 class BaseStyle(BaseModel):
+    __hash__ = object.__hash__
+
     class Config:
         use_enum_values = True
         extra = "forbid"
@@ -77,6 +81,9 @@ class MarkerSymbolEnum(str, Enum):
     POINT = "point"
     """\u00B7"""
 
+    PLUS = "plus"
+    """+"""
+
     CIRCLE = "circle"
     """\u25CF"""
 
@@ -113,6 +120,9 @@ class MarkerSymbolEnum(str, Enum):
     COMET = "comet"
     """\u2604"""
 
+    STAR_4 = "star_4"
+    """\u2726"""
+
     STAR_8 = "star_8"
     """\u2734"""
 
@@ -122,6 +132,7 @@ class MarkerSymbolEnum(str, Enum):
             MarkerSymbolEnum.POINT: ".",
             MarkerSymbolEnum.CIRCLE: "o",
             MarkerSymbolEnum.SQUARE: "s",
+            MarkerSymbolEnum.PLUS: "P",
             MarkerSymbolEnum.SQUARE_STRIPES_DIAGONAL: "$\u25A8$",
             MarkerSymbolEnum.STAR: "*",
             MarkerSymbolEnum.SUN: "$\u263C$",
@@ -132,7 +143,7 @@ class MarkerSymbolEnum(str, Enum):
             MarkerSymbolEnum.CIRCLE_DOTTED_EDGE: "$\u25CC$",
             MarkerSymbolEnum.COMET: "$\u2604$",
             MarkerSymbolEnum.STAR_8: "$\u2734$",
-        }.get(self.value)
+        }[self.value]
 
 
 class LineStyleEnum(str, Enum):
@@ -164,6 +175,7 @@ class LegendLocationEnum(str, Enum):
 class AnchorPointEnum(str, Enum):
     """Options for the anchor point of labels"""
 
+    CENTER = "center"
     TOP_LEFT = "top left"
     TOP_RIGHT = "top right"
     TOP_CENTER = "top center"
@@ -192,6 +204,9 @@ class AnchorPointEnum(str, Enum):
         elif self.value == AnchorPointEnum.TOP_CENTER:
             style["va"] = "bottom"
             style["ha"] = "center"
+        elif self.value == AnchorPointEnum.CENTER:
+            style["va"] = "center"
+            style["ha"] = "center"
 
         return style
 
@@ -239,6 +254,7 @@ class MarkerStyle(BaseStyle):
     def symbol_matplot(self) -> str:
         return MarkerSymbolEnum(self.symbol).as_matplot()
 
+    @cache
     def matplot_kwargs(self, size_multiplier: float = 1.0) -> dict:
         return dict(
             color=self.color.as_hex() if self.color else "none",
@@ -294,15 +310,33 @@ class LineStyle(BaseStyle):
     zorder: int = -1
     """Zorder of the line"""
 
+    edge_width: int = 0
+    """Width of the line's edge. _If the width or color is falsey then the line will NOT be drawn with an edge._"""
+
+    edge_color: Optional[ColorStr] = None
+    """Edge color of the line. _If the width or color is falsey then the line will NOT be drawn with an edge._"""
+
+    @cache
     def matplot_kwargs(self, size_multiplier: float = 1.0) -> dict:
+        line_width = self.width * size_multiplier
+
         result = dict(
             color=self.color.as_hex(),
             linestyle=self.style,
-            linewidth=self.width * size_multiplier,
+            linewidth=line_width,
             # dash_capstyle=self.dash_capstyle,
             alpha=self.alpha,
             zorder=self.zorder,
         )
+
+        if self.edge_width and self.edge_color:
+            result["path_effects"] = [
+                patheffects.withStroke(
+                    linewidth=line_width + 2 * self.edge_width * size_multiplier,
+                    foreground=self.edge_color.as_hex(),
+                )
+            ]
+
         return result
 
 
@@ -516,7 +550,7 @@ class PlotStyle(BaseStyle):
 
     figure_background_color: ColorStr = ColorStr("#fff")
 
-    text_border_width: int = 2
+    text_border_width: int = 3
     text_offset_x: float = 0.005
     text_offset_y: float = 0.005
 
@@ -549,7 +583,7 @@ class PlotStyle(BaseStyle):
 
     # Stars
     star: ObjectStyle = ObjectStyle(
-        marker=MarkerStyle(fill=FillStyleEnum.FULL, zorder=1, size=20, edge_color=None),
+        marker=MarkerStyle(fill=FillStyleEnum.FULL, zorder=1, size=36, edge_color=None),
         label=LabelStyle(font_size=9, font_weight=FontWeightEnum.BOLD, zorder=400),
     )
     """Styling for stars *(see [`ObjectStyle`][starplot.styles.ObjectStyle])*"""
@@ -834,6 +868,39 @@ class PlotStyle(BaseStyle):
     )
     """Styling for the Celestial Equator"""
 
+    horizon: PathStyle = PathStyle(
+        line=LineStyle(
+            color="#fff",
+            width=64,
+            edge_width=4,
+            edge_color="#000",
+            style=LineStyleEnum.SOLID,
+            dash_capstyle=DashCapStyleEnum.BUTT,
+            alpha=1,
+            zorder=2000,
+        ),
+        label=LabelStyle(
+            anchor_point=AnchorPointEnum.CENTER,
+            font_color="#000",
+            font_size=23,
+            font_weight=FontWeightEnum.BOLD,
+            zorder=2000,
+        ),
+    )
+    """Styling for the horizon"""
+
+    zenith: ObjectStyle = ObjectStyle(
+        marker=MarkerStyle(
+            symbol=MarkerSymbolEnum.TRIANGLE,
+            size=24,
+            fill=FillStyleEnum.FULL,
+            color="#000",
+            alpha=0.8,
+        ),
+        label=LabelStyle(font_size=14, font_weight=FontWeightEnum.BOLD),
+    )
+    """Styling for the zenith marker"""
+
     def get_dso_style(self, dso_type: DsoType):
         """Returns the style for a DSO type"""
         styles_by_type = {

starplot/styles/ext/antique.yml

@@ -8,9 +8,24 @@
 
 background_color: hsl(48, 80%, 96%)
 figure_background_color: hsl(60, 9%, 29%)
+
 border_bg_color: hsl(60, 3%, 32%)
 border_font_color: hsl(60, 20%, 93%)
 border_line_color: hsl(60, 20%, 53%)
+
+horizon:
+  line:
+    color: hsl(60, 3%, 32%)
+    edge_color: hsl(60, 20%, 53%)
+  label:
+    font_color: hsl(60, 20%, 93%)
+
+zenith:
+  marker:
+    color: hsl(26, 93%, 82%)
+  label:
+    font_color: hsl(26, 93%, 82%)
+
 title:
   font_color: hsl(60, 20%, 93%)
 bayer_labels:
@@ -62,6 +77,7 @@ gridlines:
 star:
   marker:
     color: hsl(60, 12%, 32%)
+    edge_color: hsl(48, 80%, 96%)
   label:
     font_color: hsl(60, 3%, 42%)
 planets:

starplot/styles/ext/blue_dark.yml

@@ -1,8 +1,23 @@
 background_color: hsl(209, 50%, 24%)
 figure_background_color: hsl(209, 43%, 15%)
+
 border_bg_color: hsl(209, 50%, 20%)
 border_font_color: hsl(209, 56%, 86%)
 border_line_color: hsl(209, 38%, 50%)
+
+horizon:
+  line:
+    color: hsl(209, 50%, 20%)
+    edge_color: hsl(209, 38%, 50%)
+  label:
+    font_color: hsl(209, 56%, 86%)
+
+zenith:
+  marker:
+    color: hsl(209, 20%, 75%)
+  label:
+    font_color: hsl(209, 20%, 75%)
+
 title:
   font_color: hsl(209, 56%, 86%)
 bayer_labels:
@@ -119,7 +134,7 @@ star:
     font_weight: bold
   marker:
     color: hsl(209, 50%, 94%)
-    size: 25
+    edge_color: hsl(209, 50%, 24%)
 sun:
   label:
     font_color: hsl(209, 23%, 80%)

starplot/styles/ext/blue_light.yml

@@ -1,9 +1,27 @@
 background_color: '#fff'
+
 border_bg_color: '#b5cbe3'
 border_font_color: '#2f4358'
 border_line_color: '#2f4358'
+
+horizon:
+  line:
+    color: '#b5cbe3'
+    edge_color: '#2f4358'
+  label:
+    font_color: '#2f4358'
+
+zenith:
+  marker:
+    color: hsl(18, 68%, 75%)
+  label:
+    font_color: hsl(18, 68%, 75%)
+
 title:
   font_color: '#2f4358'
+star:
+  marker:
+    edge_color: '#fff'
 celestial_equator:
   label:
     font_color: '#2d5ec2'

starplot/styles/ext/blue_medium.yml

@@ -1,10 +1,15 @@
 background_color: '#f1f6ff'
 figure_background_color: '#fff'
+
 border_bg_color: '#7997b9'
 border_font_color: '#f1f6ff'
 border_line_color: '#2f4358'
+
 title:
   font_color: '#f1f6ff'
+star:
+  marker:
+    edge_color: '#f1f6ff'
 bayer_labels:
   font_alpha: 0.8
   font_color: '#000'
@@ -53,6 +58,19 @@ sun:
     color: '#ffd22e'
     edge_color: 'hsl(47, 100%, 29%)'
 
+horizon:
+  line:
+    color: '#7997b9'
+    edge_color: '#2f4358'
+  label:
+    font_color: '#f1f6ff'
+
+zenith:
+  marker:
+    color: '#b979b7'
+  label:
+    font_color: '#b979b7'
+
 # DSOs
 dso_double_star:
   marker:

starplot/styles/ext/cb_wong.yml

@@ -3,11 +3,30 @@
 # via https://davidmathlogic.com/colorblind
 
 background_color: '#fff'
+
 border_bg_color: '#fff'
 border_font_color: hsl(0, 0%, 0%)
 border_line_color: hsl(0, 0%, 0%)
+
+horizon:
+  line:
+    color: hsl(0, 0%, 96%)
+    edge_color: hsl(0, 0%, 0%)
+  label:
+    font_color: hsl(0, 0%, 0%)
+
+zenith:
+  marker:
+    alpha: 1.0
+    color: hsl(26, 100%, 42%)
+  label:
+    font_color: hsl(26, 100%, 42%)
+
 title:
   font_color: '#2f4358'
+star:
+  marker:
+    edge_color: '#fff'
 celestial_equator:
   label:
     font_color: hsl(202, 100%, 35%)
@@ -17,7 +36,7 @@ constellation:
   label:
     font_color: '#c5c5c5'
   line:
-    alpha: 0.35
+    alpha: 0.346
     color: hsl(202, 100%, 35%)
     width: 2
 dso_double_star:

starplot/styles/ext/color_print.yml

@@ -0,0 +1,108 @@
+background_color: '#fff'
+# figure_background_color: hsl(211, 26%, 24%)
+figure_background_color: '#fff'
+border_bg_color: '#fff'
+border_font_color: '#000'
+border_line_color: '#fff'
+title:
+  font_color: '#000'
+star:
+  marker:
+    edge_color: '#fff'
+bayer_labels:
+  font_alpha: 0.8
+  font_color: '#000'
+celestial_equator:
+  label:
+    font_color: '#2b89ed'
+  line:
+    color: '#2b89ed'
+    alpha: 0.6
+constellation:
+  label:
+    font_size: 4
+    font_weight: light
+    font_color: '#8c8c8c'
+    font_alpha: 0.1
+  line:
+    alpha: 0.2
+    color: '#2b89ed'
+    width: 2
+ecliptic:
+  label:
+    font_color: '#d11925'
+  line:
+    color: '#d11925'
+    alpha: 0.6
+planets:
+  marker:
+    alpha: 0.4
+    color: '#f89d00'
+    fill: full
+milky_way:
+  alpha: 0.1
+  color: '#2b89ed'
+  edge_width: 0
+gridlines:
+  label:
+    font_alpha: 1
+    font_color:  hsl(211, 80%, 97%)
+    font_size: 18
+    font_weight: light
+  line:
+    alpha: 0.4
+    color: '#888'
+    style: solid
+    width: 1
+sun:
+  marker:
+    color: '#ffd22e'
+    edge_color: 'hsl(47, 100%, 29%)'
+
+horizon:
+  line:
+    color: '#7997b9'
+    edge_color: '#2f4358'
+    edge_width: 8
+  label:
+    font_color: '#f1f6ff'
+
+zenith:
+  marker:
+    color: 'red'
+
+# DSOs
+dso_double_star:
+  marker:
+    alpha: 0.6
+    
+dso_galaxy:
+  marker:
+    alpha: 0.3
+    color: '#d11925'
+    edge_color: '#d11925'
+
+dso_nebula:
+  marker:
+    alpha: 0.5
+    # color: hsl(91, 62%, 82%)
+    color: '#2b89ed'
+    edge_color: hsl(211, 84%, 20%)
+dso_open_cluster:
+  marker:
+    alpha: 0.6
+    color: '#2b89ed'
+    symbol: circle_dotted_edge
+dso_association_stars:
+  marker:
+    alpha: 0.6
+    color: '#2b89ed'
+    symbol: circle_dotted_edge
+dso_globular_cluster:
+  marker:
+    alpha: 0.8
+    color: '#2b89ed'
+    edge_color: '#444'
+
+legend:
+  background_color: '#f1f6ff'

starplot/styles/ext/grayscale.yml

@@ -1,7 +1,9 @@
 background_color: '#fff'
+
 border_bg_color: '#fff'
 border_font_color: '#000'
 border_line_color: '#000'
+
 title:
   font_color: '#000'
 celestial_equator:
@@ -12,6 +14,9 @@ celestial_equator:
 constellation:
   line:
     color: '#c8c8c8'
+star:
+  marker:
+    edge_color: '#fff'
 dso_double_star:
   marker:
     color: '#000'
@@ -51,3 +56,16 @@ sun:
 
 legend:
   background_color: '#fff'
+
+horizon:
+  line:
+    color: 'white'
+    edge_color: 'black'
+  label:
+    font_color: 'black'
+
+zenith:
+  marker:
+    color: black
+  label:
+    font_color: black

starplot/styles/ext/grayscale_dark.yml

@@ -1,20 +1,36 @@
 background_color: hsl(136, 0%, 10%)
 figure_background_color: hsl(136, 0%, 100%)
+
 border_bg_color: hsl(136, 0%, 20%)
-border_font_color: hsl(136, 0%, 0%)
-border_line_color: hsl(136, 0%, 97%)
+border_font_color: hsl(136, 0%, 90%)
+border_line_color: hsl(136, 0%, 54%)
+
+horizon:
+  line:
+    color: hsl(136, 0%, 20%)
+    edge_color: hsl(136, 0%, 54%)
+  label:
+    font_color: hsl(136, 0%, 90%)
+
+zenith:
+  marker:
+    color: hsl(136, 0%, 90%)
+  label:
+    font_color: hsl(136, 0%, 90%)
+
 title:
   font_color: hsl(136, 0%, 0%)
 info_text:
   font_color: hsl(136, 0%, 0%)
 star:
   label:
-    font_color: hsl(136, 0%, 97%)
+    font_color: hsl(136, 0%, 90%)
   marker:
     color: hsl(136, 0%, 97%)
+    edge_color: hsl(136, 0%, 10%)
 sun:
   label:
-    font_color: hsl(136, 0%, 97%)
+    font_color: hsl(136, 0%, 90%)
   marker:
     color: hsl(136, 0%, 97%)
     edge_color: hsl(136, 0%, 97%)

starplot/styles/ext/nord.yml

@@ -1,10 +1,22 @@
 background_color: '#4c566a'
-bayer_labels:
-  font_alpha: 0.8
-  font_color: '#85c9de'
+
 border_bg_color: '#2e3440'
 border_font_color: '#a3be8c'
 border_line_color: '#a3be8c'
+
+horizon:
+  line:
+    color: '#2e3440'
+    edge_color: '#a3be8c'
+  label:
+    font_color: '#a3be8c'
+
+zenith:
+  marker:
+    color: '#D99CBA'
+  label:
+    font_color: '#D99CBA'
+
 title:
   font_color: '#a3be8c'
 celestial_equator:
@@ -94,6 +106,7 @@ star:
     font_weight: bold
   marker:
     color: '#88c0d0'
+    edge_color: '#4c566a'
 sun:
   label:
     font_color: '#88c0d0'
@@ -109,7 +122,11 @@ moon:
     font_weight: bold
   marker:
     color: '#88c0d0'
-    
+
+bayer_labels:
+  font_alpha: 0.8
+  font_color: '#85c9de'
+
 legend:
   background_color: '#515e76'
   background_alpha: 1.0

starplot/styles/ext/optic.yml

@@ -2,7 +2,7 @@ star:
   label:
     font_size: 15
   marker:
-    size: 16
+    size: 30
 bayer_labels:
   font_size: 15
 planets:

starplot/styles/extensions.py

@@ -25,3 +25,4 @@ BLUE_DARK = load("blue_dark.yml")
 ANTIQUE = load("antique.yml")
 NORD = load("nord.yml")
 CB_WONG = load("cb_wong.yml")
+COLOR_PRINT = load("color_print.yml")

{starplot-0.10.2.dist-info → starplot-0.11.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: starplot
-Version: 0.10.2
+Version: 0.11.1
 Summary: Star charts and maps
 Keywords: astronomy,stars,charts,maps,constellations
 Author-email: Steve Berardi <hello@steveberardi.com>
@@ -43,7 +43,7 @@ Project-URL: Source, https://github.com/steveberardi/starplot
 - 🔭 **Optic Plots** - simulates what you'll see through an optic (e.g. binoculars, telescope) from a time/location
 - 🪐 **Planets and Deep Sky Objects (DSOs)**
 - 🎨 **Custom Styles** - for all objects
-- 📥 **Export** - png, svg
+- 📥 **Export** - png, svg, jpeg
 - 🧭 **Label Collision Avoidance**
 
 ## Examples
@@ -97,7 +97,11 @@ For a demo of Starplot's zenith plots, check out:
 
 Chat with other starplotters on our Discord server:
 
-https://discord.gg/bwazdyD7
+https://discord.gg/WewJJjshFu
+
+## Contributing
+
+Contributing to Starplot is welcome and very much appreciated! Please see [here](CONTRIBUTING.md) for details.
 
 ## Core Dependencies