starplot 0.13.0__tar.gz → 0.14.0__tar.gz

{starplot-0.13.0 → starplot-0.14.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.3
 Name: starplot
-Version: 0.13.0
+Version: 0.14.0
 Summary: Star charts and maps of the sky
-Keywords: astronomy,stars,charts,maps,constellations
+Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
 Author-email: Steve Berardi <hello@steveberardi.com>
 Description-Content-Type: text/markdown
 Classifier: License :: OSI Approved :: MIT License
@@ -17,7 +17,6 @@ Requires-Dist: pandas >= 1.4.0
 Requires-Dist: pydantic >= 2.0.3
 Requires-Dist: shapely >= 2.0.1
 Requires-Dist: skyfield >= 1.41
-Requires-Dist: adjustText >= 1.0
 Requires-Dist: cartopy >= 0.21.1
 Requires-Dist: geopandas >= 0.13.2
 Requires-Dist: pillow >= 10.0.0
@@ -39,10 +38,11 @@ Project-URL: Source, https://github.com/steveberardi/starplot
 
 **Starplot** is a Python library for creating star charts and maps of the sky.
 
-- ⭐ **Zenith Plots** - showing the whole sky from a specific time/location
+- ⭐ **Zenith Plots** - shows the entire sky at a specific time and place
 - 🗺️ **Map Plots** - including many map projections
-- 🔭 **Optic Plots** - simulates what you'll see through an optic (e.g. binoculars, telescope) from a time/location
-- 🪐 **Planets and Deep Sky Objects (DSOs)**
+- 🌃 **Horizon Plots** - shows the horizon at a specific time and place
+- 🔭 **Optic Plots** - shows what you'll see through an optic (e.g. telescope) at a specific time and place
+- 🪐 **Planets and Deep Sky Objects (DSOs)** - more than 14,000 objects built-in
 - 🎨 **Custom Styles** - for all objects
 - 📥 **Export** - png, svg, jpeg
 - 🧭 **Label Collision Avoidance**
@@ -76,11 +76,12 @@ p = sp.MapPlot(
     style=sp.styles.PlotStyle().extend(
         sp.styles.extensions.BLUE_MEDIUM,
     ),
-    resolution=3200,
+    resolution=4096,
     autoscale=True,
 )
 p.constellations()
 p.stars(mag=4.6)
+p.constellation_labels()
 p.export("starchart.png")
 ```
 
@@ -105,11 +106,11 @@ https://discord.gg/WewJJjshFu
 Contributing to Starplot is welcome and very much appreciated! Please see [here](CONTRIBUTING.md) for details.
 
 ## Coming Soon
-- 🌄 Horizon plots
+- 🗄️ Data optimizations
+- 🧮 Coordinate system helpers
 - 🌑 Planet moons
 - ✴️ Custom markers
 - ☄️ Comet model
-- 💫 Better constellation label placement
 - 😄 🔭 Clear skies
 
 See more details on the [Public Roadmap](https://trello.com/b/sUksygn4/starplot-roadmap)

{starplot-0.13.0 → starplot-0.14.0}/README.md

@@ -6,10 +6,11 @@
 
 **Starplot** is a Python library for creating star charts and maps of the sky.
 
-- ⭐ **Zenith Plots** - showing the whole sky from a specific time/location
+- ⭐ **Zenith Plots** - shows the entire sky at a specific time and place
 - 🗺️ **Map Plots** - including many map projections
-- 🔭 **Optic Plots** - simulates what you'll see through an optic (e.g. binoculars, telescope) from a time/location
-- 🪐 **Planets and Deep Sky Objects (DSOs)**
+- 🌃 **Horizon Plots** - shows the horizon at a specific time and place
+- 🔭 **Optic Plots** - shows what you'll see through an optic (e.g. telescope) at a specific time and place
+- 🪐 **Planets and Deep Sky Objects (DSOs)** - more than 14,000 objects built-in
 - 🎨 **Custom Styles** - for all objects
 - 📥 **Export** - png, svg, jpeg
 - 🧭 **Label Collision Avoidance**
@@ -43,11 +44,12 @@ p = sp.MapPlot(
     style=sp.styles.PlotStyle().extend(
         sp.styles.extensions.BLUE_MEDIUM,
     ),
-    resolution=3200,
+    resolution=4096,
     autoscale=True,
 )
 p.constellations()
 p.stars(mag=4.6)
+p.constellation_labels()
 p.export("starchart.png")
 ```
 
@@ -72,11 +74,11 @@ https://discord.gg/WewJJjshFu
 Contributing to Starplot is welcome and very much appreciated! Please see [here](CONTRIBUTING.md) for details.
 
 ## Coming Soon
-- 🌄 Horizon plots
+- 🗄️ Data optimizations
+- 🧮 Coordinate system helpers
 - 🌑 Planet moons
 - ✴️ Custom markers
 - ☄️ Comet model
-- 💫 Better constellation label placement
 - 😄 🔭 Clear skies
 
 See more details on the [Public Roadmap](https://trello.com/b/sUksygn4/starplot-roadmap)

{starplot-0.13.0 → starplot-0.14.0}/docs/changelog.md

@@ -1,4 +1,13 @@
+## v0.14.x
+- Adds horizon plots, which show what the sky looks like from the horizon at a specific time and place
+- Improved auto placement of constellation labels
+- Separates styles and functions for constellation lines and labels
+- Plots constellation lines and borders as a `LineCollection` to improve performance
+- Adds option to suppress warnings from dependencies
+- Adds legend labels to shape functions
+
 ## v0.13.x
+[Documentation](https://archives.starplot.dev/0.13.0/)
 
 - Adds a `scale` factor to control sizing of all objects/text
 - Adds an "auto" option for label offsets from markers

{starplot-0.13.0 → starplot-0.14.0}/docs/coming-soon.md

@@ -1,9 +1,9 @@
 
-- 🌄 Horizon plots
+- 🗄️ Data optimizations
+- 🧮 Coordinate system helpers
 - 🌑 Planet moons
 - ☄️ Comet model
 - ✴️ Custom markers
-- 💫 Better constellation label placement
 - 😄 🔭 Clear skies
 
 <br/>

starplot-0.14.0/docs/examples/horizon-sgr.md

@@ -0,0 +1,16 @@
+---
+title: Horizon Plot
+---
+[:octicons-arrow-left-24: Back to Examples](/examples)
+
+# Horizon Plot {.example-header}
+
+![horizon-sgr](/images/examples/horizon_sgr.png)
+
+This plot shows what was in the sky when looking southwest from Lone Pine, California on August 30, 2024 at 9pm PT.
+
+```python
+--8<-- "examples/horizon_sgr.py"
+```
+
+

{starplot-0.13.0 → starplot-0.14.0}/docs/examples.md

@@ -57,6 +57,14 @@
             <p class="example-card-title">Milky Way Stars</p>
         </a>
     </li>
+    
+    <li>
+        <a href="/examples/horizon-sgr/">
+            <img src="/images/examples/horizon_sgr-sm.png" alt="Horizon Plot of Sagittarius" class="off-glb" loading="lazy"/>
+
+            <p class="example-card-title">Horizon Plot</p>
+        </a>
+    </li>
 
     <li>
         <a href="/examples/map-big-dipper/">

{starplot-0.13.0 → starplot-0.14.0}/docs/index.md

@@ -12,13 +12,15 @@ title: Star Charts and Maps of the Sky in Python
 Starplot is a Python library for creating star charts and maps of the sky.
 {.text-subtitle}
 
-- ⭐ **Zenith Plots** - showing the stars from a specific time/location
+- ⭐ **Zenith Plots** - shows the entire sky at a specific time and place
 
-- 🗺️ **Map Plots** - including stereographic and perspective projections
+- 🗺️ **Map Plots** - including many projections
 
-- 🔭 **Optic Plots** - simulates what you'll see through an optic (e.g. telescope) from a time/location
+- 🌃 **Horizon Plots** - shows the horizon at a specific time and place
 
-- 🪐 **Planets and Deep Sky Objects (DSOs)**
+- 🔭 **Optic Plots** - shows what you'll see through an optic (e.g. telescope) at a specific time and place
+
+- 🪐 **Planets and Deep Sky Objects (DSOs)** - more than 14,000 objects built-in
 
 - 🎨 **Custom Styles** - for all objects
 

starplot-0.14.0/docs/reference-horizonplot.md

@@ -0,0 +1,10 @@
+**Horizon plots show what the sky looks like from the horizon at a specific time and place**. They can help illustrate answers to questions like "what stars will I see in the sky tonight at 9pm when I look directly West from my backyard?"
+
+These plots use the [Lambert azimuthal equal-area projection](https://en.wikipedia.org/wiki/Lambert_azimuthal_equal-area_projection), with the horizon as the central altitude (0 degrees) and the central azimuth is determined by the azimuth range you define when creating the plot.
+
+::: starplot.HorizonPlot
+    options:
+        inherited_members: true
+        merge_init_into_class: true
+        show_root_heading: true
+

{starplot-0.13.0 → starplot-0.14.0}/docs/tutorial/02.md

@@ -39,9 +39,17 @@ On line 8, we create a [`MapPlot`][starplot.MapPlot] instance that specifies a f
 - `resolution`: Resolution (in pixels) of the widest dimension of the plot
 - `scale`: This controls the sizing of all text and markers. At scale `1.0` everything is optimized for a basic map of 1-3 constellations, so if you're plotting a larger area (or just want everything smaller), then it's a good idea to decrease the scale so the plot isn't too crowded.
 
-When you create a plot instance, initially it'll be empty (i.e. it won't have any stars). In Starplot, you have to explicitly plot all objects. So, on line 16 we plot the constellations, which includes lines and labels. Then, we plot stars with a limiting magnitude of 4.6.
+When you create a plot instance, initially it'll be empty (i.e. it won't have any stars or constellations). In Starplot, you have to explicitly plot all objects.
 
-Finally, we export the plot to a PNG file.
+So, on line 16 we start by plotting the constellation lines. We plot these _first_, because Starplot can use the constellation lines to automatically find good places to plot object labels.
+
+Next, we plot stars with a limiting magnitude of 4.6. Notice how none of the star names in the plot cross over a constellation line? That's because we plotted the constellation lines _before_ plotting the stars.
+
+After the stars, we plot the horizon, which is the border around the plot with the cardinal direction labels.
+
+Lastly, we plot the constellation labels. It's good to plot these last because they're area-based labels (vs point-based, like for star names), and area-based labels have more freedom to move around. If you plot area-based labels first, then it would limit the available space for point-based labels.
+
+Once we're done plotting, we export the plot to a PNG file.
 
 *In the [next section](03.md), we'll learn how to add some styles and other objects to the plot...*
 

{starplot-0.13.0 → starplot-0.14.0}/docs/tutorial/09.md

@@ -14,6 +14,7 @@ The purpose of the tutorial was just to give you an intro to some of Starplot's
 - [Examples](/examples)
 - Code References:
     - [MapPlot](/reference-mapplot/)
+    - [HorizonPlot](/reference-horizonplot/)
     - [OpticPlot](/reference-opticplot/)
     - [Styling](/reference-styling/)
 - [Join other Starplotters on Discord](https://discord.gg/WewJJjshFu)

starplot-0.14.0/examples/horizon_sgr.py

@@ -0,0 +1,39 @@
+from datetime import datetime
+
+from pytz import timezone
+
+from starplot import HorizonPlot, Star, DSO
+from starplot.styles import PlotStyle, extensions
+
+style = PlotStyle().extend(
+    extensions.BLUE_MEDIUM,
+    extensions.MAP,
+    {"figure_background_color": "hsl(212, 27%, 48%)"},
+)
+
+dt = timezone("US/Pacific").localize(datetime(2024, 8, 30, 21, 0, 0, 0))
+
+p = HorizonPlot(
+    altitude=(0, 60),
+    azimuth=(175, 275),
+    lat=36.606111,  # Lone Pine, California
+    lon=-118.079444,
+    dt=dt,
+    style=style,
+    resolution=4000,
+    scale=0.9,
+)
+
+p.constellations()
+p.milky_way()
+
+p.stars(where=[Star.magnitude < 5])
+p.messier(where=[DSO.magnitude < 12], true_size=False, label_fn=lambda d: f"M{d.m}")
+
+p.constellation_labels()
+p.planets()
+p.ecliptic()
+p.horizon()
+p.gridlines()
+
+p.export("horizon_sgr.png", padding=0.2)

{starplot-0.13.0 → starplot-0.14.0}/examples/map_big.py

@@ -19,9 +19,7 @@ p = MapPlot(
     scale=0.8,
 )
 p.gridlines()
-p.constellations(
-    style__label__font_size=28,
-)
+p.constellations()
 p.stars(mag=6, where_labels=[Star.magnitude < 2.1])
 p.open_clusters(
     labels=None,
@@ -49,6 +47,7 @@ p.nebula(
     where=[(DSO.magnitude <= 10) | (DSO.magnitude.is_null()), DSO.size > 0.05],
 )
 
+p.constellation_labels(style__font_size=28)
 p.milky_way()
 p.ecliptic()
 p.celestial_equator()

{starplot-0.13.0 → starplot-0.14.0}/examples/map_canis_major.py

@@ -23,5 +23,6 @@ p.constellations(
 p.constellation_borders()
 p.open_clusters(mag=8, true_size=False, label_fn=lambda d: f"{d.ngc}")
 p.stars(mag=9, bayer_labels=True, catalog="big-sky-mag11")
+p.constellation_labels()
 p.ax.set_axis_off()
 p.export("map_canis_major.png", padding=0, transparent=True)

{starplot-0.13.0 → starplot-0.14.0}/examples/map_comet_neowise.py

@@ -93,6 +93,7 @@ p.gridlines(labels=False)
 p.constellations()
 p.constellation_borders()
 p.stars(mag=6, where_labels=[Star.magnitude < 2])
+p.constellation_labels()
 p.milky_way()
 p.legend()
 

{starplot-0.13.0 → starplot-0.14.0}/examples/map_orion.py

@@ -43,6 +43,7 @@ p.open_clusters(
 
 p.nebula(mag=9, labels=None, label_fn=lambda d: d.ngc)
 
+p.constellation_labels()
 p.milky_way()
 p.ecliptic()
 p.legend()

{starplot-0.13.0 → starplot-0.14.0}/examples/map_orthographic.py

@@ -26,9 +26,7 @@ p = MapPlot(
     scale=0.9,  # lower the scale since it shows a large area
 )
 p.gridlines(labels=False)
-p.constellations(
-    style={"label": {"font_alpha": 0.4}},
-)
+p.constellations()
 p.constellation_borders()
 
 p.stars(mag=7.86, where_labels=[Star.magnitude < 6])
@@ -36,6 +34,7 @@ p.open_clusters(where=[DSO.magnitude < 12], true_size=False, labels=None)
 p.galaxies(where=[DSO.magnitude < 12], true_size=False, labels=None)
 p.nebula(where=[DSO.magnitude < 12], true_size=False, labels=None)
 
+p.constellation_labels(style__font_alpha=0.4)
 p.ecliptic()
 p.celestial_equator()
 p.milky_way()

{starplot-0.13.0 → starplot-0.14.0}/examples/map_sagittarius.py

@@ -61,4 +61,5 @@ p.globular_clusters(
 p.ecliptic()
 p.celestial_equator()
 p.milky_way()
+p.constellation_labels()
 p.export("map_sagittarius.png", padding=0.08)

{starplot-0.13.0 → starplot-0.14.0}/examples/optic_m45.py

@@ -26,7 +26,7 @@ p = OpticPlot(
     ),
     dt=dt,
     style=style,
-    resolution=2048,
+    resolution=4096,
     autoscale=True,
 )
 p.stars(

{starplot-0.13.0 → starplot-0.14.0}/examples/optic_orion_nebula.py

@@ -26,7 +26,7 @@ p = OpticPlot(
     ),
     dt=dt,
     style=style,
-    resolution=2048,
+    resolution=4096,
     autoscale=True,
 )
 p.stars(mag=15, color_fn=color_by_bv, bayer_labels=True)

{starplot-0.13.0 → starplot-0.14.0}/examples/star_chart_basic.py

@@ -17,8 +17,9 @@ p = MapPlot(
     resolution=3600,
     autoscale=True,
 )
+p.horizon()
 p.constellations()
 p.stars(mag=4.4, where_labels=[Star.magnitude < 2.4])
-p.horizon()
+p.constellation_labels()
 
 p.export("star_chart_basic.png", transparent=True, padding=0.1)

{starplot-0.13.0 → starplot-0.14.0}/examples/star_chart_detail.py

@@ -17,6 +17,7 @@ p = MapPlot(
     resolution=3600,
     autoscale=True,
 )
+p.horizon()
 p.constellations()
 p.stars(mag=4.6, where_labels=[Star.magnitude < 2.1])
 
@@ -51,6 +52,6 @@ p.marker(
     },
     label="Mel 111",
 )
-p.horizon()
+p.constellation_labels()
 
 p.export("star_chart_detail.png", transparent=True, padding=0.1)

{starplot-0.13.0 → starplot-0.14.0}/hash_checks/hashio.py

@@ -15,6 +15,7 @@ from rich.console import Console
 import map_checks
 import optic_checks
 import zenith_checks
+import horizon_checks
 
 TEMPLATE_NAME = "template.html"
 
@@ -87,7 +88,7 @@ class Hashio:
 
     def _get_hashes(self) -> dict:
         """Gets hashes for all callables"""
-        mp.set_start_method("spawn")  # required for M1 macs? or macOS issue?
+        # mp.set_start_method("spawn")  # required for M1 macs? or macOS issue?
 
         console.print("Getting hashes...", style="bold")
         with mp.Pool(5) as p:
@@ -154,6 +155,7 @@ if __name__ == "__main__":
     callables = Hashio.find_functions(map_checks)
     callables += Hashio.find_functions(zenith_checks)
     callables += Hashio.find_functions(optic_checks)
+    callables += Hashio.find_functions(horizon_checks)
 
     h = Hashio(callables=callables)
 
@@ -167,6 +169,10 @@ if __name__ == "__main__":
 
         console.print(f"\nPASSED: {passed}\n", style="green")
 
+        if failed:
+            console.print("FAILED: retrying...\n", style="bold red")
+            passed, failed, new = h.check()
+
         if failed or new:
             console.print(f"FAILED: {failed}\n", style="bold red")
             console.print(f"NEW   : {new}\n", style="blue")

{starplot-0.13.0 → starplot-0.14.0}/hash_checks/hashlock.yml

@@ -1,87 +1,95 @@
+horizon_base:
+  dhash: 2f8bcd0dc10376542f8bcd0dc11b76542fcbcd8d801b7652
+  filename: /starplot/hash_checks/data/horizon-base.png
+  phash: e3a21cdd34b47295
+horizon_north_celestial_pole:
+  dhash: 18aa4a68c232885419a84a68c232485439ab4ad8e2328854
+  filename: /starplot/hash_checks/data/horizon-north-celestial-pole.png
+  phash: d5b27ad908d13dc1
 map_coma_berenices_dso_size:
-  dhash: 82848cece098c0c28a848cece098c482a28a92e2ec92c282
+  dhash: 8a84acecc888c0c0a2848ceca888c6c08a8a92a2a882c282
   filename: /starplot/hash_checks/data/map-coma-berenices-dso-size.png
-  phash: 969669694f9212cf
+  phash: 969669696f961269
 map_custom_stars:
   dhash: 5c21a9ceac2c84485c21a9ceac2c84485c21a9ceac2c8448
   filename: /starplot/hash_checks/data/map-custom-stars.png
-  phash: e65a5bb405a535d8
+  phash: e65a5b3415b535d0
 map_gridlines:
-  dhash: 0c219595224949210c219595224949210c21959522494921
+  dhash: 0c219595224949110c219595224949110c21959522494911
   filename: /starplot/hash_checks/data/map-gridlines.png
   phash: d2b45b172d3262ad
 map_label_callables:
   dhash: 80908c8c9c8c889080988c0c9c8c98a0809a9d0d8d9e98a0
   filename: /starplot/hash_checks/data/map-m45-label-callables.png
-  phash: b330cdcd3ce6268c
+  phash: b330cdc93ce6269c
 map_milky_way_multi_polygon:
-  dhash: 711f0b0c80761c2d711f0b0c80761c2d71530b0c80669c0d
+  dhash: 715f0b0880662c2d711f0b088076242d71530b088066ac2d
   filename: /starplot/hash_checks/data/map-milky-way-multi-polygon.png
-  phash: be89be8856524e69
+  phash: be89be9856504e69
 map_mollweide:
-  dhash: 0b0929733b31170f0b0929733b31170f0b0d29732b311707
+  dhash: 0b2b316b3b33070f0b2b316b3b33070f0b2b416b3b33250f
   filename: /starplot/hash_checks/data/map-mollweide.png
-  phash: facbe09885599563
+  phash: bb4bf2bc81649564
 map_moon_phase_waxing_crescent:
   dhash: 0804084d4d4804080804084d4d4804080804084d4d480408
   filename: /starplot/hash_checks/data/map-moon-phase-waxing-crescent.png
   phash: b3cccc3333cccc31
 map_orion_base:
-  dhash: 1c39393e2e2f64681c39396e2e2f64685c3939a62e4f2468
+  dhash: 18393b5e2e2f64681c393b5e2e2f64681c392bce2e0f6448
   filename: /starplot/hash_checks/data/map-orion-base.png
-  phash: be785b2435a4b598
+  phash: bf785b2415a4359c
 map_orion_extra:
-  dhash: 1c19393e2f656c4f1c39392e2f6568471c1b2b2e2f256c47
+  dhash: 1c393b3e2b67680f1d391b6f2b27680f1c3b0b0e2b276c0f
   filename: /starplot/hash_checks/data/map-orion-extra.png
-  phash: be71c11ee117a4d1
+  phash: bf71d01ee017e491
 map_plot_custom_clip_path_virgo:
-  dhash: 060529331d1c04040625252f0d1c0404060525270d1e0404
+  dhash: 060521331d1c04040625252f0d1c04040625252f0d1e0404
   filename: /starplot/hash_checks/data/map-custom-clip-path-virgo.png
-  phash: e66e8d91b1191bd2
+  phash: e66ec591b10d4bd2
 map_plot_limit_by_geometry:
-  dhash: 12a8809644041202122a82964404120232a880d645041242
+  dhash: 12a880964c0c1202122a8296440c120232a880d6452c1242
   filename: /starplot/hash_checks/data/map-limit-by-geometry.png
-  phash: a4899b366679669a
+  phash: a4019bbe6779168e
 map_scope_bino_fov:
-  dhash: 068080848cc088200686334d4d21924c0686334d4d21924c
+  dhash: 068080848cc080200686234d4d21924c0686234d4d21924c
   filename: /starplot/hash_checks/data/map-scope-bino-fov.png
-  phash: e6659931666c9939
+  phash: e6649931666c9979
 map_stereo_base:
-  dhash: 777264f234381416777264f0303cd416777664f2b498d456
+  dhash: 677666f0353a5412677666f431bcd412577666f0b598d412
   filename: /starplot/hash_checks/data/map-stereo-north-base.png
-  phash: 9dce69624a9176b2
+  phash: 9dce6d624a9132ba
 map_with_planets:
-  dhash: 629304668ddb3233629304668ddb3233629305668ddb3233
+  dhash: 229304668ddb323b2a9304668ddb323b2a9304668ddb32bb
   filename: /starplot/hash_checks/data/map-mercator-planets.png
-  phash: eac29d81a65f5332
+  phash: e8c29d89a67f5312
 map_wrapping:
-  dhash: 2f134c2d45cf23152f134c2d45cf23152f134c2d45cf2315
+  dhash: 0f332c4d4953311d0f332c4d4953311d0f332c4d4953311d
   filename: /starplot/hash_checks/data/map-wrapping.png
-  phash: ba32c9c5968cb713
+  phash: ea34f8c98387a572
 optic_camera_rotated:
   dhash: 25468b13261c1a6525468b13261c1a6525468b13261c1a65
   filename: /starplot/hash_checks/data/optic-camera-rotated-m45.png
   phash: bc6cc6941ed97285
 optic_clipping:
-  dhash: 70d898f066e4fc5d70d898f0eae4f85971f098eaf6f4fc71
+  dhash: 70d898f062e4fc5d70d898f0eae4f85971f098f2e6e4fc71
   filename: /starplot/hash_checks/data/optic-clipping.png
   phash: 95696a872f9a7870
 optic_m45_binoculars:
-  dhash: 8e173b7133330e4d8e173b7133330e4d8e173b7133330e4d
+  dhash: 8e17237133330e4d8e17237133330e4d8e17237133330e4d
   filename: /starplot/hash_checks/data/optic-m45-binoculars.png
-  phash: aa7b84f586d18ac6
+  phash: ae7b80f186d18ad3
 optic_m45_camera:
-  dhash: 4d715151716559754d715151716559754d71515171655975
+  dhash: 4d515151716559754d515151716559754d51515171655975
   filename: /starplot/hash_checks/data/optic-m45-camera.png
-  phash: ba7b846e847b84d1
+  phash: ba7b846e843b84d5
 optic_m45_reflector:
-  dhash: 8e1f2b7123330e4d8e1f2b7123330e4d8e1f2b7123330e4d
+  dhash: 8e172b7123330e4d8e172b7123330e4d8e172b7123330e4d
   filename: /starplot/hash_checks/data/optic-m45-reflector.png
-  phash: ba7b80e4c6b19b92
+  phash: ba7b80e5c6b19a92
 optic_m45_scope:
-  dhash: 8e173b5133230e4d8e173b5133230e4d8e173b5133230e4d
+  dhash: 8e173b5123230e4d8e173b5123230e4d8e173b5123230e4d
   filename: /starplot/hash_checks/data/optic-m45-scope.png
-  phash: ba7b84e486b18e93
+  phash: aa7b84e586b18e93
 optic_moon_phase_full:
   dhash: 0e2b553333552b0e0e2b553333552b0e0e2b553333552b0e
   filename: /starplot/hash_checks/data/optic-moon-phase-full.png
@@ -97,20 +105,20 @@ optic_moon_phase_waxing_crescent:
 optic_orion_nebula_refractor:
   dhash: 8e1f2d7163230e4d8e1f2d7163230e4d8e1f2d7163230e4d
   filename: /starplot/hash_checks/data/optic-orion-nebula-refractor.png
-  phash: ae3ab165c3919e92
+  phash: ae3ab065c7919e92
 optic_polaris_binoculars:
-  dhash: 8e172b5533338e4d8e172b5533338e4d8e172b5533338e4d
+  dhash: 8e172b5523338e4d8e172b5523338e4d8e172b5523338e4d
   filename: /starplot/hash_checks/data/optic-binoculars-polaris.png
   phash: aa7b84f182d18ed3
 optic_solar_eclipse_binoculars:
-  dhash: 1779609a9a64610f0759e09a9ae469070359c09c9cc06903
+  dhash: 0779649a9ae461071759e49a9ae461170359c09c9cc06903
   filename: /starplot/hash_checks/data/optic-binoculars-eclipse.png
   phash: b1ccce3131cece31
 optic_wrapping:
-  dhash: 71f0ac92d2d8650a71e0d4aca4c4782a71e8d4acacc4713a
+  dhash: 71f0ec92d2d8650a71e0d4aca4c4782a71e8d4aca4c4713a
   filename: /starplot/hash_checks/data/optic-wrapping.png
   phash: d1846e1b792ef138
 zenith_base:
-  dhash: 1771c49e9e7d338e1779c49c9e5d338e1779c49c9e7d370e
+  dhash: 1771d496865d338e1771d494865d338e1779d494865d330e
   filename: /starplot/hash_checks/data/zenith-base.png
-  phash: bb41aa3be13c8764
+  phash: be40ab3be1389764

starplot-0.14.0/hash_checks/horizon_checks.py

@@ -0,0 +1,76 @@
+from pathlib import Path
+from datetime import datetime
+
+from pytz import timezone
+
+from starplot import styles, Star, HorizonPlot
+
+HERE = Path(__file__).resolve().parent
+DATA_PATH = HERE / "data"
+
+STYLE = styles.PlotStyle().extend(
+    styles.extensions.BLUE_MEDIUM,
+    styles.extensions.MAP,
+)
+
+RESOLUTION = 4096
+
+AUTO_ADJUST_SETTINGS = {"seed": 1}
+
+
+def _horizon():
+    dt = timezone("US/Pacific").localize(datetime(2024, 8, 30, 21, 0, 0, 0))
+
+    p = HorizonPlot(
+        altitude=(0, 50),
+        azimuth=(150, 210),
+        lat=36.606111,  # Lone Pine, California
+        lon=-118.079444,
+        dt=dt,
+        style=STYLE,
+        resolution=RESOLUTION,
+        scale=1.5,
+    )
+    p.constellations()
+    p.constellation_borders()
+    p.milky_way()
+    p.stars(where=[Star.magnitude < 5])
+    p.ecliptic()
+    p.horizon()
+    p.constellation_labels(auto_adjust_settings=AUTO_ADJUST_SETTINGS)
+    p.gridlines()
+    return p
+
+
+def check_horizon_base():
+    horizon_base = _horizon()
+    filename = DATA_PATH / "horizon-base.png"
+    horizon_base.export(filename)
+    return filename
+
+
+def check_horizon_north_celestial_pole():
+    dt = timezone("US/Pacific").localize(datetime(2024, 8, 30, 21, 0, 0, 0))
+
+    p = HorizonPlot(
+        altitude=(0, 50),
+        azimuth=(330, 390),
+        lat=36.606111,  # Lone Pine, California
+        lon=-118.079444,
+        dt=dt,
+        style=STYLE,
+        resolution=RESOLUTION,
+        scale=1.5,
+    )
+    p.constellations()
+    p.constellation_borders()
+    p.milky_way()
+    p.stars(where=[Star.magnitude < 5])
+    p.ecliptic()
+    p.horizon()
+    p.constellation_labels(auto_adjust_settings=AUTO_ADJUST_SETTINGS)
+    p.gridlines()
+
+    filename = DATA_PATH / "horizon-north-celestial-pole.png"
+    p.export(filename)
+    return filename