starplot 0.21.4__tar.gz → 0.22.0__tar.gz

{starplot-0.21.4 → starplot-0.22.0}/.github/workflows/test.yml

@@ -19,7 +19,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+        python-version: ['3.11', '3.12', '3.13', '3.14']
     steps:
     - uses: actions/checkout@v6
     - uses: astral-sh/setup-uv@bec219d24cd3e171d82865faccec33120bb574f4 # v10.1.0

{starplot-0.21.4 → starplot-0.22.0}/CITATION.cff

@@ -20,5 +20,5 @@ keywords:
   - graphs
   - plotting
 license: MIT
-version: 0.21.4
-date-released: '2026-10-12'
+version: 0.22.0
+date-released: '2026-10-17'

{starplot-0.21.4 → starplot-0.22.0}/Makefile

@@ -101,11 +101,6 @@ dev: env db setup download-test-fonts
 # ------------------------------------------------------------------
 # Python version testing
 # ------------------------------------------------------------------
-test-3.10: PYTHON_VERSION=3.10.21
-test-3.10:
-	$(DOCKER_BUILD_PYTHON)
-	$(DOCKER_RUN_PYTHON_TEST)
-
 test-3.11: PYTHON_VERSION=3.11.16
 test-3.11:
 	$(DOCKER_BUILD_PYTHON)

{starplot-0.21.4 → starplot-0.22.0}/PKG-INFO

@@ -1,14 +1,13 @@
 Metadata-Version: 2.4
 Name: starplot
-Version: 0.21.4
+Version: 0.22.0
 Summary: Star charts and maps of the sky
 Keywords: astronomy,stars,charts,maps,constellations,sky,plotting
 Author-email: Steve Berardi <steve@starplot.dev>
-Requires-Python: >=3.10,<3.15
+Requires-Python: >=3.11,<3.15
 Description-Content-Type: text/markdown
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/de/constellation_names.csv

@@ -64,7 +64,9 @@ peg,Pegasus,Pegasus
 per,Perseus,Perseus
 phe,Phoenix,Phönix
 pic,Pictor,Maler
+psc,Pisces,Fische
 psa,Piscis Austrinus,Südlicher Fisch
+psc,Pisces,Fische
 pup,Puppis,Achterdeck des Schiffes
 pyx,Pyxis,Schiffskompass
 ret,Reticulum,Netz
@@ -86,4 +88,4 @@ umi,Ursa Minor,Kleiner Bär
 vel,Vela,Segel des Schiffes
 vir,Virgo,Jungfrau
 vol,Volans,Fliegender Fisch
-vul,Vulpecula,Fuchs
+vul,Vulpecula,Fuchs

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/de/other_terms.csv

@@ -44,3 +44,4 @@ E (abbreviation for east),E (Abkürzung für Osten)
 S (abbreviation for south),S (Abkürzung für Süden)
 W (abbreviation for west),W (Abkürzung für Westen)
 Milky Way,Milchstraße
+Horizon,Horizont

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/en-us/other_terms.csv

@@ -43,4 +43,5 @@ N (abbreviation for north),N (abbreviation for north)
 E (abbreviation for east),E (abbreviation for east)
 S (abbreviation for south),S (abbreviation for south)
 W (abbreviation for west),W (abbreviation for west)
-Milky Way,Milky Way
+Milky Way,Milky Way
+Horizon,horizon

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/es/other_terms.csv

@@ -43,4 +43,5 @@ N (abbreviation for north),N (abreviatura para norte)
 E (abbreviation for east),E (abreviatura para este)
 S (abbreviation for south),S (abreviatura para sur)
 W (abbreviation for west),O (abreviatura para oeste)
-Milky Way,Vía Láctea
+Milky Way,Vía Láctea
+Horizon,horizonte

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/fa/other_terms.csv

@@ -44,3 +44,4 @@ E (abbreviation for east),ق
 S (abbreviation for south),ج
 W (abbreviation for west),غ
 Milky Way,کهکشان راه شیری
+Horizon,افق

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/fr/other_terms.csv

@@ -44,3 +44,4 @@ E (abbreviation for east),E
 S (abbreviation for south),S
 W (abbreviation for west),O
 Milky Way,Voie lactée
+Horizon,horizon

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/it/other_terms.csv

@@ -44,3 +44,4 @@ E (abbreviation for east),E
 S (abbreviation for south),S
 W (abbreviation for west),O
 Milky Way,Via Lattea
+Horizon,orizzonte

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/lt/constellation_names.csv

@@ -65,7 +65,7 @@ per,Perseus,Persėjas
 phe,Phoenix,Feniksas
 pic,Pictor,Dailidė
 psa,Piscis Austrinus,Pietų Žuvis
-psc,Pisces,Žuvys 
+psc,Pisces,Žuvys
 pup,Puppis,Laivagalis
 pyx,Pyxis,Kompasas
 ret,Reticulum,Tinklas

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/lt/other_terms.csv

@@ -44,3 +44,4 @@ E (abbreviation for east),R
 S (abbreviation for south),P
 W (abbreviation for west),V
 Milky Way,Paukščių Takas
+Horizon,horizontas

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/nl/other_terms.csv

@@ -44,3 +44,4 @@ E (abbreviation for east),O
 S (abbreviation for south),Z
 W (abbreviation for west),W
 Milky Way,Melkweg
+Horizon,horizon

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/zh-cn/other_terms.csv

@@ -44,3 +44,4 @@ E (abbreviation for east),东
 S (abbreviation for south),南
 W (abbreviation for west),西
 Milky Way,银河
+Horizon,地平线

{starplot-0.21.4 → starplot-0.22.0}/data/raw/translations/zh-tw/other_terms.csv

@@ -44,3 +44,4 @@ E (abbreviation for east),東
 S (abbreviation for south),南
 W (abbreviation for west),西
 Milky Way,銀河
+Horizon,地平線

{starplot-0.21.4 → starplot-0.22.0}/docs/changelog.md

@@ -1,5 +1,18 @@
+## v0.22.x
+[Documentation](https://archives.starplot.dev/0.22.0/)
+
+- Adds support for "naked eye" optic plots, increasing FOV limit to 60 degrees
+- Adds support for plotting constellations, gridlines, and horizon on optic plots
+- Updates default catalog for Milky Way
+- Adds missing German translation for Pisces
+- Fixes bug with grouping star label SVG elements
+- Adds a double border circle marker
+- Drops official support for Python 3.10 (EOL)
+
+---
+
 ## v0.21.x
-[Migration Guide](migration-guides/0.21.0.md)
+[Documentation](https://archives.starplot.dev/0.21.4/) | [Migration Guide](migration-guides/0.21.0.md)
 
 - Replaces the plotting backend (matplotlib + cartopy) with an SVG-first backend
 - Adds support for gradient backgrounds on markers, polygons, and the figure background

{starplot-0.21.4 → starplot-0.22.0}/docs/coming-soon.md

@@ -8,18 +8,19 @@
 
 <table class="table-coming-soon">
     <tr>
-        <td>v0.22</td>
+        <td>v0.23</td>
         <td>
             <h4>⭐ Next Release ⭐</h4>
             <ul>
                 <li>Plot definition files</li>
                 <li>CLI for creating plots</li>
+                <li>Improved labeling pipeline</li>
             </ul>
         </td>
         <td></td>
     </tr>
     <tr>
-        <td>v0.23+</td>
+        <td>v0.24+</td>
         <td>
             <ul>
                 <li>Planet moons</li>

{starplot-0.21.4 → starplot-0.22.0}/docs/installation.md

@@ -2,7 +2,7 @@
 
 Starplot is available on [PyPI](https://pypi.org/project/starplot/) and [Conda](https://anaconda.org/channels/conda-forge/packages/starplot/overview), and its dependencies have binary wheels for most operating systems, so installation should be easy. See below for details.
 
-Supported Python versions: 3.10 / 3.11 / 3.12 / 3.13 / 3.14
+Supported Python versions: 3.11 / 3.12 / 3.13 / 3.14
 
 <h3>1. Install Dependencies</h3>
 

{starplot-0.21.4 → starplot-0.22.0}/docs/models/index.md

@@ -49,6 +49,7 @@ Starplot has models to represent an observer and some of the objects you can plo
 ### :material-telescope: Optics
 
 - [Binoculars](optics.md#starplot.models.Binoculars)
+- [NakedEye](optics.md#starplot.models.NakedEye)
 - [Scope](optics.md#starplot.models.Scope)
 - [Refractor](optics.md#starplot.models.Refractor)
 - [Reflector](optics.md#starplot.models.Reflector)

{starplot-0.21.4 → starplot-0.22.0}/docs/models/optics.md

@@ -10,6 +10,14 @@ Optics are another set of models you instantiate directly when creating [OpticPl
         show_root_heading: true
         heading_level: 2
 
+::: starplot.models.NakedEye
+    options:
+        inherited_members: true
+        show_docstring_attributes: true
+        merge_init_into_class: true
+        show_root_heading: true
+        heading_level: 2
+
 ::: starplot.models.Scope
     options:
         inherited_members: true

{starplot-0.21.4 → starplot-0.22.0}/docs/scripts/markers.py

@@ -50,6 +50,7 @@ marker_styles = {
     "star_4": default_style,
     "star_8": default_style,
     "triangle": default_style,
+    "circle_double_border": default_style,
 }
 
 

{starplot-0.21.4 → starplot-0.22.0}/docs/styling/markers.md

@@ -88,6 +88,12 @@ Below are previews of all marker symbols available in Starplot. Many aspects of
 `satellite`{: .marker-symbol-name}
 </div>
 
+<div class="marker-symbol-card" markdown>
+![Circle Double Border](../images/reference/marker_circle_double_border.svg){ loading=lazy .marker-symbol-img}
+
+`circle_double_border`{: .marker-symbol-name}
+</div>
+
 </div>
 
 

{starplot-0.21.4 → starplot-0.22.0}/hash_checks/hashlock.yml

@@ -1,23 +1,23 @@
 galaxy_base:
-  dhash: 70cca2da9282c47070c482da92a2c87070cca2eaf292cc70
+  dhash: 70cca2ca9282c47070cca2ca92a2cc7070cca2c8d092cc70
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/galaxy-base.png
-  phash: 91074ef43b0b6cf4
+  phash: 91074ef83b236cdc
 horizon_base:
-  dhash: 9e86928a8eca8e0d8a86928a8eca8e0d8a86d68e8e8a8d0d
+  dhash: ba8e968a8eca8a0d9a8e968a8eca8e0d9a8ed68e8e8a8f0d
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/horizon-base.png
-  phash: c0953ac53ef00f7a
+  phash: c0953ac53ee10f7a
 horizon_gradient_background:
-  dhash: c17964b2b2b68e8ce179643232b68e8de168e4b2b2b28e8d
+  dhash: c57160b4b2b48e8ec571603432b49c8dc571e0b4b2b28e8d
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/horizon-gradient-background.png
-  phash: 944f62816ee43df4
+  phash: 944f62912ff416f2
 horizon_north_celestial_pole:
-  dhash: b89a8ab6acaab2a2a89a8ab2aeaab2a2b29a8ab2aaa2a0a2
+  dhash: b09a8ab6acaab2a2b29a8ab2aeaab2a2b29a8ab2aaa2a0a2
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/horizon-north-celestial-pole.png
-  phash: d5722b087edc2a63
+  phash: d5722a887edc2a63
 map_allow_all_collisions:
   dhash: 263693caa6b44a26263693caa6b44a26263793caa6344326
   exception: null
@@ -64,15 +64,15 @@ map_label_callables:
   filename: /Users/steveberardi/src/starplot/hash_checks/data/map-m45-label-callables.png
   phash: b232c9c94ee74ccc
 map_milky_way_multi_polygon:
-  dhash: 715f8b8cc8369426f11f8ba8c836942665539b88c8369426
+  dhash: 93cbe2f2ec6432da93cba2f2ec6632dac2c4b0d96c64129a
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/map-milky-way-multi-polygon.png
-  phash: bc833e9856524fe2
+  phash: 816079afb39c4c75
 map_mollweide:
-  dhash: 0b6b33632b32170f0b6b33632b32170f2b6b73632332170f
+  dhash: 0b6b33632b32170f0b6b33632b32170f2b6b73632332170b
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/map-mollweide.png
-  phash: abcab29ce3349463
+  phash: ebcab29ce3349461
 map_moon_phase_waxing_crescent:
   dhash: 8088b04848b088808088a04848a088808088804848808880
   exception: null
@@ -82,12 +82,12 @@ map_orion_base:
   dhash: 183939762e2d64681839395e2e2b646a5c39b9962e2f6468
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/map-orion-base.png
-  phash: be79d2649585b194
+  phash: be79d3649585a194
 map_orion_extra:
-  dhash: 1a1b39752e6d64684a1b39592e6b646a4a1bb99d2e2f6468
+  dhash: 1a1b39772b6d64680a1b395b2b6f646a4a1bb9962b2f6468
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/map-orion-extra.png
-  phash: bf717f6485869094
+  phash: bf715f648186909e
 map_plate_caree:
   dhash: 40928eccc44ca9ca02928eccc44ca88a82928e8cc4cca88a
   exception: null
@@ -172,7 +172,7 @@ optic_moon_phase_full:
   dhash: f0d48eb2b28ed4f0f0d48eb2b28ed4f0f0d48eb2b28ed4f0
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/optic-moon-phase-full.png
-  phash: 888a228a888a228a
+  phash: 9893339b9893339b
 optic_moon_phase_new:
   dhash: f0c0aaccccaac0f0f0c0aaccccaac0f0f0c0aaccccaac0f0
   exception: null
@@ -183,6 +183,11 @@ optic_moon_phase_waxing_crescent:
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/optic-moon-phase-waxing-crescent.png
   phash: 917646991b666e99
+optic_orion_naked_eye:
+  dhash: 64c4a2a092ccf07064d4a4a092ccf07060c4a2a092ccf070
+  exception: null
+  filename: /Users/steveberardi/src/starplot/hash_checks/data/optic-orion-naked-eye.png
+  phash: c46e0b957fca2499
 optic_orion_nebula_refractor:
   dhash: f0cca4f072e2ec70f0cca4f072e2ec70f0cca4f072e2ec70
   exception: null
@@ -204,17 +209,17 @@ optic_wrapping:
   filename: /Users/steveberardi/src/starplot/hash_checks/data/optic-wrapping.png
   phash: 91c446916bce39de
 zenith_base:
-  dhash: f0ccae868296ccf1f0ccae868e96ecf1f0dcae868696ecf1
+  dhash: f0ccae868296ecf1f0ccae868a96ecf1f0dcae868e96ecf1
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/zenith-base.png
-  phash: 90550b556b56787e
+  phash: 90570b556b56387e
 zenith_chinese:
   dhash: 96076359e4aac8718607417964aac8710607c2b8a496cc71
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/zenith-chinese.png
   phash: c46ecea41ed26987
 zenith_gradient:
-  dhash: 86035328f082c87186075329b08ac8710607d2a8a28ecc71
+  dhash: 86035328f082c87186075329b08ac8710607d2a8b29ecc71
   exception: null
   filename: /Users/steveberardi/src/starplot/hash_checks/data/zenith-gradient.png
   phash: c52e8ee41ec32d87

{starplot-0.21.4 → starplot-0.22.0}/hash_checks/map_checks.py

@@ -615,8 +615,8 @@ def check_map_milky_way_multi_polygon():
         projection=Miller(),
         ra_min=17.5 * 15,
         ra_max=19.5 * 15,
-        dec_min=-30,
-        dec_max=0,
+        dec_min=-10,
+        dec_max=10,
         style=STYLE,
         resolution=3000,
         scale=1.4,

{starplot-0.21.4 → starplot-0.22.0}/hash_checks/optic_checks.py

@@ -4,7 +4,16 @@ from zoneinfo import ZoneInfo
 
 from flaky import flake
 
-from starplot import Moon, Observer, OpticPlot, Satellite, _, callables, styles
+from starplot import (
+    Moon,
+    Observer,
+    OpticPlot,
+    Satellite,
+    Star,
+    _,
+    callables,
+    styles,
+)
 from starplot.models import optics
 
 HERE = Path(__file__).resolve().parent
@@ -27,6 +36,11 @@ style_blue = styles.PlotStyle().extend(
     styles.extensions.BLUE_DARK,
     styles.extensions.OPTIC,
 )
+style_night = styles.PlotStyle().extend(
+    styles.extensions.BLUE_NIGHT,
+    styles.extensions.GRADIENT_NIGHT,
+    styles.extensions.OPTIC,
+)
 
 POWAY = {"lat": 32.97, "lon": -117.038611}
 
@@ -449,3 +463,39 @@ def check_optic_iss_moon_transit():
     filename = DATA_PATH / "optic-iss-moon-transit.png"
     p.export(filename)
     return filename
+
+
+@flake
+def check_optic_orion_naked_eye():
+    observer = Observer(
+        dt=datetime(2025, 12, 21, 19, 0, 0, 0, tzinfo=tz),
+        lat=32.9628,  # Poway, CA
+        lon=-117.0359,
+    )
+    alnilam = Star.get(name="Alnilam")
+    p = OpticPlot(
+        # Orion's belt, rising in the east
+        ra=alnilam.ra,
+        dec=alnilam.dec,
+        optic=optics.NakedEye(),
+        observer=observer,
+        style=style_night,
+        resolution=2800,
+    )
+    p.gridlines()
+    p.constellations()
+    p.stars(
+        where=[_.magnitude < 3.5],
+        where_labels=[False],
+        color_fn=callables.color_by_bv_gradient,
+        size_fn=lambda s: callables.size_by_magnitude(s) * 0.8,
+    )
+    p.dsos(where=[_.magnitude < 4.1], where_labels=[False])
+    p.constellation_borders()
+    p.constellation_labels()
+    p.horizon()
+    p.info()
+
+    filename = DATA_PATH / "optic-orion-naked-eye.png"
+    p.export(filename)
+    return filename

{starplot-0.21.4 → starplot-0.22.0}/pyproject.toml

@@ -12,7 +12,6 @@ license = {file = "LICENSE"}
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -42,7 +41,7 @@ dependencies = [
     "pydantic-extra-types >= 2.11.1",
     "cairosvg >= 2.9.0",
 ]
-requires-python = ">=3.10,<3.15"
+requires-python = ">=3.11,<3.15"
 
 [project.urls]
 Home = "https://starplot.dev"

{starplot-0.21.4 → starplot-0.22.0}/src/starplot/__init__.py

@@ -2,7 +2,7 @@
 
 """Star charts and maps of the sky"""
 
-__version__ = "0.21.4"
+__version__ = "0.22.0"
 
 import contextlib
 
@@ -20,6 +20,7 @@ from .models import (
     DsoType,
     MilkyWay,
     Moon,
+    NakedEye,
     ObjectList,
     Observer,
     Planet,

{starplot-0.21.4 → starplot-0.22.0}/src/starplot/callables.py

@@ -90,6 +90,9 @@ def size_by_fov_factory(fov: float) -> Callable[[Star], float]:
     Args:
         fov: Field of view (in degrees)
     """
+    if fov > 20:
+        return size_by_magnitude
+
     fov_multiplier = 20 / fov
 
     return lambda s: size_by_magnitude(s) * fov_multiplier * 0.64

{starplot-0.21.4 → starplot-0.22.0}/src/starplot/constants.py

@@ -12,3 +12,5 @@ DE_421 = "de421.bsp"
 DE_440S = "de440s.bsp"
 DE_440 = "de440.bsp"
 DE_441 = "de441.bsp"
+
+EDGE_BUFFER = 1e-6

{starplot-0.21.4 → starplot-0.22.0}/src/starplot/data/catalogs.py

@@ -343,8 +343,8 @@ CONSTELLATION_BORDERS = Catalog(
 )
 
 MILKY_WAY = Catalog(
-    path=settings.data_path / "milky_way-0.1.0.parquet",
-    url="https://github.com/steveberardi/starplot-milkyway/releases/download/v0.1.0/milky_way.parquet",
+    path=settings.data_path / "milky_way-0.2.1.parquet",
+    url="https://github.com/steveberardi/starplot-milkyway/releases/download/v0.2.1/milky_way-0.2.1.parquet",
 )
 
 

{starplot-0.21.4 → starplot-0.22.0}/src/starplot/data/translations.py

@@ -45,6 +45,7 @@ LABELS = {
         "s": "s",
         "w": "w",
         "milky way": "milky way",
+        "horizon": "horizon",
     },
     "de": {
         "legend": "legende",
@@ -92,6 +93,7 @@ LABELS = {
         "s": "s",
         "w": "w",
         "milky way": "milchstraße",
+        "horizon": "Horizont",
     },
     "es": {
         "legend": "leyenda",
@@ -139,6 +141,7 @@ LABELS = {
         "s": "s",
         "w": "o",
         "milky way": "vía láctea",
+        "horizon": "horizonte",
     },
     "fr": {
         "legend": "légende",
@@ -186,6 +189,7 @@ LABELS = {
         "s": "s",
         "w": "o",
         "milky way": "voie lactée",
+        "horizon": "horizon",
     },
     "it": {
         "legend": "legenda",
@@ -233,6 +237,7 @@ LABELS = {
         "s": "s",
         "w": "o",
         "milky way": "via lattea",
+        "horizon": "orizzonte",
     },
     "zh-cn": {
         "legend": "图例",
@@ -280,6 +285,7 @@ LABELS = {
         "s": "南",
         "w": "西",
         "milky way": "银河",
+        "horizon": "地平线",
     },
     "zh-tw": {
         "legend": "圖例",
@@ -327,6 +333,7 @@ LABELS = {
         "s": "南",
         "w": "西",
         "milky way": "銀河",
+        "horizon": "地平線",
     },
     "fa": {
         "legend": "راهنما",
@@ -374,6 +381,7 @@ LABELS = {
         "s": "ج",
         "w": "غ",
         "milky way": "کهکشان راه شیری",
+        "horizon": "افق",
     },
     "lt": {
         "legend": "legenda",
@@ -421,6 +429,7 @@ LABELS = {
         "s": "P",
         "w": "V",
         "milky way": "Paukščių Takas",
+        "horizon": "horizontas",
     },
     "nl": {
         "legend": "legende",
@@ -468,6 +477,7 @@ LABELS = {
         "s": "z",
         "w": "w",
         "milky way": "melkweg",
+        "horizon": "horizon",
     },
 }
 

{starplot-0.21.4 → starplot-0.22.0}/src/starplot/models/__init__.py

@@ -10,6 +10,7 @@ from .observer import Observer
 from .optics import (
     Binoculars,
     Camera,
+    NakedEye,
     Optic,
     Reflector,
     Refractor,

{starplot-0.21.4 → starplot-0.22.0}/src/starplot/models/observer.py

@@ -1,7 +1,8 @@
 from collections.abc import Callable
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from functools import cache, cached_property
 
+import numpy as np
 from pydantic import AwareDatetime, BaseModel, Field, computed_field
 from skyfield.api import Star as SkyfieldStar
 from skyfield.api import wgs84
@@ -17,7 +18,7 @@ class Observer(BaseModel):
     Represents an observer at a specific time and place.
     """
 
-    dt: AwareDatetime = Field(default_factory=lambda: datetime.now(timezone.utc))
+    dt: AwareDatetime = Field(default_factory=lambda: datetime.now(UTC))
     """
     Date and time of observation (**must be timezone-aware**).
     
@@ -104,15 +105,25 @@ class Observer(BaseModel):
     def _apparent(self, obj: SkyfieldStar, ephemeris: str = "de440s.bsp"):
         """Returns apparent AZ, ALT of object"""
         pressure_mbar = self.pressure if self.pressure is not None else "standard"
-        pos_alt, pos_az, _ = (
-            self.observe(ephemeris)(obj)
-            .apparent()
-            .altaz(
-                temperature_C=self.temperature,
-                pressure_mbar=pressure_mbar,
-            )
+        apparent = self.observe(ephemeris)(obj).apparent()
+        geometric_alt, pos_az, _ = apparent.altaz()
+        geometric_degrees = np.asarray(geometric_alt.degrees)
+
+        # Skyfield's refraction cuts off abruptly below -1 degrees altitude, which makes anything
+        # crossing that altitude jump. Holding refraction constant below the horizon (instead of dropping to zero)
+        # keeps apparent positions continuous
+        above_horizon = np.maximum(geometric_degrees, 0)
+        refracted = apparent.center.refract(
+            above_horizon,
+            self.temperature,
+            pressure_mbar,
         )
-        return pos_az.degrees, pos_alt.degrees
+        pos_alt = geometric_degrees + (refracted.degrees - above_horizon)
+
+        if pos_alt.ndim == 0:
+            pos_alt = float(pos_alt)
+
+        return pos_az.degrees, pos_alt
 
     def radec(
         self, az: float, alt: float, ephemeris: str = "de440s.bsp"