starplot 0.15.6__tar.gz → 0.15.7__tar.gz

starplot-0.15.7/CITATION.cff

@@ -0,0 +1,24 @@
+cff-version: 1.2.0
+title: Starplot
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - given-names: Steve
+    family-names: Berardi
+    orcid: https://orcid.org/0009-0005-6106-1450
+repository-code: 'https://github.com/steveberardi/starplot'
+url: 'https://starplot.dev'
+abstract: >-
+  Starplot is a Python library for creating star charts and
+  maps of the sky
+keywords:
+  - astronomy
+  - maps
+  - charts
+  - graphs
+  - plotting
+license: MIT
+version: 0.15.6
+date-released: '2025-03-30'

{starplot-0.15.6 → starplot-0.15.7}/Makefile

@@ -152,7 +152,7 @@ flit-install:
 # ------------------------------------------------------------------
 # Utils
 ephemeris:
-	$(DOCKER_RUN) "python -m jplephem excerpt 2001/1/1 2050/1/1 $(DE421_URL) de421sub.bsp"
+	$(DOCKER_RUN) "python -m jplephem excerpt 2025/1/1 2050/1/1 $(DE421_URL) de421sub.bsp"
 
 hip8:
 	$(DOCKER_RUN) "python ./scripts/hip.py ./src/starplot/data/library/hip_main.dat hip8.dat 15"

{starplot-0.15.6 → starplot-0.15.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starplot
-Version: 0.15.6
+Version: 0.15.7
 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.15.6 → starplot-0.15.7}/docs/about.md

@@ -6,7 +6,7 @@
 
 However, the Starplot API becomes more stable with each new version. We anticipate that version `1.0.0` is still at least a year away. The best way to help us get there faster is to [join as a contributor](https://github.com/steveberardi/starplot/blob/main/CONTRIBUTING.md) 😃 help is wanted and very much appreciated!
 
-Join other starplotters on [Discord :fontawesome-brands-discord:{ .fg-primary }](https://discord.gg/WewJJjshFu)
+--8<-- "docs/snippets/_newsletter.html"
 
 ---
 

{starplot-0.15.6 → starplot-0.15.7}/docs/changelog.md

@@ -21,6 +21,9 @@
     - Fixes static constellation label plotting
     - Fixes polygon clipping on optic plots
     - Adds HII Regions to the `nebula()` function
+- [**v0.15.7**]
+    - Various small changes to make it easier to build AI agents that use Starplot
+    - Adds a `sql` kwarg to object selection and plotting functions to allow querying by SQL
 
 ## v0.14.x
 [Documentation](https://archives.starplot.dev/0.14.0/)

{starplot-0.15.6 → starplot-0.15.7}/docs/coming-soon.md

@@ -1,4 +1,6 @@
 
+- 🧮 Coordinate system helpers
+- 🌌 Galactic coordinate system plotting
 - 🌑 Planet moons
 - ☄️ Comet model
 - ✴️ Custom markers
@@ -7,3 +9,8 @@
 <br/>
 _See more details on the [Public Roadmap :arrow_upper_right:](https://trello.com/b/sUksygn4/starplot-roadmap)_{.text-subtitle}
 
+--8<-- "docs/snippets/_newsletter.html"
+
+<br/>
+<br/>
+<br/>

{starplot-0.15.6 → starplot-0.15.7}/docs/css/extra.css

@@ -421,3 +421,83 @@ td[data-column-id=bayer] {
     width: 100% !important;
     border: 1px solid var(--md-primary-fg-color) !important;
 }
+
+.email-form {
+    padding: 4px;
+
+    h3 {
+        margin-top: 0;
+    }
+
+    .md-button {
+        padding: 10px 20px;
+        border: 1px solid hsl(209, 53%, 36%) !important;;
+        border-radius: 8px !important;
+        background-color: hsl(209, 53%, 86%);
+        font-size: 1em;
+
+        &:hover {
+            color: hsl(209, 53%, 96%) !important;
+            background-color: hsl(209, 53%, 26%) !important;
+        }
+    }
+}
+
+.email-form input {
+    font-size: 1em;
+    padding: 10px;
+    border-radius: 10px;
+    border: 1px solid hsl(209, 43%, 68%);
+}
+
+.mt-0 {
+    margin-top: 0 !important;
+}
+
+.mb-0 {
+    margin-bottom: 0 !important;
+}
+
+.mt-1 {
+    margin-top: 10px !important;
+}
+
+.divider {
+    padding: 8px 0;
+    border-top: 1px solid hsl(209, 43%, 68%);
+}
+
+.info-panel {
+    padding: 20px 28px;
+    border: 1px solid hsl(209, 43%, 68%);
+    border-radius: 10px;
+    box-shadow: 4px 4px 4px rgb(159, 159, 159);
+}
+
+
+[data-md-color-scheme=default] {
+    .bg-info {
+        background-color: hsl(209, 78%, 98%);
+    }
+}
+
+[data-md-color-scheme=slate] {
+    .bg-info {
+        background-color: hsl(209, 40%, 14%);
+    }
+}
+
+.mw-660 {
+    max-width: 660px;
+}
+
+.filter-blue {
+    filter: invert(35%) sepia(10%) saturate(3166%) hue-rotate(168deg) brightness(93%) contrast(91%);
+}
+
+@media screen and (min-width: 768px) {
+    .columns-2 {
+        display: grid;
+        grid-template-columns: 1fr 3fr;
+    }
+}

starplot-0.15.7/docs/custom/main.html

@@ -0,0 +1,58 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+<!-- OG -->
+<meta property="og:title" content="Starplot" />
+<meta property="og:type" content="website" />
+<meta property="og:description" content="Star charts and maps of the sky in Python"/>
+<meta property="og:url" content="https://starplot.dev" />
+<meta property="og:image" content="https://archives.starplot.dev/static/og.png" />
+
+<!-- Plausible -->
+<script defer data-domain="starplot.dev" src="https://plausible.io/js/script.js"></script>
+{% endblock %}
+
+
+{% block scripts %}
+    {{ super() }}
+    <script>
+
+        document.addEventListener('DOMContentLoaded', function() {
+            const sidebar = document.querySelector("div.md-sidebar__scrollwrap");
+            const div = document.createElement("div");
+            const a = document.createElement("a");
+            const p = document.createElement("p");
+            const img = document.createElement("img");
+            
+            img.src = "/images/cover-front-sm-360.png";
+            img.style.maxWidth = '100px';
+            // img.style.marginTop = '4px';
+            img.style.opacity = '90%';
+            img.style.marginBottom = '16px';
+
+            div.style.marginTop = '60px';
+            div.style.marginLeft = '10px';
+            div.style.marginRight = '50px';
+
+            div.style.borderTop = '1px solid #c5c5c5';
+            div.style.borderBottom = '1px solid #c5c5c5';
+
+            p.innerText = "Help support Starplot by purchasing the All Sky Map, which was made with Starplot!"
+            p.style.lineHeight = "1.25em";
+            p.style.fontSize = "15px";
+            p.classList.add("md-typeset");
+
+            a.href = "https://steveberardimaps.com/products/all-sky-map";
+            a.target = "_blank";
+
+            // a.innerText = "Help support Starplot by purchasing the All Sky Map!";
+            
+            a.appendChild(img);
+            div.appendChild(p);
+            div.appendChild(a);
+            sidebar.appendChild(div);
+        });
+
+    </script>
+
+{% endblock %}

{starplot-0.15.6 → starplot-0.15.7}/docs/examples.md

@@ -135,6 +135,27 @@
 
 </div>
 
+<div class="info-panel bg-info columns-2" style="padding: 40px;">
+    <a href="https://steveberardimaps.com/products/all-sky-map" target="_blank">
+        <img src="/images/cover-front-sm-360.png" style="max-width: 240px; padding-right: 28px;" class="off-glb">
+    </a>
+    <div class="md-typeset">
+        <h2 class="mt-0">Example Publication - All Sky Map</h2>
+        
+        <p>Starplot can create publication-quality maps, thanks to its ability to export SVG files. These files can then be imported into many design applications, including Adobe Illustrator and Affinity Publisher, to create high-quality printed maps, books, etc.</p>
+
+        <p>One example is the <a href="https://steveberardimaps.com/products/all-sky-map" target="_blank">All Sky Map</a>, which is a foldable map designed and created by Steve Berardi (who also created Starplot!).</p>
+        
+        <p>The map was created by first writing code to generate SVG files of the map and then these were imported into Affinity Publisher to fine-tune some of the label positions and add the legend, supporting text, and create the overall page layout of the map. It was then printed on synthetic paper that is waterproof and tear-resistant!</p>
+    
+        <a href="https://steveberardimaps.com/products/all-sky-map" class="md-button" target="_blank" style="align-content: center;">
+            Check it out
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="18" height="18" class="filter-blue" style="margin-left: 4px; vertical-align: text-top;"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg>
+        </a>
+    
+    </div>
+</div>
+
 <br/>
 
 Check out the [tutorial](tutorial.md) and code reference to learn more about using Starplot!

starplot-0.15.7/docs/images/discord.svg

@@ -0,0 +1 @@
+<?xml version="1.0" encoding="UTF-8"?><svg id="Discord-Logo" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 126.644 96"><defs><style>.cls-1{fill:#5865f2;}</style></defs><path id="Discord-Symbol-Blurple" class="cls-1" d="M81.15,0c-1.2376,2.1973-2.3489,4.4704-3.3591,6.794-9.5975-1.4396-19.3718-1.4396-28.9945,0-.985-2.3236-2.1216-4.5967-3.3591-6.794-9.0166,1.5407-17.8059,4.2431-26.1405,8.0568C2.779,32.5304-1.6914,56.3725.5312,79.8863c9.6732,7.1476,20.5083,12.603,32.0505,16.0884,2.6014-3.4854,4.8998-7.1981,6.8698-11.0623-3.738-1.3891-7.3497-3.1318-10.8098-5.1523.9092-.6567,1.7932-1.3386,2.6519-1.9953,20.281,9.547,43.7696,9.547,64.0758,0,.8587.7072,1.7427,1.3891,2.6519,1.9953-3.4601,2.0457-7.0718,3.7632-10.835,5.1776,1.97,3.8642,4.2683,7.5769,6.8698,11.0623,11.5419-3.4854,22.3769-8.9156,32.0509-16.0631,2.626-27.2771-4.496-50.9172-18.817-71.8548C98.9811,4.2684,90.1918,1.5659,81.1752.0505l-.0252-.0505ZM42.2802,65.4144c-6.2383,0-11.4159-5.6575-11.4159-12.6535s4.9755-12.6788,11.3907-12.6788,11.5169,5.708,11.4159,12.6788c-.101,6.9708-5.026,12.6535-11.3907,12.6535ZM84.3576,65.4144c-6.2637,0-11.3907-5.6575-11.3907-12.6535s4.9755-12.6788,11.3907-12.6788,11.4917,5.708,11.3906,12.6788c-.101,6.9708-5.026,12.6535-11.3906,12.6535Z"/></svg>

{starplot-0.15.6 → starplot-0.15.7}/docs/index.md

@@ -30,9 +30,10 @@ Starplot is a Python library for creating star charts and maps of the sky.
 
 - 🧭 **Label Collision Avoidance**
 
-Join other starplotters on [Discord :fontawesome-brands-discord:{ .fg-primary }](https://discord.gg/WewJJjshFu)
 
-<hr>
+--8<-- "docs/snippets/_newsletter.html"
+
+
 *Example charts and maps created with Starplot:*
 <!-- {.text-subtitle} -->
 

starplot-0.15.7/docs/publications.md

@@ -0,0 +1,31 @@
+
+
+<div class="info-panel bg-info columns-2" style="padding: 40px;">
+    <a href="https://steveberardimaps.com/products/all-sky-map" target="_blank">
+        <img src="/images/cover-front-sm-360.png" style="max-width: 240px; padding-right: 28px;" class="off-glb">
+    </a>
+    <div class="md-typeset">
+        <h2 class="mt-0">All Sky Map</h2>
+        
+        <p>Starplot can create publication-quality maps, thanks to its ability to export SVG files. These files can then be imported into many design applications, including Adobe Illustrator and Affinity Publisher, to create high-quality printed maps, books, etc.</p>
+
+        <p>One example is the <a href="https://steveberardimaps.com/products/all-sky-map" target="_blank">All Sky Map</a>, which is a foldable map designed and created by Steve Berardi (who also created Starplot!).</p>
+        
+        <p>The map was created by first writing code to generate SVG files of the map and then these were imported into Affinity Publisher to fine-tune some of the label positions and add the legend, supporting text, and create the overall page layout of the map. It was then printed on synthetic paper that is waterproof and tear-resistant!</p>
+    
+        <a href="https://steveberardimaps.com/products/all-sky-map" class="md-button" target="_blank" style="align-content: center;">
+            Check it out
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16" width="18" height="18" class="filter-blue" style="margin-left: 4px; vertical-align: text-top;"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg>
+        </a>
+    
+    </div>
+</div>
+
+## How to Cite Starplot
+
+If you use Starplot to help create images for a publication, we'd greatly appreciate a citation. Please see Starplot's [GitHub repo](https://github.com/steveberardi/starplot) for an easy way to generate citations in different formats (on the [repo's homepage](https://github.com/steveberardi/starplot), look to the right side under the "About" section). We also maintain a [citation file](https://github.com/steveberardi/starplot/blob/main/CITATION.cff).
+
+We'd also love to list your publication on this page, so if you'd like to share please [email Steve Berardi](https://steveberardi.com/contact/), or join us on our [Discord server](https://discord.gg/WewJJjshFu).
+
+
+<br/><br/>

{starplot-0.15.6 → starplot-0.15.7}/docs/reference-selecting-objects.md

@@ -95,4 +95,16 @@ There are also a few operators you can use to combine expressions:
 _.magnitude > 8 | _.name == "Vega"
 ```
 
+## Using SQL
+
+All functions that accept a `where` list of filters _also_ have a `sql` keyword argument that lets you write a SQL query to select objects. You can also use a combination of `where` filters and a `sql` query, but the filters in `where` will be executed _first_. The table name is always an underscore: `_`.
+
+For example, if you want to find all stars with a magnitude less than 4, you can do:
+
+```python
+
+bright_stars = Star.find(sql="select * from _ where magnitude < 4")
+
+```
+
 <br/><br/>

starplot-0.15.7/docs/snippets/_newsletter.html

@@ -0,0 +1,25 @@
+<div class="info-panel mw-660">
+  <h3 class="mt-0">📬 Join our newsletter</h3>
+  <ul>
+    <li>Get notified when there's a new version of Starplot</li>
+    <li>Learn about specific use cases of Starplot</li>
+    <li>Help us plan and prioritize features by participating in surveys</li>
+  </ul>
+  <form
+    action="https://buttondown.com/api/emails/embed-subscribe/starplot"
+    method="post"
+    target="popupwindow"
+    onsubmit="window.open('https://buttondown.com/starplot', 'popupwindow')"
+    class="embeddable-buttondown-form email-form"
+  >
+    <input type="email" name="email" id="bd-email" required placeholder="Your e-mail" size="32" />
+    <input type="submit" value="Join" class="md-button mt-1" />
+  </form>
+
+  <p class="mb-0">
+    Also join us on
+    <a href="https://discord.gg/WewJJjshFu"
+      >Discord <img src="/images/discord.svg" height="18" width="18" class="off-glb"
+    /></a>
+  </p>
+</div>

{starplot-0.15.6 → starplot-0.15.7}/docs/tutorial/09.md

@@ -20,6 +20,8 @@ The purpose of the tutorial was just to give you an intro to some of Starplot's
 - [Join other Starplotters on Discord](https://discord.gg/WewJJjshFu)
 - Find a bug? Please [open an issue](https://github.com/steveberardi/starplot/issues) on GitHub, thanks!
 
+--8<-- "docs/snippets/_newsletter.html"
+
 <br/>
 
 ---

{starplot-0.15.6 → starplot-0.15.7}/docs/tutorial.md

@@ -17,6 +17,7 @@ Here's an overview of what the tutorial covers:
 
 Estimated time to complete: 30 minutes
 
-<br/>
 
 [Let's Begin! :octicons-arrow-right-24:](tutorial/01.md){ .md-button .text-right }
+
+<br/><br/><br/>

{starplot-0.15.6 → starplot-0.15.7}/hash_checks/map_checks.py

@@ -21,21 +21,21 @@ AUTO_ADJUST_SETTINGS = {"seed": 1}
 
 BASIC_DSO_TYPES = [
     # Star Clusters ----------
-    DsoType.OPEN_CLUSTER,
-    DsoType.GLOBULAR_CLUSTER,
+    DsoType.OPEN_CLUSTER.value,
+    DsoType.GLOBULAR_CLUSTER.value,
     # Galaxies ----------
-    DsoType.GALAXY,
-    DsoType.GALAXY_PAIR,
-    DsoType.GALAXY_TRIPLET,
-    DsoType.GROUP_OF_GALAXIES,
+    DsoType.GALAXY.value,
+    DsoType.GALAXY_PAIR.value,
+    DsoType.GALAXY_TRIPLET.value,
+    DsoType.GROUP_OF_GALAXIES.value,
     # Nebulas ----------
-    DsoType.NEBULA,
-    DsoType.PLANETARY_NEBULA,
-    DsoType.EMISSION_NEBULA,
-    DsoType.STAR_CLUSTER_NEBULA,
-    DsoType.REFLECTION_NEBULA,
+    DsoType.NEBULA.value,
+    DsoType.PLANETARY_NEBULA.value,
+    DsoType.EMISSION_NEBULA.value,
+    DsoType.STAR_CLUSTER_NEBULA.value,
+    DsoType.REFLECTION_NEBULA.value,
     # Stars ----------
-    DsoType.ASSOCIATION_OF_STARS,
+    DsoType.ASSOCIATION_OF_STARS.value,
 ]
 
 dt_dec_16 = datetime.now(timezone("US/Pacific")).replace(2023, 12, 16, 21, 0, 0)
@@ -87,7 +87,10 @@ def _stereo_north():
         resolution=RESOLUTION,
         autoscale=True,
     )
-    p.stars(where=[_.magnitude < 9], bayer_labels=True)
+    p.stars(
+        sql="select * from _ where magnitude < 9",
+        bayer_labels=True,
+    )
     p.dsos(
         labels=None,
         true_size=False,

{starplot-0.15.6 → starplot-0.15.7}/hash_checks/optic_checks.py

@@ -130,7 +130,7 @@ def check_optic_clipping():
         **plot_kwargs,
     )
     optic_plot.stars(where=[_.magnitude < 12])
-    optic_plot.dsos(where=[_.magnitude < 8.1], labels=None)
+    optic_plot.dsos(sql="select * from _ where magnitude < 8.1", labels=None)
     optic_plot.nebula()
     optic_plot.title("Orion Nebula")
     filename = DATA_PATH / "optic-clipping.png"

{starplot-0.15.6 → starplot-0.15.7}/mkdocs.yml

@@ -22,6 +22,7 @@ nav:
             - Constellations: data/constellations.md
         - Settings: reference-settings.md
     - Data Sources: data-sources.md
+    - Publications: publications.md
     - License: license.md
     - Changelog: changelog.md
     - Coming Soon: coming-soon.md

{starplot-0.15.6 → starplot-0.15.7}/requirements.txt

@@ -2,7 +2,7 @@ matplotlib==3.10.0
 numpy==2.2.2
 pandas==2.2.3
 pydantic==2.10.6
-shapely==2.0.7
+shapely==2.1.1
 skyfield==1.48
 cartopy==0.22.0
 geopandas==1.0.1
@@ -13,4 +13,4 @@ pyogrio==0.10.0
 rtree==1.3.0
 requests==2.31.0
 duckdb==1.1.3
-ibis-framework[duckdb,geospatial]==10.0.0
+ibis-framework[duckdb,geospatial]==10.5.0

{starplot-0.15.6 → starplot-0.15.7}/src/starplot/__init__.py

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

{starplot-0.15.6 → starplot-0.15.7}/src/starplot/data/constellations.py

@@ -1,3 +1,5 @@
+from functools import cache
+
 import ibis
 from ibis import _
 
@@ -669,23 +671,35 @@ CONSTELLATION_HIP_IDS = {
 }
 
 
-def load(extent=None, filters=None):
-    filters = filters or []
+@cache
+def table():
     con = db.connect()
     c = con.table("constellations")
-    c = c.mutate(
+
+    return c.mutate(
         ra=_.center_ra,
         dec=_.center_dec,
         constellation_id=_.iau_id,
-        rowid=ibis.row_number(),
         boundary=_.geometry,
+        rowid=ibis.row_number(),
+        sk=ibis.row_number(),
     )
 
+
+def load(extent=None, filters=None, sql=None):
+    filters = filters or []
+    c = table()
+
     if extent:
         filters.append(_.geometry.intersects(extent))
 
     if filters:
-        return c.filter(*filters)
+        c = c.filter(*filters)
+
+    if sql:
+        result = c.alias("_").sql(sql).select("sk").execute()
+        skids = result["sk"].to_list()
+        c = c.filter(_.sk.isin(skids))
 
     return c
 

{starplot-0.15.6 → starplot-0.15.7}/src/starplot/data/dsos.py

@@ -1,3 +1,5 @@
+from functools import cache
+
 import ibis
 from ibis import _
 
@@ -25,26 +27,37 @@ class DsoLabelMaker(dict):
 DSO_LABELS_DEFAULT = DsoLabelMaker()
 
 
-def load(extent=None, filters=None):
-    filters = filters or []
+@cache
+def table():
     con = db.connect()
     dsos = con.table("deep_sky_objects")
 
-    dsos = dsos.mutate(
+    return dsos.mutate(
         ra=_.ra_degrees,
         dec=_.dec_degrees,
         constellation_id=_.constellation,
         magnitude=ibis.coalesce(_.mag_v, _.mag_b, None),
         size=_.size_deg2,
         rowid=ibis.row_number(),
+        sk=ibis.row_number(),
     )
 
+
+def load(extent=None, filters=None, sql=None):
+    filters = filters or []
+    dsos = table()
+
     if extent:
         dsos = dsos.filter(_.geometry.intersects(extent))
 
     filters.extend([_.ra_degrees.notnull() & _.dec_degrees.notnull()])
 
     if filters:
-        return dsos.filter(*filters)
+        dsos = dsos.filter(*filters)
+
+    if sql:
+        result = dsos.alias("_").sql(sql).select("sk").execute()
+        skids = result["sk"].to_list()
+        dsos = dsos.filter(_.sk.isin(skids))
 
     return dsos

{starplot-0.15.6 → starplot-0.15.7}/src/starplot/data/stars.py

@@ -459,7 +459,7 @@ class StarCatalog:
 
 
 @cache
-def read_catalog(catalog: StarCatalog = StarCatalog.BIG_SKY_MAG11, table_name="stars"):
+def table(catalog: StarCatalog = StarCatalog.BIG_SKY_MAG11, table_name="stars"):
     con = db.connect()
 
     if catalog == StarCatalog.BIG_SKY_MAG11:
@@ -481,6 +481,7 @@ def read_catalog(catalog: StarCatalog = StarCatalog.BIG_SKY_MAG11, table_name="s
         # stars parquet does not have geometry field
         geometry=_.ra_degrees.point(_.dec_degrees),
         rowid=ibis.row_number(),
+        sk=ibis.row_number(),
     )
 
     stars = stars.join(
@@ -495,14 +496,24 @@ def read_catalog(catalog: StarCatalog = StarCatalog.BIG_SKY_MAG11, table_name="s
     return stars
 
 
-def load(extent=None, catalog: StarCatalog = StarCatalog.BIG_SKY_MAG11, filters=None):
+def load(
+    extent=None,
+    catalog: StarCatalog = StarCatalog.BIG_SKY_MAG11,
+    filters=None,
+    sql=None,
+):
     filters = filters or []
-    stars = read_catalog(catalog)
+    stars = table(catalog)
 
     if extent:
         stars = stars.filter(stars.geometry.intersects(extent))
 
     if filters:
-        return stars.filter(*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