starplot 0.15.8__tar.gz → 0.16.1__tar.gz

{starplot-0.15.8 → starplot-0.16.1}/CITATION.cff

@@ -20,5 +20,5 @@ keywords:
   - graphs
   - plotting
 license: MIT
-version: 0.15.6
-date-released: '2025-03-30'
+version: 0.16.1
+date-released: '2025-09-06'

{starplot-0.15.8 → starplot-0.16.1}/CONTRIBUTING.md

@@ -1,14 +1,12 @@
 # Contributing to Starplot
 
-_Work in progress_
-
 ## Ways to Contribute
 
 There are many ways to contribute to Starplot:
 
 - Fix typos or clarify documentation
 - Find and fix bugs
-- Implement a feature on the [roadmap](https://starplot.notion.site/aaa0dd71c17943f89850c9a8c43ade50)
+- Implement a feature on the [roadmap](https://trello.com/b/sUksygn4/starplot-roadmap)
 - Propose a new feature by [opening an issue](https://github.com/steveberardi/starplot/issues)
 
 
@@ -41,7 +39,11 @@ When you're new to a codebase it's usually good to start by just checking out th
 There are also a few other `make` commands that are useful when developing locally:
 
 - `make scratchpad` will run `scripts/scratchpad.py` inside the docker container. The `scratchpad.py` file is not checked in to the repo (so you'll have to create it on your machine), but it's a way to run code with the current state of Starplot on your machine -- very helpful when trying things out.
+- `make profile` will run `scripts/scratchpad.py` through Python's [built-in profiler](https://docs.python.org/3/library/profile.html#module-cProfile) and then start a [snakeviz](https://jiffyclub.github.io/snakeviz/) webserver locally to let you explore the call stack and see runtimes of everything. This can be very helpful when trying to find bottlenecks in code.
 - `make shell` will open a Python shell on the Docker container
+- `make format` will format the code with our standard formatter
+- `make lint` will check for lint (e.g. unused imports) and `make lint ARGS=--fix` can usually autofix things
+- `make docs-serve` will build the docs and start a local webserver for them
 
 ## Tests
 
@@ -62,7 +64,6 @@ Starplot also has a collection of "hash checks" (located in `hash_checks`). Each
 
 These hash checks help test things that are hard (or extremely tedious) to test. As a graphics library, Starplot has a LOT of possible uses and output so the hash checks help make some testing easier to manage.
 
-_Work in progress_
 
 ## Code of Conduct
 

{starplot-0.15.8 → starplot-0.16.1}/Dockerfile

@@ -1,10 +1,5 @@
 ARG PYTHON_VERSION=3.11.11
-FROM python:${PYTHON_VERSION}-bookworm AS base
-
-WORKDIR /starplot
-
-# ---------------------------------------------------------------------
-FROM base AS dev
+FROM python:${PYTHON_VERSION}-bookworm
 
 WORKDIR /starplot
 

{starplot-0.15.8 → starplot-0.16.1}/Makefile

@@ -16,7 +16,7 @@ endif
 DOCKER_RUN=docker run --rm $(DR_ARGS) -v $(shell pwd):/starplot starplot-dev bash -c
 DOCKER_BUILDER=starplot-builder
 
-DOCKER_BUILD_PYTHON=docker build -t starplot-$(PYTHON_VERSION) $(DOCKER_BUILD_ARGS) --build-arg="PYTHON_VERSION=$(PYTHON_VERSION)" --target dev .
+DOCKER_BUILD_PYTHON=docker build -t starplot-$(PYTHON_VERSION) $(DOCKER_BUILD_ARGS) --build-arg="PYTHON_VERSION=$(PYTHON_VERSION)" .
 DOCKER_RUN_PYTHON_TEST=docker run --rm $(DR_ARGS) starplot-$(PYTHON_VERSION)
 
 export PYTHONPATH=./src/
@@ -28,10 +28,6 @@ build:
 	touch -a .env
 	$(DOCKER_BUILD_PYTHON)
 
-docker-multi-arch:
-	docker buildx inspect $(DOCKER_BUILDER) && echo "Builder already exists!" || docker buildx create --name $(DOCKER_BUILDER) --bootstrap --use
-	docker buildx build --push --platform linux/arm64/v8,linux/amd64 --tag sberardi/starplot-base:latest --target base .
-
 lint:
 	$(DOCKER_RUN) "ruff check src/ tests/ hash_checks/ $(ARGS)"
 

{starplot-0.15.8 → starplot-0.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: starplot
-Version: 0.15.8
+Version: 0.16.1
 Summary: Star charts and maps of the sky
 Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
 Author-email: Steve Berardi <hello@steveberardi.com>
@@ -14,7 +14,8 @@ License-File: LICENSE
 Requires-Dist: matplotlib >= 3.8.0
 Requires-Dist: numpy >= 1.26.2
 Requires-Dist: pandas >= 1.4.0
-Requires-Dist: pydantic >= 2.0.3
+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
@@ -25,7 +26,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.1.3
 Requires-Dist: ibis-framework[duckdb, geospatial] < 11
 Project-URL: Documentation, https://starplot.dev
 Project-URL: Home, https://starplot.dev
@@ -65,18 +66,23 @@ To create a star chart for tonight's sky as seen from [Palomar Mountain](https:/
 
 ```python
 from datetime import datetime
-from pytz import timezone
-import starplot as sp
+from zoneinfo import ZoneInfo
 
-tz = timezone("America/Los_Angeles")
+from starplot import ZenithPlot, Observer, styles, _
 
-p = sp.MapPlot(
-    projection=sp.Projection.ZENITH,
+tz = ZoneInfo("America/Los_Angeles")
+dt = datetime.now(tz).replace(hour=22)
+
+observer = Observer(
+    dt=dt,
     lat=33.363484,
     lon=-116.836394,
-    dt=datetime.now(tz).replace(hour=22),
-    style=sp.styles.PlotStyle().extend(
-        sp.styles.extensions.BLUE_MEDIUM,
+)
+
+p = ZenithPlot(
+    observer=observer,
+    style=styles.PlotStyle().extend(
+        styles.extensions.BLUE_MEDIUM,
     ),
     resolution=4096,
     autoscale=True,
@@ -84,6 +90,7 @@ p = sp.MapPlot(
 p.constellations()
 p.stars(where=[_.magnitude < 4.6])
 p.constellation_labels()
+p.horizon()
 p.export("starchart.png")
 ```
 

{starplot-0.15.8 → starplot-0.16.1}/README.md

@@ -32,18 +32,23 @@ To create a star chart for tonight's sky as seen from [Palomar Mountain](https:/
 
 ```python
 from datetime import datetime
-from pytz import timezone
-import starplot as sp
+from zoneinfo import ZoneInfo
 
-tz = timezone("America/Los_Angeles")
+from starplot import ZenithPlot, Observer, styles, _
 
-p = sp.MapPlot(
-    projection=sp.Projection.ZENITH,
+tz = ZoneInfo("America/Los_Angeles")
+dt = datetime.now(tz).replace(hour=22)
+
+observer = Observer(
+    dt=dt,
     lat=33.363484,
     lon=-116.836394,
-    dt=datetime.now(tz).replace(hour=22),
-    style=sp.styles.PlotStyle().extend(
-        sp.styles.extensions.BLUE_MEDIUM,
+)
+
+p = ZenithPlot(
+    observer=observer,
+    style=styles.PlotStyle().extend(
+        styles.extensions.BLUE_MEDIUM,
     ),
     resolution=4096,
     autoscale=True,
@@ -51,6 +56,7 @@ p = sp.MapPlot(
 p.constellations()
 p.stars(where=[_.magnitude < 4.6])
 p.constellation_labels()
+p.horizon()
 p.export("starchart.png")
 ```
 

{starplot-0.15.8 → starplot-0.16.1}/data/raw/constellation_borders.json

@@ -4,11 +4,13 @@
 "crs": { "type": "name", "properties": { "name": "urn:ogc:def:crs:OGC:1.3:CRS84" } },
 "features": [
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 344.4653, 35.1682 ], [ 344.3429, 53.168 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 344.3429, 53.168 ], [ 351.4529, 53.187 ], [ 351.4657, 50.687 ], [ 355.2706, 50.6929 ], [ 355.2761, 48.6929 ], [ 4.1464, 48.6949 ], [ 4.1433, 46.6949 ], [ 14.7761, 46.6758 ], [ 14.7889, 48.6757 ], [ 18.5884, 48.6633 ], [ 18.6059, 50.6632 ], [ 22.4079, 50.6479 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 344.3429, 53.168 ], [ 351.4529, 53.187 ], [ 351.4657, 50.687 ], [ 355.2706, 50.6929 ], [ 355.2761, 48.6929 ], [ 360, 48.6929 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 0, 48.6949 ], [ 4.1464, 48.6949 ], [ 4.1433, 46.6949 ], [ 14.7761, 46.6758 ], [ 14.7889, 48.6757 ], [ 18.5884, 48.6633 ], [ 18.6059, 50.6632 ], [ 22.4079, 50.6479 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 22.4079, 50.6479 ], [ 26.9685, 50.6257 ], [ 26.9314, 47.6258 ], [ 32.6215, 47.5928 ], [ 32.6738, 51.0926 ], [ 39.8855, 51.0424 ], [ 39.6793, 37.2932 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 39.6793, 37.2932 ], [ 31.8711, 37.3471 ], [ 31.8543, 35.5971 ], [ 22.9108, 35.6453 ], [ 22.8974, 33.6454 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 22.8974, 33.6454 ], [ 12.4431, 33.6819 ], [ 12.4135, 24.4319 ], [ 14.4241, 24.4266 ], [ 14.4148, 21.6766 ], [ 3.7399, 21.6952 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 3.7399, 21.6952 ], [ 3.7406, 22.6952 ], [ 2.61, 22.6958 ], [ 2.6128, 28.6958 ], [ 1.6062, 28.696 ], [ 1.607, 32.0294 ], [ 357.8287, 32.0285 ], [ 357.8281, 32.7785 ], [ 354.0492, 32.7746 ], [ 354.0442, 35.1913 ], [ 344.4653, 35.1682 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 3.7399, 21.6952 ], [ 3.7406, 22.6952 ], [ 2.61, 22.6958 ], [ 2.6128, 28.6958 ], [ 1.6062, 28.696 ], [ 1.607, 32.0294 ], [ 0, 32.0294 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 360, 32.0285 ], [ 357.8287, 32.0285 ], [ 357.8281, 32.7785 ], [ 354.0492, 32.7746 ], [ 354.0442, 35.1913 ], [ 344.4653, 35.1682 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 141.9043, -24.5425 ], [ 141.7716, -37.292 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 141.7716, -37.292 ], [ 141.7341, -40.2919 ], [ 166.4565, -40.4246 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 166.4565, -40.4246 ], [ 166.4794, -35.6747 ] ] } },
@@ -101,7 +103,8 @@
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 135.2437, -75.4955 ], [ 169.857, -75.684 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 169.857, -75.684 ], [ 170.0848, -64.6843 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 344.3429, 53.168 ], [ 344.304, 56.918 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 344.304, 56.918 ], [ 344.2691, 59.7512 ], [ 348.8597, 59.7647 ], [ 348.8165, 63.6813 ], [ 355.2176, 63.6929 ], [ 355.1979, 66.6929 ], [ 6.7638, 66.6924 ], [ 6.9229, 77.6923 ], [ 55.3087, 77.4163 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 344.304, 56.918 ], [ 344.2691, 59.7512 ], [ 348.8597, 59.7647 ], [ 348.8165, 63.6813 ], [ 355.2176, 63.6929 ], [ 355.1979, 66.6929 ], [ 360, 66.6929 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 0, 66.6924 ], [ 6.7638, 66.6924 ], [ 6.9229, 77.6923 ], [ 55.3087, 77.4163 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 48.9009, 57.4685 ], [ 38.7623, 57.5513 ], [ 38.8024, 59.0512 ], [ 30.7956, 59.1046 ], [ 30.7736, 58.1047 ], [ 27.5952, 58.1227 ], [ 27.5336, 54.6229 ], [ 22.456, 54.6478 ], [ 22.4079, 50.6479 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 166.4565, -40.4246 ], [ 166.3373, -57.1744 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 170.0848, -64.6843 ], [ 179.0574, -64.6958 ] ] } },
@@ -113,14 +116,17 @@
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 225.6308, -29.9949 ], [ 190.4174, -30.1864 ], [ 190.4272, -33.6864 ], [ 185.3874, -33.6939 ], [ 185.3903, -35.6939 ], [ 180.0, -35.6747 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 180.0, -35.6747 ], [ 166.4794, -35.6747 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 300.5733, 59.8511 ], [ 300.4852, 61.8506 ], [ 306.8119, 61.9144 ], [ 306.5174, 67.413 ], [ 310.334, 67.449 ], [ 309.573, 75.4455 ], [ 301.8734, 75.3709 ], [ 300.6738, 80.3648 ], [ 313.7059, 80.4868 ], [ 308.721, 86.4656 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 308.721, 86.4656 ], [ 308.3314, 86.6306 ], [ 343.5107, 86.8369 ], [ 339.261, 88.6639 ], [ 0.9483, 88.6092 ], [ 24.7077, 88.3564 ], [ 57.6647, 88.0063 ], [ 135.8325, 87.5689 ], [ 130.4028, 86.0975 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 308.721, 86.4656 ], [ 308.3314, 86.6306 ], [ 343.5107, 86.8369 ], [ 339.261, 88.6639 ], [ 360, 88.6639 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 0, 88.6092 ], [ 0.9483, 88.6092 ], [ 24.7077, 88.3564 ], [ 57.6647, 88.0063 ], [ 135.8325, 87.5689 ], [ 130.4028, 86.0975 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 344.304, 56.918 ], [ 335.9109, 56.8826 ], [ 335.9313, 55.6326 ], [ 333.1376, 55.6178 ], [ 333.1747, 53.3679 ], [ 330.6392, 53.3533 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 330.6392, 53.3533 ], [ 330.6022, 55.4365 ], [ 309.8314, 55.2753 ], [ 309.6238, 61.3577 ], [ 308.6608, 61.3486 ], [ 308.7166, 59.9322 ], [ 300.5733, 59.8511 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 359.1033, -6.3042 ], [ 6.5927, -6.3075 ], [ 6.6013, 0.6925 ], [ 6.6038, 2.6925 ], [ 31.6153, 2.5979 ], [ 31.6652, 10.5144 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 359.1033, -6.3042 ], [ 360, -6.3042 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 0, -6.3075 ], [ 6.5927, -6.3075 ], [ 6.6013, 0.6925 ], [ 6.6038, 2.6925 ], [ 31.6153, 2.5979 ], [ 31.6652, 10.5144 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 50.9464, 10.3632 ], [ 50.853, 0.447 ], [ 50.8367, -1.303 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 50.8367, -1.303 ], [ 41.3392, -1.221 ], [ 41.1488, -23.8536 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 41.1488, -23.8536 ], [ 26.466, -23.7563 ], [ 26.4589, -24.8729 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 26.4589, -24.8729 ], [ 359.1106, -24.8042 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 41.1488, -23.8536 ], [ 26.466, -23.7563 ], [ 26.4589, -24.8042 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 0, -24.8042 ], [ 26.4589, -24.8042 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 359.1106, -24.8042 ], [ 360, -24.8042 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 111.6521, -82.7759 ], [ 180.0, -83.0 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 180.0, -83.0 ], [ 209.1111, -83.1201 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 207.7814, -75.6236 ], [ 180.0, -75.684 ] ] } },
@@ -245,7 +251,8 @@
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 232.5499, -60.4355 ], [ 249.0347, -60.2645 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 248.5706, -45.7671 ], [ 248.4948, -42.2675 ], [ 242.1528, -42.3367 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 274.1951, -74.9745 ], [ 323.1848, -74.4545 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 351.9978, -74.3125 ], [ 1.5663, -74.304 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 351.9978, -74.304 ], [ 360, -74.304 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 0, -74.304 ], [ 1.5663, -74.304 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 240.387, -3.6026 ], [ 245.6384, -3.5462 ], [ 245.6026, -0.2964 ], [ 245.5586, 3.7034 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 281.4586, 6.3792 ], [ 275.2746, 6.3048 ], [ 275.296, 4.5549 ], [ 277.9211, 4.5866 ], [ 277.9392, 3.0867 ], [ 275.3142, 3.055 ], [ 275.3506, 0.0552 ], [ 269.101, -0.0206 ], [ 269.1497, -4.0204 ], [ 271.1497, -3.9961 ], [ 271.2237, -9.9956 ], [ 266.7238, -10.0502 ], [ 266.7447, -11.7168 ], [ 265.4944, -11.7319 ], [ 265.4735, -10.0654 ], [ 259.2221, -10.1404 ], [ 259.2974, -16.14 ], [ 265.8002, -16.0619 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 265.8002, -16.0619 ], [ 266.0018, -30.0607 ] ] } },
@@ -253,11 +260,14 @@
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 70.8524, 0.2375 ], [ 71.034, 15.7365 ], [ 76.2889, 15.6755 ], [ 76.2953, 16.1755 ], [ 81.7987, 16.1101 ], [ 81.7922, 15.6101 ], [ 85.7936, 15.5619 ], [ 85.7551, 12.5622 ], [ 88.2554, 12.5319 ], [ 88.3272, 18.0314 ], [ 87.327, 18.0435 ], [ 87.3938, 22.8765 ], [ 90.144, 22.8431 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 307.4588, -56.5886 ], [ 272.6723, -56.9838 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 317.1788, 20.0046 ], [ 320.1884, 20.0291 ], [ 320.1517, 24.0289 ], [ 322.662, 24.0482 ], [ 322.6202, 28.5481 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 3.7399, 21.6952 ], [ 3.7341, 13.1952 ], [ 1.6032, 13.196 ], [ 1.6027, 10.696 ], [ 359.0971, 10.6958 ], [ 359.098, 8.1958 ], [ 342.8214, 8.1622 ], [ 342.8422, 2.6622 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 3.7399, 21.6952 ], [ 3.7341, 13.1952 ], [ 1.6032, 13.196 ], [ 1.6027, 10.696 ], [ 0, 10.696 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 360, 10.6958 ], [ 359.0971, 10.6958 ], [ 359.098, 8.1958 ], [ 342.8214, 8.1622 ], [ 342.8422, 2.6622 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 42.6284, 31.1865 ], [ 42.6665, 34.5197 ], [ 40.4024, 34.5375 ], [ 40.4347, 37.2874 ], [ 39.6793, 37.2932 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 69.4869, 30.9219 ], [ 52.4267, 31.1004 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 351.7685, -56.3127 ], [ 351.7784, -57.8127 ], [ 21.2062, -57.8484 ] ] } },
-{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 26.3507, -39.3726 ], [ 0.6029, -39.3039 ], [ 351.6927, -39.3128 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 351.7685, -56.3127 ], [ 351.7784, -57.8484 ], [ 360, -57.8484 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 0, -57.8484 ], [ 21.2062, -57.8484 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 26.3507, -39.3726 ], [ 0.6029, -39.3128 ], [ 0, -39.3128 ] ] } },
+{ "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 351.6927, -39.3128 ], [ 360, -39.3128 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 98.9372, -64.107 ], [ 102.7033, -64.1519 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 90.7489, -50.7545 ], [ 90.9518, -43.0058 ] ] } },
 { "type": "Feature", "properties": { }, "geometry": { "type": "LineString", "coordinates": [ [ 22.8974, 33.6454 ], [ 22.8664, 28.6454 ], [ 26.7647, 28.6263 ], [ 26.7447, 25.6263 ] ] } },

{starplot-0.15.8 → starplot-0.16.1}/docs/about.md

@@ -4,7 +4,7 @@
 
 👷 **Work In Progress** 🚧 Starplot is still very much a work in progress, and under active development. We try to follow [semantic versioning](https://semver.org/), which means that [_anything_ can change between versions before `1.0.0`](https://semver.org/#spec-item-4).
 
-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!
+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 (2026+). 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!
 
 --8<-- "docs/snippets/_newsletter.html"
 

{starplot-0.15.8 → starplot-0.16.1}/docs/changelog.md

@@ -1,4 +1,24 @@
+## v0.16.x
+[Migration Guide](migration-guides/0.16.0.md)
+
+- Adds support for gradient backgrounds
+- Refactors projections, allowing you to change central RA/DEC
+- Adds equidistant and oblique Mercator projections
+- Introduces an Observer model to encapsulate a time and place
+- Makes zenith plots a separate plot type
+- Adds a function for plotting a star magnitude scale (experimental, feedback wanted!)
+- Adds more location options for legends and allows separate X/Y padding
+- Adds a `settings` class for managing global settings
+- Adds a global setting for how text is rendered in SVG exports
+- Adds more options for plotting gridlines on horizon plots
+- Adds a `common_names` field to deep sky objects
+- Added more public properties to plots (including `magnitude_range` and `alt`/`az` for optic plots)
+- 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.15.x
+[Documentation](https://archives.starplot.dev/0.15.8/)
+
 - Replaces data backend with DuckDB + Ibis, making plotting 2-3x faster and object lookup up to 10x faster
 - Changes default unit of right ascension to degrees (0...360)
 - Improves performance of constellation label placement

starplot-0.16.1/docs/coming-soon.md

@@ -0,0 +1,66 @@
+<table class="table-coming-soon">
+
+    
+ 
+    <tr>
+        <td>v0.17</td>
+
+        <td>
+            <h4>⭐ Next Release ⭐</h4>
+            <ul>
+                <li>Custom star catalogs</li>
+                <li>Custom sky cultures (constellations, star names)</li>
+            </ul>
+
+        </td>
+        <td></td>
+    </tr>
+
+
+    <tr>
+        <td>v0.18</td>
+
+        <td>
+            <ul>
+                <li>Support for more coordinate systems</li>
+            </ul>
+
+        </td>
+
+        <td></td>
+
+    </tr>
+
+    <tr>
+        <td>v0.18+</td>
+
+        <td>
+            <ul>
+                <li>Planet moons</li>
+                <li>Comet model</li>
+                <li>Area-based labeling</li>
+                <li>Improved line labeling</li>
+            </ul>
+
+        </td>
+
+        <td></td>
+
+    </tr>
+
+    <tr class="blue-box">
+        <td colspan="3">
+        <em>See more details on the <a href="https://trello.com/b/sUksygn4/starplot-roadmap">Public Roadmap</a> 🚀 </em>
+        </td>
+    </tr>
+</table>
+
+**Help us launch these features sooner by [becoming a contributor](https://github.com/steveberardi/starplot/blob/main/CONTRIBUTING.md)!**
+
+<br/>
+
+--8<-- "docs/snippets/_newsletter.html"
+
+<br/>
+<br/>
+<br/>

{starplot-0.15.8 → starplot-0.16.1}/docs/css/extra.css

@@ -5,8 +5,6 @@
     --md-primary-fg-color--light: hsl(209, 53%, 70%);
     --md-primary-bg-color--light: hsl(209, 78%, 90%);
     --md-primary-fg-color--dark:  hsl(209, 53%, 27%);
-
-    /* --md-accent-fg-color: hsl(209, 73%, 47%); */
 }
 
 .md-typeset h1,
@@ -20,16 +18,25 @@
 }
 
 .doc-heading {
-    padding-top: 0rem;
+    display: flex;
+    align-items: center;
+}
+
+.doc-heading span {
+    margin-left: 8px;
 }
 
 .doc-heading code {
-    padding: 0.5rem;
-    width: 100%;
-    display: inline-block;
     font-weight: 600;
 }
 
+code.doc-symbol {
+    border-radius: 8px;
+    font-size: 0.6em;
+    padding: 2px 6px;
+    margin: 6px 4px;
+}
+
 .fg-primary {
     color: var(--md-primary-fg-color);
 }
@@ -76,6 +83,8 @@
 }
 
 [data-md-color-scheme=default] {
+    --doc-symbol-class-bg-color: hsl(209, 74%, 90%);
+
     .doc-function .doc-heading {
         background-color: hsl(209, 53%, 81%);
     }
@@ -90,6 +99,9 @@
     }
 }
 [data-md-color-scheme=slate] {
+
+    --md-typeset-a-color: hsl(209, 63%, 65%);
+
     .doc-function .doc-heading {
         background-color: hsl(209, 53%, 21%);
     }
@@ -349,10 +361,10 @@ code.raw {
 }
 
 .tutorial-top-nav {
-    border-top: 1px solid #c6c6c6;
-    border-bottom: 1px solid #c6c6c6;
-    padding: 8px 10px;
-    margin-bottom: 12px;
+    border: 1px solid hsl(216, 50%, 84%);
+    border-radius: 8px;
+    padding: 10px 14px;
+    margin-bottom: 28px;
 
     background-color: var(--doc-symbol-class-bg-color);
     p {
@@ -501,3 +513,46 @@ td[data-column-id=bayer] {
         grid-template-columns: 1fr 3fr;
     }
 }
+
+.blue-box {
+    /* border: 1px solid hsl(216, 50%, 84%); */
+    border-radius: 8px;
+    padding: 20px 24px;
+    margin-bottom: 40px;
+    background-color: rgba(143, 181, 255, 0.15);
+    font-size: 1.25em;
+}
+
+.table-coming-soon {
+    background-color: var(--md-default-bg-color);
+    border: 1px solid hsl(209, 53%, 56%) !important;
+    border-radius: 10px;
+    border-collapse: collapse;
+    display: inline-block;
+    max-width: 100%;
+    overflow: auto;
+    touch-action: auto;
+
+    tr {
+        border-top: 1px solid hsl(209, 53%, 56%) !important;
+    }
+
+    tr:first-child {
+        border-top: none !important;
+    }
+
+    tr:last-child {
+        border-bottom: none !important;
+        border-left: none !important;
+        border-right: none !important;
+    }
+
+    td {
+        /* border-top: 1px solid hsl(209, 53%, 56%) !important; */
+        padding: 8px 16px;
+    }
+
+    ul, h4 {
+        margin-top: 0;
+    }
+}

starplot-0.16.1/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.16.1/docs/examples/horizon-gradient.md

@@ -0,0 +1,16 @@
+---
+title: Horizon Gradient
+---
+[:octicons-arrow-left-24: Back to Examples](/examples)
+
+# Horizon Gradient {.example-header}
+
+![horizon-gradient](/images/examples/horizon_gradient.png)
+
+This plot shows what was in the sky when looking south from Stonehaugh, England on July 26, 2025 at 11pm BST. A color gradient has been applied for visual effect.
+
+Learn more about using gradient backgrounds by reading the docs on the [style's background color](/reference-styling/#starplot.PlotStyle.background_color).
+
+```python
+--8<-- "examples/horizon_gradient.py"
+```

{starplot-0.15.8 → starplot-0.16.1}/docs/examples/map-big-dipper.md

@@ -1,9 +1,9 @@
 ---
-title: Map of the Big Dipper with Custom Markers
+title: The Big Dipper with Custom Markers
 ---
 [:octicons-arrow-left-24: Back to Examples](/examples)
 
-# Map of the Big Dipper with Custom Markers {.example-header}
+# The Big Dipper with Custom Markers {.example-header}
 
 ![map-big-dipper](/images/examples/map_big_dipper.png)
 

starplot-0.16.1/docs/examples/map-carina-nebula.md

@@ -0,0 +1,15 @@
+---
+title: Carina Nebula + Clusters
+---
+[:octicons-arrow-left-24: Back to Examples](/examples)
+
+# Carina Nebula + Clusters {.example-header}
+
+![map-carina](/images/examples/map_carina.png)
+
+
+```python
+--8<-- "examples/map_carina.py"
+```
+
+

starplot-0.16.1/docs/examples/map-cassiopeia.md

@@ -0,0 +1,12 @@
+---
+title: Map of Cassiopeia
+---
+[:octicons-arrow-left-24: Back to Examples](/examples)
+
+# Map of Cassiopeia {.example-header}
+
+![map-cas](/images/examples/map_cas.png)
+
+```python
+--8<-- "examples/map_cas.py"
+```

{starplot-0.15.8 → starplot-0.16.1}/docs/examples/map-milky-way-stars.md

@@ -1,9 +1,9 @@
 ---
-title: Stars of the Milky Way
+title: The Milky Way
 ---
 [:octicons-arrow-left-24: Back to Examples](/examples)
 
-# Stars of the Milky Way {.example-header}
+# The Milky Way {.example-header}
 
 ![map-milky-way-stars](/images/examples/map_milky_way_stars.png)
 

{starplot-0.15.8 → starplot-0.16.1}/docs/examples/star-chart-detail.md

@@ -8,7 +8,7 @@ title: Star Chart with More Detail
 
 ![zenith-coma](/images/examples/star_chart_detail.png)
 
-Building on the first example, you can also plot additional objects and even customize their style. Here's an example that plots a bunch of extra stuff (including the Milky Way, constellation borders, Deep Sky Objects, and more). It also demonstrates how you can plot your own markers, like the dashed yellow circle around the [Coma Star Cluster](https://en.wikipedia.org/wiki/Coma_Star_Cluster) (Melotte 111):
+Building on the first example, you can also plot additional objects and even customize their style. Here's an example that plots a bunch of extra stuff (including the Milky Way, ecliptic, Deep Sky Objects, and more). It also demonstrates how you can plot your own markers, like the dashed yellow circle around the [Coma Star Cluster](https://en.wikipedia.org/wiki/Coma_Star_Cluster) (Melotte 111):
 
 ```python
 --8<-- "examples/star_chart_detail.py"