starplot 0.19.3__tar.gz → 0.19.4__tar.gz

{starplot-0.19.3 → starplot-0.19.4}/CITATION.cff

@@ -20,5 +20,5 @@ keywords:
   - graphs
   - plotting
 license: MIT
-version: 0.19.3
-date-released: '2026-02-01'
+version: 0.19.4
+date-released: '2026-02-02'

{starplot-0.19.3 → starplot-0.19.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starplot
-Version: 0.19.3
+Version: 0.19.4
 Summary: Star charts and maps of the sky
 Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
 Author-email: Steve Berardi <hello@steveberardi.com>

{starplot-0.19.3 → starplot-0.19.4}/docs/changelog.md

@@ -13,6 +13,7 @@
 - [**v0.19.3**]
     - Makes `resolution` property more predictable
     - Fixes multiple issues with label collision handling
+- [**v0.19.4**] Fixes tiny bug with plotting labels
 
 ---
 

starplot-0.19.4/docs/examples/map-virgo-cluster.md

@@ -0,0 +1,18 @@
+---
+title: Map of the Virgo Galaxy Cluster
+---
+[:octicons-arrow-left-24: Back to Examples](/examples)
+
+# Map of the Virgo Galaxy Cluster {.example-header}
+
+![map-virgo-galaxy-cluster](/images/examples/map_virgo_cluster.png)
+
+In this example, we create a custom [CollisionHandler](/reference-collisions/) to ensure _all_ labels are plotted in the very busy area of the Virgo Galaxy Cluster:
+
+<div class="tutorial">
+```python
+--8<-- "examples/map_virgo_cluster.py"
+```
+</div>
+
+<br/><br/>

{starplot-0.19.3 → starplot-0.19.4}/docs/examples.md

@@ -114,6 +114,12 @@
             <p class="example-card-title">Custom Markers for Galaxies</p>
         </a>
     </li>
+    <li>
+        <a href="/examples/map-virgo-cluster/">
+            <img src="/images/examples/map_virgo_cluster-sm.png" alt="Map of the Virgo Galaxy Cluster" class="off-glb" loading="lazy"/>
+            <p class="example-card-title">Virgo Galaxy Cluster</p>
+        </a>
+    </li>
 </ul>
 
 </div>

{starplot-0.19.3 → starplot-0.19.4}/docs/reference-collisions.md

@@ -2,6 +2,8 @@ One of the biggest contributors to the visual quality of a map is labeling, whic
 
 When you create a plot, you can specify the default collision handler that'll be used when plotting text. But, you can also override this default on all functions that plot text (either directly or as a side effect). There's one exception to this though: since constellation labels are area-based labels they have their own default collision handler. 
 
+_See the [Virgo Galaxy Cluster](/examples/map-virgo-cluster/) plot for an example of using a custom collision handler._
+
 
 !!! tip "New Feature"
 

{starplot-0.19.3 → starplot-0.19.4}/examples/examples.py

@@ -29,7 +29,7 @@ def get_example_names():
     filenames = []
 
     for filename in glob.iglob("*.py"):
-        # if filename not in ["horizon_double_cluster.py"]:
+        # if filename not in ["map_virgo_cluster.py"]:
         #     continue
 
         if filename.endswith("examples.py"):

starplot-0.19.4/examples/map_virgo_cluster.py

@@ -0,0 +1,46 @@
+from starplot import MapPlot, Equidistant, CollisionHandler, _
+from starplot.styles import PlotStyle, extensions, AnchorPointEnum
+
+style = PlotStyle().extend(
+    extensions.BLUE_MEDIUM,
+    extensions.MAP,
+    {
+        "figure_background_color": "hsl(330, 44%, 20%)",
+        "dso_galaxy": {
+            "label": {
+                "font_color": "hsl(330, 44%, 14%)",
+                "font_weight": 200,
+                "anchor_point": AnchorPointEnum.BOTTOM_CENTER.value,
+            }
+        },
+    },
+)
+
+# Create a custom collision handler that ensures labels are ALWAYS plotted
+collision_handler = CollisionHandler(
+    # always plot an object's label, even if it collides with other labels or markers:
+    plot_on_fail=True,
+    # only try plotting object labels once:
+    attempts=1,
+)
+
+p = MapPlot(
+    projection=Equidistant(center_ra=11 * 15),
+    ra_min=12 * 15,
+    ra_max=13 * 15,
+    dec_min=8,
+    dec_max=18,
+    style=style,
+    resolution=3000,
+    scale=1,
+    collision_handler=collision_handler,
+)
+p.title("Virgo Cluster", style__font_color="hsl(330, 44%, 92%)")
+p.stars(where=[_.magnitude < 12], where_labels=[False])
+p.galaxies(
+    where=[
+        (_.magnitude < 12) | (_.magnitude.isnull()),
+    ],
+    where_true_size=[False],
+)
+p.export("map_virgo_cluster.png", padding=0.8)

{starplot-0.19.3 → starplot-0.19.4}/src/starplot/__init__.py

@@ -2,7 +2,7 @@
 
 """Star charts and maps of the sky"""
 
-__version__ = "0.19.3"
+__version__ = "0.19.4"
 
 from .plots import (
     MapPlot,

{starplot-0.19.3 → starplot-0.19.4}/src/starplot/plotters/text.py

@@ -166,7 +166,7 @@ class TextPlotterMixin:
             self._debug_bbox(bbox, color="white", width=1.5)
 
         self.labels.append(label)
-        self._labels_rtree.insert(0, (int(c) for c in bbox))
+        self._labels_rtree.insert(0, bbox)
 
     def _is_open_space(
         self,