starplot 0.16.2__tar.gz → 0.16.4__tar.gz

{starplot-0.16.2 → starplot-0.16.4}/.github/workflows/test.yml

@@ -7,6 +7,8 @@ on:
     branches:
       - main
       - develop
+  schedule:
+        - cron: '0 12 * * *' # 1200 UTC = 0500 PT
 
 jobs:
   test-lint-build:

{starplot-0.16.2 → starplot-0.16.4}/CITATION.cff

@@ -20,5 +20,5 @@ keywords:
   - graphs
   - plotting
 license: MIT
-version: 0.16.2
-date-released: '2025-09-07'
+version: 0.16.4
+date-released: '2025-10-01'

{starplot-0.16.2 → starplot-0.16.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starplot
-Version: 0.16.2
+Version: 0.16.4
 Summary: Star charts and maps of the sky
 Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
 Author-email: Steve Berardi <hello@steveberardi.com>
@@ -15,7 +15,6 @@ Requires-Dist: matplotlib >= 3.8.0
 Requires-Dist: numpy >= 1.26.2
 Requires-Dist: pandas >= 1.4.0
 Requires-Dist: pydantic >= 2.10.6
-Requires-Dist: pydantic-settings >= 2.10.1
 Requires-Dist: shapely >= 2.0.1
 Requires-Dist: skyfield >= 1.41
 Requires-Dist: cartopy >= 0.21.1
@@ -26,7 +25,7 @@ Requires-Dist: pyarrow >= 14.0.2
 Requires-Dist: pyogrio >= 0.10.0
 Requires-Dist: rtree >= 1.2.0
 Requires-Dist: requests >= 2.31.0
-Requires-Dist: duckdb >= 1.1.3
+Requires-Dist: duckdb < 1.4.0
 Requires-Dist: ibis-framework[duckdb, geospatial] < 11
 Project-URL: Documentation, https://starplot.dev
 Project-URL: Home, https://starplot.dev

{starplot-0.16.2 → starplot-0.16.4}/docs/changelog.md

@@ -16,6 +16,11 @@
 - Adds the `BLUE_NIGHT` plot style
 - [**v0.16.1**] Fixes constellation borders and Milky Way outline when they cross the first point of Aries (RA=0)
 - [**v0.16.2**] Fixes bug with rendering constellation labels as text elements for SVG exports
+- [**v0.16.3**] Locks version of DuckDB to < 1.4 (which seems to have an incompatibility issue)
+- [**v0.16.4**] 
+    - Removes `pydantic-settings` dependency
+    - Fixes constellation line plotting on a few projections to make them straight
+    - Cleans up a few imports to improve performance
 
 ## v0.15.x
 [Documentation](https://archives.starplot.dev/0.15.8/)

{starplot-0.16.2 → starplot-0.16.4}/docs/reference-settings.md

@@ -1,4 +1,4 @@
-Starplot uses a [Pydantic settings class](https://docs.pydantic.dev/latest/concepts/pydantic_settings/) to maintain a few global settings:
+Starplot uses an instance of a `dataclass` to maintain a few global settings:
 
 - Data download path
 - DuckDB extension path

{starplot-0.16.2 → starplot-0.16.4}/hash_checks/hashlock.yml

@@ -7,9 +7,9 @@ horizon_gradient_background:
   filename: /starplot/hash_checks/data/horizon-gradient-background.png
   phash: 954f43916bc46ee4
 horizon_north_celestial_pole:
-  dhash: b0aaaab2a2b2a696b0aaaab282b2a696b2aaaaeaa2b2aec4
+  dhash: b0aaaab2a2b2a696b0aaaab282b2a696b0aaaaeaa2b2aec4
   filename: /starplot/hash_checks/data/horizon-north-celestial-pole.png
-  phash: d5907ad16ad16bc4
+  phash: d5907ad16ad06bc3
 map_coma_berenices_dso_size:
   dhash: ea84acecc888c0c0aa828ceca888c682aa8a92a2a882c282
   filename: /starplot/hash_checks/data/map-coma-berenices-dso-size.png
@@ -33,7 +33,7 @@ map_milky_way_multi_polygon:
 map_mollweide:
   dhash: 0f2b336b2b33170f0f2b336b2b33170f176373632b32170f
   filename: /starplot/hash_checks/data/map-mollweide.png
-  phash: ebcbb69ce3209461
+  phash: ebcbb698e3309461
 map_moon_phase_waxing_crescent:
   dhash: 0814284d4d2814488894a84d4da894888884884d4d888488
   filename: /starplot/hash_checks/data/map-moon-phase-waxing-crescent.png

{starplot-0.16.2 → starplot-0.16.4}/pyproject.toml

@@ -21,7 +21,6 @@ dependencies = [
     "numpy >= 1.26.2",
     "pandas >= 1.4.0",
     "pydantic >= 2.10.6",
-    "pydantic-settings >= 2.10.1",
     "shapely >= 2.0.1",
     "skyfield >= 1.41",
     "cartopy >= 0.21.1",
@@ -32,7 +31,7 @@ dependencies = [
     "pyogrio >= 0.10.0",
     "rtree >= 1.2.0",
     "requests >= 2.31.0",
-    "duckdb >= 1.1.3",
+    "duckdb < 1.4.0",
     "ibis-framework[duckdb,geospatial] < 11",
 ]
 

{starplot-0.16.2 → starplot-0.16.4}/requirements.txt

@@ -2,14 +2,13 @@ matplotlib==3.10.3
 numpy==2.2.6
 pandas==2.2.3
 pydantic==2.11.7
-pydantic-settings==2.10.1
 shapely==2.1.1
 skyfield==1.53
 cartopy==0.25.0
 geopandas==1.0.1
 pillow==11.0.0
 PyYAML==6.0.1
-pyarrow==17.0.0
+pyarrow==21.0.0
 pyogrio==0.10.0
 rtree==1.4.1
 requests==2.31.0

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/__init__.py

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

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/config.py

@@ -1,7 +1,7 @@
+import os
 from enum import Enum
 from pathlib import Path
-
-from pydantic_settings import BaseSettings, SettingsConfigDict
+from dataclasses import dataclass, field
 
 
 STARPLOT_PATH = Path(__file__).resolve().parent
@@ -15,30 +15,46 @@ RAW_DATA_PATH = STARPLOT_PATH.parent.parent / "raw"
 BUILD_PATH = STARPLOT_PATH.parent.parent / "build"
 
 
+def _get_path(var_name, default) -> Path:
+    def _get():
+        value = os.environ.get(var_name, default)
+        return Path(value)
+
+    return _get
+
+
 class SvgTextType(str, Enum):
     PATH = "path"
     ELEMENT = "element"
 
 
-class Settings(BaseSettings):
-    model_config = SettingsConfigDict(env_prefix="STARPLOT_")
-    """Configuration for the Pydantic settings model. Do not change."""
-
-    download_path: Path = DATA_PATH / "downloads"
+@dataclass
+class Settings:
+    download_path: Path = field(
+        default_factory=_get_path("STARPLOT_DOWNLOAD_PATH", DATA_PATH / "downloads")
+    )
     """
     Path for downloaded data, including the Big Sky catalog, ephemeris files, etc.
     
     Default = `<starplot_source_path>/data/library/downloads/`
     """
 
-    duckdb_extension_path: Path = DATA_PATH / "duckdb-extensions"
+    duckdb_extension_path: Path = field(
+        default_factory=_get_path(
+            "STARPLOT_DUCKDB_EXTENSION_PATH", DATA_PATH / "duckdb-extensions"
+        )
+    )
     """
     Path for the DuckDB spatial extension, which is required for the data backend.
 
     Default = `<starplot_source_path>/data/library/duckdb-extensions/`
     """
 
-    svg_text_type: SvgTextType = SvgTextType.PATH
+    svg_text_type: SvgTextType = field(
+        default_factory=lambda: os.environ.get(
+            "STARPLOT_SVG_TEXT_TYPE", SvgTextType.PATH
+        )
+    )
     """
     Method for rendering text in SVG exports:
 

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/data/bigsky.py

@@ -1,7 +1,6 @@
 import os
 from pathlib import Path
 
-import pandas as pd
 
 from starplot.config import settings
 from starplot.data import DataFiles, utils
@@ -46,6 +45,7 @@ def download(
 def to_parquet(source_path: str, destination_path: str):
     import pyarrow as pa
     import pyarrow.parquet as pq
+    import pandas as pd
 
     print("Preparing Big Sky Catalog for Starplot...")
 

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/data/constellations.py

@@ -1,7 +1,6 @@
 from functools import cache
 
-import ibis
-from ibis import _
+from ibis import _, row_number
 
 from starplot.data import db
 
@@ -681,8 +680,8 @@ def table():
         dec=_.center_dec,
         constellation_id=_.iau_id,
         boundary=_.geometry,
-        rowid=ibis.row_number(),
-        sk=ibis.row_number(),
+        rowid=row_number(),
+        sk=row_number(),
     )
 
 
@@ -712,7 +711,7 @@ def load_borders(extent=None, filters=None):
         # ra=_.center_ra,
         # dec=_.center_dec,
         # constellation_id=_.iau_id,
-        rowid=ibis.row_number(),
+        rowid=row_number(),
         # boundary=_.geometry,
     )
 

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/data/db.py

@@ -1,6 +1,6 @@
 from functools import cache
 
-import ibis
+from ibis import duckdb
 
 from starplot.config import settings
 from starplot.data import DataFiles
@@ -8,7 +8,7 @@ from starplot.data import DataFiles
 
 @cache
 def connect():
-    connection = ibis.duckdb.connect(
+    connection = duckdb.connect(
         DataFiles.DATABASE, read_only=True
     )  # , threads=2, memory_limit="1GB"
     connection.raw_sql(

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/data/dsos.py

@@ -1,7 +1,6 @@
 from functools import cache
 
-import ibis
-from ibis import _
+from ibis import _, row_number, coalesce
 
 from starplot.data import db
 
@@ -36,10 +35,10 @@ def table():
         ra=_.ra_degrees,
         dec=_.dec_degrees,
         constellation_id=_.constellation,
-        magnitude=ibis.coalesce(_.mag_v, _.mag_b, None),
+        magnitude=coalesce(_.mag_v, _.mag_b, None),
         size=_.size_deg2,
-        rowid=ibis.row_number(),
-        sk=ibis.row_number(),
+        rowid=row_number(),
+        sk=row_number(),
     )
 
 

starplot-0.16.4/src/starplot/data/stars.py

@@ -0,0 +1,91 @@
+from functools import cache
+
+from ibis import _, row_number
+
+from starplot.data import bigsky, DataFiles, db
+
+
+class StarCatalog:
+    """Built-in star catalogs"""
+
+    BIG_SKY_MAG11 = "big-sky-mag11"
+    """
+    [Big Sky Catalog](https://github.com/steveberardi/bigsky) ~ 370k stars up to magnitude 10
+    
+    This is an _abridged_ version of the Big Sky Catalog, including stars up to a limiting magnitude of 10 (total = 368,330 981,852).
+
+    This catalog is included with Starplot, so does not require downloading any files.
+    """
+
+    BIG_SKY = "big-sky"
+    """
+    [Big Sky Catalog](https://github.com/steveberardi/bigsky) ~ 2.5M stars
+
+    This is the full version of the Big Sky Catalog, which includes 2,557,500 stars from Hipparcos, Tycho-1, and Tycho-2.
+
+    This catalog is very large (approx 100 MB), so it's not built-in to Starplot. When you plot stars and specify this catalog, the catalog 
+    will be downloaded from the [Big Sky GitHub repository](https://github.com/steveberardi/bigsky) and saved to Starplot's data library 
+    directory. You can override this download path with the environment variable `STARPLOT_DOWNLOAD_PATH`
+    
+    """
+
+
+@cache
+def table(catalog: StarCatalog = StarCatalog.BIG_SKY_MAG11, table_name="stars"):
+    con = db.connect()
+
+    if catalog == StarCatalog.BIG_SKY_MAG11:
+        stars = con.read_parquet(DataFiles.BIG_SKY_MAG11, table_name=table_name)
+    elif catalog == StarCatalog.BIG_SKY:
+        bigsky.download_if_not_exists()
+        stars = con.read_parquet(DataFiles.BIG_SKY, table_name=table_name)
+    else:
+        raise ValueError("Unrecognized star catalog.")
+
+    designations = con.table("star_designations")
+
+    stars = stars.mutate(
+        epoch_year=2000,
+        ra=_.ra_degrees,
+        dec=_.dec_degrees,
+        constellation_id=_.constellation,
+        ra_hours=_.ra_degrees / 15,
+        # stars parquet does not have geometry field
+        geometry=_.ra_degrees.point(_.dec_degrees),
+        rowid=row_number(),
+        sk=row_number(),
+    )
+
+    stars = stars.join(
+        designations,
+        [
+            stars.hip == designations.hip,
+            (stars.ccdm.startswith("A")) | (stars.ccdm == "") | (stars.ccdm.isnull()),
+        ],
+        how="left",
+    )
+
+    return stars
+
+
+def load(
+    extent=None,
+    catalog: StarCatalog = StarCatalog.BIG_SKY_MAG11,
+    filters=None,
+    sql=None,
+):
+    filters = filters or []
+    stars = table(catalog)
+
+    if extent:
+        stars = stars.filter(stars.geometry.intersects(extent))
+
+    if filters:
+        stars = stars.filter(*filters)
+
+    if sql:
+        result = stars.alias("_").sql(sql).select("sk").execute()
+        skids = result["sk"].to_list()
+        stars = stars.filter(_.sk.isin(skids))
+
+    return stars

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/geometry.py

@@ -143,6 +143,51 @@ def split_polygon_at_zero(polygon: Polygon) -> list[Polygon]:
     return [polygon]
 
 
+def split_polygon_at_360(polygon: Polygon) -> list[Polygon]:
+    """
+    Splits a polygon at 360 degrees
+
+    Args:
+        polygon: Polygon that possibly needs splitting
+
+    Returns:
+        List of polygons
+    """
+    ra, _ = [p for p in polygon.exterior.coords.xy]
+
+    if max(ra) > 360:
+        polygon_1 = polygon.intersection(
+            Polygon(
+                [
+                    [0, -90],
+                    [360, -90],
+                    [360, 90],
+                    [0, 90],
+                    [0, -90],
+                ]
+            )
+        )
+
+        polygon_2 = polygon.intersection(
+            Polygon(
+                [
+                    [360, -90],
+                    [720, -90],
+                    [720, 90],
+                    [360, 90],
+                    [360, -90],
+                ]
+            )
+        )
+
+        p2_ra, p2_dec = [p for p in polygon_2.exterior.coords.xy]
+        p2_new_ra = [ra - 360 for ra in p2_ra]
+
+        return [polygon_1, Polygon(list(zip(p2_new_ra, p2_dec)))]
+
+    return [polygon]
+
+
 def random_point_in_polygon(
     polygon: Polygon, max_iterations: int = 100, seed: int = None
 ) -> Point:

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/horizon.py

@@ -3,8 +3,8 @@ import math
 from functools import cache
 from typing import Callable
 
-import pandas as pd
-import geopandas as gpd
+# import pandas as pd
+# import geopandas as gpd
 
 from cartopy import crs as ccrs
 from matplotlib import pyplot as plt, patches
@@ -30,7 +30,7 @@ from starplot.styles import (
     GradientDirection,
 )
 
-pd.options.mode.chained_assignment = None  # default='warn'
+# pd.options.mode.chained_assignment = None  # default='warn'
 
 DEFAULT_HORIZON_STYLE = PlotStyle().extend(extensions.MAP)
 
@@ -49,6 +49,7 @@ DEFAULT_HORIZON_LABELS = {
 class HorizonPlot(
     BasePlot,
     ExtentMaskMixin,
+    # HorizonExtentMaskMixin,
     ConstellationPlotterMixin,
     StarPlotterMixin,
     DsoPlotterMixin,
@@ -122,6 +123,8 @@ class HorizonPlot(
         self.logger.debug("Creating HorizonPlot...")
         self.alt = altitude
         self.az = azimuth
+        self._alt = altitude
+        self._az = azimuth
         self.center_alt = sum(altitude) / 2
         self.center_az = sum(azimuth) / 2
 
@@ -155,16 +158,18 @@ class HorizonPlot(
         return pos_az.degrees, pos_alt.degrees
 
     def _prepare_star_coords(self, df, limit_by_altaz=True):
+        # import geopandas as gpd
+
         stars_apparent = self.observe(SkyfieldStar.from_dataframe(df)).apparent()
         nearby_stars_alt, nearby_stars_az, _ = stars_apparent.altaz()
         df["x"], df["y"] = (
             nearby_stars_az.degrees,
             nearby_stars_alt.degrees,
         )
-        if limit_by_altaz:
-            extent = self._extent_mask_altaz()
-            df["_geometry_az_alt"] = gpd.points_from_xy(df.x, df.y)
-            df = df[df["_geometry_az_alt"].intersects(extent)]
+        # if limit_by_altaz:
+        #     extent = self._extent_mask_altaz()
+        #     df["_geometry_az_alt"] = gpd.points_from_xy(df.x, df.y)
+        #     df = df[df["_geometry_az_alt"].intersects(extent)]
 
         return df
 

{starplot-0.16.2 → starplot-0.16.4}/src/starplot/map.py

@@ -459,10 +459,6 @@ class MapPlot(
         self.logger.debug(f"Projection = {self.projection.__class__.__name__.upper()}")
 
         self._fit_to_ax()
-
-        # if self.gradient_preset:
-        #     self.apply_gradient_background(self.gradient_preset)
-
         self._plot_background_clip_path()
 
     def _ax_to_radec(self, x, y):