Source code for space_pv_space_env.mars
"""Mars seasonal geometry from NASA GISS Mars24 (Allison & McEwen, 2000).
Implements the corrected 2025-01-07 algorithm, sections B and D1/D2.
https://www.giss.nasa.gov/tools/mars24/help/algorithm.html
Input is Julian date in TT, never an implicit UTC/mission-sol conversion.
"""
from __future__ import annotations
import numpy as np
MARS_SOL_SECONDS = 86400.0 * 1.0274912517
[docs]
def mars_solar_parameters(julian_date_tt: float | np.ndarray) -> dict[str, np.ndarray]:
"""Return solar longitude, declination and Sun distance for TT Julian dates.
Angles are degrees; declination is planetographic as in Mars24. This is
an analytic seasonal approximation, not a SPICE ephemeris. Use Astropy's
``Time(..., scale='utc').tt.jd`` for leap-second-aware UTC conversion.
"""
jd = np.asarray(julian_date_tt, dtype=float)
if not np.all(np.isfinite(jd)):
raise ValueError("julian_date_tt must be finite")
d = jd - 2451545.0
m = np.deg2rad(19.3871 + 0.52402073 * d)
pbs = np.zeros_like(d)
for amplitude, period, phase in (
(0.0071, 2.2353, 49.409),
(0.0057, 2.7543, 168.173),
(0.0039, 1.1177, 191.837),
(0.0037, 15.7866, 21.736),
(0.0021, 2.1354, 15.704),
(0.0020, 2.4694, 95.528),
(0.0018, 32.8493, 49.095),
):
pbs += amplitude * np.cos(np.deg2rad(0.985626 * d / period + phase))
center = (
(10.691 + 3e-7 * d) * np.sin(m)
+ 0.623 * np.sin(2 * m)
+ 0.050 * np.sin(3 * m)
+ 0.005 * np.sin(4 * m)
+ 0.0005 * np.sin(5 * m)
+ pbs
)
ls = (270.3871 + 0.524038496 * d + center) % 360.0
distance = 1.52367934 * (
1.00436
- 0.09309 * np.cos(m)
- 0.004336 * np.cos(2 * m)
- 0.00031 * np.cos(3 * m)
- 0.00003 * np.cos(4 * m)
)
return {
"solar_longitude_deg": ls,
"declination_deg": mars_declination(ls),
"sun_distance_au": distance,
}
[docs]
def mars_declination(solar_longitude_deg: float | np.ndarray) -> np.ndarray:
"""Mars24 planetographic solar declination in degrees from season Ls."""
ls = np.asarray(solar_longitude_deg, dtype=float)
if not np.all(np.isfinite(ls)):
raise ValueError("solar_longitude_deg must be finite")
sine = np.sin(np.deg2rad(ls))
return np.rad2deg(np.arcsin(0.42565 * sine)) + 0.25 * sine