starplot 0.12.1__tar.gz → 0.12.3__tar.gz

{starplot-0.12.1 → starplot-0.12.3}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: starplot
-Version: 0.12.1
-Summary: Star charts and maps
+Version: 0.12.3
+Summary: Star charts and maps of the sky
 Keywords: astronomy,stars,charts,maps,constellations
 Author-email: Steve Berardi <hello@steveberardi.com>
 Description-Content-Type: text/markdown

{starplot-0.12.1 → starplot-0.12.3}/docs/changelog.md

@@ -9,6 +9,8 @@
 - Adds colors for some DSO labels that were missing them in some style extensions
 - Removed the kwarg `types` from `dsos`, so ALL DSO types are plotted by default
 - [**v0.12.1**] Fixes issue with plotting the Milky Way when it consists of multiple polygons
+- [**v0.12.2**] Allows tuples for line styles on polygons and adds geometry kwarg to polygon function
+- [**v0.12.3**] Fixes bug with constellation names
 
 ## v0.11.x
 [Documentation](https://archives.starplot.dev/0.11.4/)

{starplot-0.12.1 → starplot-0.12.3}/docs/examples.md

@@ -4,14 +4,14 @@
 <ul>
 
     <li>
-        <a href="/examples/star-chart-basic">
+        <a href="/examples/star-chart-basic/">
             <img src="/images/examples/star_chart_basic-sm.png" alt="Basic Star Chart" class="off-glb"/>
 
             <p class="example-card-title">Basic Star Chart</p>
         </a>
     </li>
     <li>
-        <a href="/examples/star-chart-detail">
+        <a href="/examples/star-chart-detail/">
             <img src="/images/examples/star_chart_detail-sm.png" alt="Detailed Star Chart" class="off-glb"/>
 
             <p class="example-card-title">Detailed Star Chart</p>
@@ -19,7 +19,7 @@
     </li>
 
     <li>
-        <a href="/examples/map-orion">
+        <a href="/examples/map-orion/">
             <img src="/images/examples/map_orion-sm.png" alt="Map of Orion" class="off-glb"/>
 
             <p class="example-card-title">Map of Orion</p>
@@ -27,7 +27,7 @@
     </li>
 
     <li>
-        <a href="/examples/map-big">
+        <a href="/examples/map-big/">
             <img src="/images/examples/map_big-sm.png" alt="Big Map" class="off-glb"/>
 
             <p class="example-card-title">Big Map</p>
@@ -35,7 +35,7 @@
     </li>
 
     <li>
-        <a href="/examples/optic-m45">
+        <a href="/examples/optic-m45/">
             <img src="/images/examples/optic_m45-sm.png" alt="Optic Plot of the Pleiades" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Optic Plot of the Pleiades</p>
@@ -43,7 +43,7 @@
     </li>
 
     <li>
-        <a href="/examples/optic-orion">
+        <a href="/examples/optic-orion/">
             <img src="/images/examples/optic_orion_nebula-sm.png" alt="Optic Plot of the Orion Nebula" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Optic Plot of the Orion Nebula</p>
@@ -51,7 +51,7 @@
     </li>
 
     <li>
-        <a href="/examples/map-milky-way-stars">
+        <a href="/examples/map-milky-way-stars/">
             <img src="/images/examples/map_milky_way_stars-sm.png" alt="Stars of the Milky Way class="off-glb"/>
 
             <p class="example-card-title">Milky Way Stars</p>
@@ -59,7 +59,7 @@
     </li>
 
     <li>
-        <a href="/examples/map-big-dipper">
+        <a href="/examples/map-big-dipper/">
             <img src="/images/examples/map_big_dipper-sm.png" alt="Map of the Big Dipper" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Map of the Big Dipper</p>
@@ -67,7 +67,7 @@
     </li>
 
     <li>
-        <a href="/examples/map-comet-neowise">
+        <a href="/examples/map-comet-neowise/">
             <img src="/images/examples/map_comet_neowise-sm.png" alt="Map of Comet NEOWISE in 2020" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Comet NEOWISE</p>
@@ -75,7 +75,7 @@
     </li>
 
     <li>
-        <a href="/examples/map-sagittarius">
+        <a href="/examples/map-sagittarius/">
             <img src="/images/examples/map_sagittarius-sm.png" alt="Map of Sagittarius" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Map of Sagittarius</p>
@@ -83,7 +83,7 @@
     </li>
 
     <li>
-        <a href="/examples/map-orthographic">
+        <a href="/examples/map-orthographic/">
             <img src="/images/examples/map_orthographic-sm.png" alt="Orthographic Map" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Orthographic Map</p>
@@ -91,7 +91,7 @@
     </li>
 
     <li>
-        <a href="/examples/optic-solar-eclipse">
+        <a href="/examples/optic-solar-eclipse/">
             <img src="/images/examples/optic_solar_eclipse-sm.png" alt="Total Solar Eclipse 2024" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Total Solar Eclipse 2024</p>
@@ -99,7 +99,7 @@
     </li>
 
     <li>
-        <a href="/examples/optic-moon-saturn">
+        <a href="/examples/optic-moon-saturn/">
             <img src="/images/examples/optic_moon_saturn-sm.png" alt="Moon and Saturn Conjunction" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Moon and Saturn Conjunction</p>
@@ -107,7 +107,7 @@
     </li>
 
     <li>
-        <a href="/examples/map-canis-major">
+        <a href="/examples/map-canis-major/">
             <img src="/images/examples/map_canis_major-sm.png" alt="Map of the Constellation Canis Major" class="off-glb" loading="lazy"/>
 
             <p class="example-card-title">Map of Canis Major</p>

{starplot-0.12.1 → starplot-0.12.3}/docs/index.md

@@ -33,18 +33,18 @@ Join other starplotters on [Discord :fontawesome-brands-discord:{ .fg-primary }]
 
 <figure markdown>
   <img src="images/examples/star_chart_basic.png" height="900" width="900">
-  <figcaption>Zenith plot of the stars from a specific time/location (<a href="/examples/star-chart-basic">source code</a>)</figcaption>
+  <figcaption>Zenith plot of the stars from a specific time/location (<a href="/examples/star-chart-basic/">source code</a>)</figcaption>
 </figure>
 
 <figure markdown>
   <img src="images/examples/map_orion.png" width="900">
-  <figcaption>Map around the constellation Orion, with an ellipse around Orion's Belt (<a href="/examples/map-orion">source code</a>)</figcaption>
+  <figcaption>Map around the constellation Orion, with an ellipse around Orion's Belt (<a href="/examples/map-orion/">source code</a>)</figcaption>
 </figure>
 
 
 <figure markdown>
   <img src="images/examples/optic_m45.png" width="900">
-  <figcaption>Optic plot that shows what The Pleiades looked like through a refractor telescope on December 16, 2023 at 9pm PT from Palomar Mountain in California (<a href="/examples/optic-m45">source code</a>)</figcaption>
+  <figcaption>Optic plot that shows what The Pleiades looked like through a refractor telescope on December 16, 2023 at 9pm PT from Palomar Mountain in California (<a href="/examples/optic-m45/">source code</a>)</figcaption>
 </figure>
 
 

{starplot-0.12.1 → starplot-0.12.3}/docs/tutorial/09.md

@@ -5,7 +5,9 @@ title: 9 - Where to Go From Here
 ---
 ![Starplot](/images/favicon.svg){ align=right width="180" .off-glb }
 
-**Congratulations on finishing the tutorial!** You're now a certified Level-1 Starplotter 🤩
+**Congratulations on finishing the tutorial!** 
+
+You're now a certified Level-1 Starplotter 🤩
 
 The purpose of the tutorial was just to give you an intro to some of Starplot's features, so there's more to explore by checking out the rest of the documentation. Here are some good places to check out next:
 

{starplot-0.12.1 → starplot-0.12.3}/hash_checks/hashlock.yml

@@ -11,15 +11,15 @@ map_gridlines:
   filename: /starplot/hash_checks/data/map-gridlines.png
   phash: f82acf9c3c616392
 map_label_callables:
-  dhash: 80948c8c9c8c88a080988c8c9c8c88a0809c8d0d9d9c98a0
+  dhash: 80988c0c9c8c88a080988c0c9c8c88a0809a9d1d0d9d9aa0
   filename: /starplot/hash_checks/data/map-m45-label-callables.png
-  phash: b26ccd99316664cd
+  phash: b238cdc92ce63699
 map_milky_way_multi_polygon:
   dhash: 351b89e4243a2604711b88e434322604751b88e424362624
   filename: /starplot/hash_checks/data/map-milky-way-multi-polygon.png
   phash: bc8bf89e90ce5a44
 map_mollweide:
-  dhash: 0f2933632b3317070f2933632b3317070f295b6323130707
+  dhash: 0b2933632b3317070b2933632b3317070f295b6323130707
   filename: /starplot/hash_checks/data/map-mollweide.png
   phash: fa9af698c0259566
 map_moon_phase_waxing_crescent:
@@ -43,9 +43,9 @@ map_plot_limit_by_geometry:
   filename: /starplot/hash_checks/data/map-limit-by-geometry.png
   phash: e54d9b926c6d1692
 map_scope_bino_fov:
-  dhash: 0bc0808c8c8080802bceb2ac4daa928c2bceb2ac4daa928c
+  dhash: 0bc0808c8c8080802bc6b22d4da9928c2bc6b22d4da9928c
   filename: /starplot/hash_checks/data/map-scope-bino-fov.png
-  phash: e46b296a6e693964
+  phash: e46b296e6e293964
 map_stereo_base:
   dhash: 627666f07c3c3436627666f0382c3436727666f2ecc89416
   filename: /starplot/hash_checks/data/map-stereo-north-base.png

{starplot-0.12.1 → starplot-0.12.3}/hash_checks/map_checks.py

@@ -450,35 +450,36 @@ def check_map_plot_custom_clip_path_virgo():
 
 
 def check_map_label_callables():
+    style = STYLE.extend(
+        {
+            "dso_open_cluster": {
+                "label": {
+                    "font_size": 28,
+                    "font_weight": "bold",
+                    "offset_x": 310,
+                    "offset_y": 240,
+                }
+            },
+        }
+    )
     p = MapPlot(
         projection=Projection.MILLER,
         ra_min=3.5,
         ra_max=4,
         dec_min=22,
         dec_max=26,
-        style=STYLE.extend(
-            {
-                "dso_open_cluster": {
-                    "label": {
-                        "font_size": 28,
-                        "font_weight": "bold",
-                        "offset_x": 310,
-                        "offset_y": 240,
-                    }
-                },
-            }
-        ),
+        style=style,
         resolution=2000,
     )
     m45 = DSO.get(m="45")
 
-    p.open_clusters(
-        where=[
-            (DSO.magnitude.is_null()) | (DSO.magnitude < 12),
-            DSO.geometry.intersects(m45.geometry),
-            DSO.size > 0.08,
-        ],
-        label_fn=lambda d: f"M{d.m}" if d.m else "",
+    p.polygon(
+        geometry=m45.geometry,
+        style__color=None,
+        style__fill_color=style.dso_open_cluster.marker.color,
+        style__edge_color="#000",
+        style__edge_width=4,
+        style__line_style=(0, (1.2, 8)),
     )
 
     p.stars(

{starplot-0.12.1 → starplot-0.12.3}/src/starplot/__init__.py

@@ -1,6 +1,6 @@
-"""Star charts and maps"""
+"""Star charts and maps of the sky"""
 
-__version__ = "0.12.1"
+__version__ = "0.12.3"
 
 from .base import BasePlot  # noqa: F401
 from .map import MapPlot, Projection  # noqa: F401

{starplot-0.12.1 → starplot-0.12.3}/src/starplot/base.py

@@ -10,6 +10,7 @@ from matplotlib import patches
 from matplotlib import pyplot as plt, patheffects
 from matplotlib.lines import Line2D
 from pytz import timezone
+from shapely import Polygon
 
 from starplot import geod, models
 from starplot.data import load, ecliptic
@@ -498,13 +499,28 @@ class BasePlot(ABC):
         self.ax.add_patch(patch)
 
     @use_style(PolygonStyle)
-    def polygon(self, points: list, style: PolygonStyle):
-        """Plots a polygon of points
+    def polygon(
+        self,
+        style: PolygonStyle,
+        points: list = None,
+        geometry: Polygon = None,
+    ):
+        """
+        Plots a polygon.
+
+        Must pass in either `points` **or** `geometry` (but not both).
 
         Args:
             points: List of polygon points `[(ra, dec), ...]` - **must be in counterclockwise order**
+            geometry: A shapely Polygon. If this value is passed, then the `points` kwarg will be ignored.
             style: Style of polygon
         """
+        if points is None and geometry is None:
+            raise ValueError("Must pass points or geometry when plotting polygons.")
+
+        if geometry is not None:
+            points = list(zip(*geometry.exterior.coords.xy))
+
         _points = [(ra * 15, dec) for ra, dec in points]
         self._polygon(_points, style)
 

{starplot-0.12.1 → starplot-0.12.3}/src/starplot/data/prep/constellations.py

@@ -58,7 +58,7 @@ def build_constellations():
         constellation_dict = {
             "id": cid.lower(),
             "iau_id": cid.lower(),
-            "name": props[0],
+            "name": props[0].replace("\n", " "),
             "center_ra": props[1] * 15,
             "center_dec": props[2],
             "lines_hip_ids": ",".join(
@@ -103,6 +103,6 @@ gdf.to_file(
     DATA_LIBRARY / "constellations.gpkg", driver="GPKG", engine="pyogrio", index=True
 )
 
-print(gdf.loc["uma"])
+print(gdf.loc["cmi"])
 
 print("Total Constellations: " + str(len(constellation_records)))

{starplot-0.12.1 → starplot-0.12.3}/src/starplot/styles/base.py

@@ -1,7 +1,7 @@
 import json
 from enum import Enum
 from pathlib import Path
-from typing import Optional
+from typing import Optional, Union
 from functools import cache
 
 import yaml
@@ -332,8 +332,8 @@ class LineStyle(BaseStyle):
     color: ColorStr = ColorStr("#000")
     """Color of the line. Can be a hex, rgb, hsl, or word string."""
 
-    style: LineStyleEnum = LineStyleEnum.SOLID
-    """Style of the line (e.g. solid, dashed, etc)."""
+    style: Union[LineStyleEnum, tuple] = LineStyleEnum.SOLID
+    """Style of the line (e.g. solid, dashed, etc). Can be a predefined value in `LineStyleEnum` or a [Matplotlib linestyle tuple](https://matplotlib.org/stable/gallery/lines_bars_and_markers/linestyles.html)."""
 
     dash_capstyle: DashCapStyleEnum = DashCapStyleEnum.PROJECTING
     """Style of dash endpoints"""
@@ -401,8 +401,8 @@ class PolygonStyle(BaseStyle):
     fill_color: Optional[ColorStr] = None
     """Fill color of the polygon"""
 
-    line_style: LineStyleEnum = LineStyleEnum.SOLID
-    """Edge line style"""
+    line_style: Union[LineStyleEnum, tuple] = LineStyleEnum.SOLID
+    """Edge line style. Can be a predefined value in `LineStyleEnum` or a [Matplotlib linestyle tuple](https://matplotlib.org/stable/gallery/lines_bars_and_markers/linestyles.html)."""
 
     alpha: float = 1.0
     """Alpha value (controls transparency)"""
@@ -419,6 +419,7 @@ class PolygonStyle(BaseStyle):
             linestyle=self.line_style,
             alpha=self.alpha,
             zorder=self.zorder,
+            capstyle="round",
         )
         if self.color:
             styles["color"] = self.color.as_hex()

starplot-0.12.1/docs/gallery.md

@@ -1,27 +0,0 @@
-<div class="grid cards" markdown>
-
-- ![Zenith Star Chart - blue medium](images/gallery/zenith_0.png)
-- ![Zenith Star Chart - nord](images/gallery/zenith_1.png)
-
-- ![Orion - Map](images/gallery/orion.png)
-- ![Sagittarius - Map](images/gallery/sagittarius.png)
-
-- ![Optic - 1](images/gallery/optic_01.png)
-- ![Optic - 2](images/gallery/optic_02.png)
-
-- ![Orthographic Map - 1](images/gallery/orthographic_01.png)
-- ![Orthographic Map - 2](images/gallery/orthographic_02.png)
-
-
-- ![Large Magellanic Cloud - Map](images/gallery/magellanic_cloud.png)
-
-- ![Optic - 3](images/gallery/optic_03.png)
-
-- ![Big Miller](images/gallery/miller_big.png)
-
-- ![Hale Bopp Comet](images/examples/example_07.png)
-
-- ![Antique](images/gallery/antique.png)
-
-
-</div>