astraeos-astro

The Sun's position in pure Python, ported from libastro, the C core of PyEphem.

It needs nothing but the Python standard library, so it installs anywhere Python runs, with no compiler. It matches PyEphem to within a few thousandths of an arcsecond. Helios, a Home Assistant integration, computes the Sun with it.

Read this in: English | Français

English

Install

pip install astraeos-astro

Python 3.10 or later.

Usage

from datetime import datetime, timezone
import astraeos_astro as astro

jd = astro.julian_day(datetime(2024, 6, 21, 12, 0, tzinfo=timezone.utc))
seen = astro.observe_sun(jd, latitude=48.8566, longitude=2.3522, elevation_m=35)
print(f"altitude {seen.altitude:.4f}°, azimuth {seen.azimuth:.4f}°")
# altitude 64.5363°, azimuth 183.9972°

position = seen.position
code = astro.constellation(
    position.astrometric_right_ascension,
    position.astrometric_declination,
    position.jd_tt,
)
print(code, astro.CONSTELLATION_NAMES[code])
# Gem Gemini

• Angles are in degrees, longitudes positive east, and times in Julian days.
• observe_sun takes Universal Time and applies ΔT itself; sun_position takes Terrestrial Time.
• Altitude and azimuth are topocentric (parallax included) and without refraction. Azimuth is 0° north, 90° east.

What it computes

Accuracy against PyEphem 4.2.1

Measured on 3,000 random moments and places from 1900 to 2100. The remaining differences come from PyEphem itself, which stores altitude, azimuth and distance in single precision.

Data tables

The _*_data.py modules hold libastro's tables: VSOP87, nutation, ΔT and constellation boundaries. scripts/extract_libastro.py regenerates them from the libastro folder of a PyEphem source distribution, byte for byte:

python scripts/extract_libastro.py path/to/ephem-4.2.1/libastro

Tests

pip install -e ".[test]"
pytest

PyEphem is only the reference the tests compare against; the tests that need it are skipped without it.

License

MIT. astraeos-astro ports libastro (Elwood Downey) and PyEphem (Brandon Rhodes), both under the MIT license, and Craig Counterman's precession routine. Their notices are in src/astraeos_astro/LICENSE.txt, which ships with the package.

Français

astraeos-astro calcule la position du soleil en Python pur, à partir d'une traduction de libastro, le cœur en C de PyEphem. Il ne dépend que de la bibliothèque standard de Python et s'installe partout sans compilateur. Il rejoint PyEphem à quelques millièmes de seconde d'arc près. Helios, une intégration Home Assistant, s'en sert pour calculer le soleil.

pip install astraeos-astro

Python 3.10 ou plus récent.

• Les angles sont en degrés, les longitudes positives vers l'est et les dates en jours juliens.
• observe_sun prend le temps universel et applique ΔT lui-même ; sun_position prend le temps terrestre.
• La hauteur et l'azimut sont topocentriques (parallaxe comprise) et sans réfraction. L'azimut vaut 0° au nord, 90° à l'est.

L'exemple, le détail des modules et les mesures de précision sont dans la section en anglais. Les tables de données se régénèrent avec scripts/extract_libastro.py, et les tests se lancent avec pip install -e ".[test]" puis pytest.

Licence MIT. astraeos-astro traduit libastro (Elwood Downey) et PyEphem (Brandon Rhodes), tous deux sous licence MIT, ainsi que la routine de précession de Craig Counterman. Leurs mentions figurent dans src/astraeos_astro/LICENSE.txt, livré avec le paquet.