nrl-tracker 0.21.4__py3-none-any.whl → 0.22.0__py3-none-any.whl

pytcl/astronomical/__init__.py

@@ -2,7 +2,8 @@
 Astronomical calculations for target tracking.
 
 This module provides time system conversions, orbital mechanics,
-Lambert problem solvers, and reference frame transformations.
+Lambert problem solvers, reference frame transformations, and high-precision
+ephemerides for celestial bodies.
 
 Examples
 --------
@@ -18,100 +19,120 @@ Examples
 >>> r1 = np.array([5000, 10000, 2100])
 >>> r2 = np.array([-14600, 2500, 7000])
 >>> sol = lambert_universal(r1, r2, 3600)
+
+>>> # Query Sun position with high precision
+>>> from pytcl.astronomical import sun_position
+>>> r_sun, v_sun = sun_position(2451545.0)  # J2000.0
 """
 
-from pytcl.astronomical.lambert import (
-    LambertSolution,
-    bi_elliptic_transfer,
-    hohmann_transfer,
-    lambert_izzo,
-    lambert_universal,
-    minimum_energy_transfer,
+from pytcl.astronomical.ephemerides import DEEphemeris
+from pytcl.astronomical.ephemerides import barycenter_position
+from pytcl.astronomical.ephemerides import moon_position
+from pytcl.astronomical.ephemerides import planet_position
+from pytcl.astronomical.ephemerides import sun_position
+from pytcl.astronomical.lambert import LambertSolution
+from pytcl.astronomical.lambert import bi_elliptic_transfer
+from pytcl.astronomical.lambert import hohmann_transfer
+from pytcl.astronomical.lambert import lambert_izzo
+from pytcl.astronomical.lambert import lambert_universal
+from pytcl.astronomical.lambert import minimum_energy_transfer
+from pytcl.astronomical.orbital_mechanics import (
+    GM_EARTH,  # Constants; Types; Anomaly conversions; Element conversions; Propagation; Orbital quantities
 )
-from pytcl.astronomical.orbital_mechanics import (  # Constants; Types; Anomaly conversions; Element conversions; Propagation; Orbital quantities
-    GM_EARTH,
-    GM_JUPITER,
-    GM_MARS,
-    GM_MOON,
-    GM_SUN,
-    OrbitalElements,
-    StateVector,
-    apoapsis_radius,
-    circular_velocity,
-    eccentric_to_mean_anomaly,
-    eccentric_to_true_anomaly,
-    escape_velocity,
-    flight_path_angle,
-    hyperbolic_to_true_anomaly,
-    kepler_propagate,
-    kepler_propagate_state,
-    mean_motion,
-    mean_to_eccentric_anomaly,
-    mean_to_hyperbolic_anomaly,
-    mean_to_true_anomaly,
-    orbit_radius,
-    orbital_elements_to_state,
-    orbital_period,
-    periapsis_radius,
-    specific_angular_momentum,
-    specific_orbital_energy,
-    state_to_orbital_elements,
-    time_since_periapsis,
-    true_to_eccentric_anomaly,
-    true_to_hyperbolic_anomaly,
-    true_to_mean_anomaly,
-    vis_viva,
+from pytcl.astronomical.orbital_mechanics import GM_JUPITER
+from pytcl.astronomical.orbital_mechanics import GM_MARS
+from pytcl.astronomical.orbital_mechanics import GM_MOON
+from pytcl.astronomical.orbital_mechanics import GM_SUN
+from pytcl.astronomical.orbital_mechanics import OrbitalElements
+from pytcl.astronomical.orbital_mechanics import StateVector
+from pytcl.astronomical.orbital_mechanics import apoapsis_radius
+from pytcl.astronomical.orbital_mechanics import circular_velocity
+from pytcl.astronomical.orbital_mechanics import eccentric_to_mean_anomaly
+from pytcl.astronomical.orbital_mechanics import eccentric_to_true_anomaly
+from pytcl.astronomical.orbital_mechanics import escape_velocity
+from pytcl.astronomical.orbital_mechanics import flight_path_angle
+from pytcl.astronomical.orbital_mechanics import hyperbolic_to_true_anomaly
+from pytcl.astronomical.orbital_mechanics import kepler_propagate
+from pytcl.astronomical.orbital_mechanics import kepler_propagate_state
+from pytcl.astronomical.orbital_mechanics import mean_motion
+from pytcl.astronomical.orbital_mechanics import mean_to_eccentric_anomaly
+from pytcl.astronomical.orbital_mechanics import mean_to_hyperbolic_anomaly
+from pytcl.astronomical.orbital_mechanics import mean_to_true_anomaly
+from pytcl.astronomical.orbital_mechanics import orbit_radius
+from pytcl.astronomical.orbital_mechanics import orbital_elements_to_state
+from pytcl.astronomical.orbital_mechanics import orbital_period
+from pytcl.astronomical.orbital_mechanics import periapsis_radius
+from pytcl.astronomical.orbital_mechanics import specific_angular_momentum
+from pytcl.astronomical.orbital_mechanics import specific_orbital_energy
+from pytcl.astronomical.orbital_mechanics import state_to_orbital_elements
+from pytcl.astronomical.orbital_mechanics import time_since_periapsis
+from pytcl.astronomical.orbital_mechanics import true_to_eccentric_anomaly
+from pytcl.astronomical.orbital_mechanics import true_to_hyperbolic_anomaly
+from pytcl.astronomical.orbital_mechanics import true_to_mean_anomaly
+from pytcl.astronomical.orbital_mechanics import vis_viva
+from pytcl.astronomical.reference_frames import (
+    earth_rotation_angle,  # Time utilities; Precession; Nutation; Earth rotation; Polar motion; Full transformations; Ecliptic/equatorial
 )
-from pytcl.astronomical.reference_frames import (  # Time utilities; Precession; Nutation; Earth rotation; Polar motion; Full transformations; Ecliptic/equatorial
-    earth_rotation_angle,
-    ecef_to_eci,
-    eci_to_ecef,
-    ecliptic_to_equatorial,
-    equation_of_equinoxes,
-    equatorial_to_ecliptic,
-    gast_iau82,
-    gcrf_to_itrf,
-    gmst_iau82,
-    itrf_to_gcrf,
-    julian_centuries_j2000,
-    mean_obliquity_iau80,
-    nutation_angles_iau80,
-    nutation_matrix,
-    polar_motion_matrix,
-    precession_angles_iau76,
-    precession_matrix_iau76,
-    sidereal_rotation_matrix,
-    true_obliquity,
+from pytcl.astronomical.reference_frames import ecef_to_eci
+from pytcl.astronomical.reference_frames import eci_to_ecef
+from pytcl.astronomical.reference_frames import ecliptic_to_equatorial
+from pytcl.astronomical.reference_frames import equation_of_equinoxes
+from pytcl.astronomical.reference_frames import equatorial_to_ecliptic
+from pytcl.astronomical.reference_frames import gast_iau82
+from pytcl.astronomical.reference_frames import gcrf_to_itrf
+from pytcl.astronomical.reference_frames import gmst_iau82
+from pytcl.astronomical.reference_frames import itrf_to_gcrf
+from pytcl.astronomical.reference_frames import julian_centuries_j2000
+from pytcl.astronomical.reference_frames import mean_obliquity_iau80
+from pytcl.astronomical.reference_frames import nutation_angles_iau80
+from pytcl.astronomical.reference_frames import nutation_matrix
+from pytcl.astronomical.reference_frames import polar_motion_matrix
+from pytcl.astronomical.reference_frames import precession_angles_iau76
+from pytcl.astronomical.reference_frames import precession_matrix_iau76
+from pytcl.astronomical.reference_frames import sidereal_rotation_matrix
+from pytcl.astronomical.reference_frames import true_obliquity
+from pytcl.astronomical.relativity import (
+    C_LIGHT,  # Physical constants; Schwarzschild metric; Time dilation; Shapiro delay; Precession; PN effects; Range corrections
 )
-from pytcl.astronomical.time_systems import (  # Julian dates; Time scales; Unix time; GPS week; Sidereal time; Leap seconds; Constants
-    JD_GPS_EPOCH,
-    JD_J2000,
-    JD_UNIX_EPOCH,
-    MJD_OFFSET,
-    TT_TAI_OFFSET,
-    LeapSecondTable,
-    cal_to_jd,
-    gast,
-    get_leap_seconds,
-    gmst,
-    gps_to_tai,
-    gps_to_utc,
-    gps_week_seconds,
-    gps_week_to_utc,
-    jd_to_cal,
-    jd_to_mjd,
-    jd_to_unix,
-    mjd_to_jd,
-    tai_to_gps,
-    tai_to_tt,
-    tai_to_utc,
-    tt_to_tai,
-    tt_to_utc,
-    unix_to_jd,
-    utc_to_gps,
-    utc_to_tai,
-    utc_to_tt,
+from pytcl.astronomical.relativity import G_GRAV
+from pytcl.astronomical.relativity import geodetic_precession
+from pytcl.astronomical.relativity import gravitational_time_dilation
+from pytcl.astronomical.relativity import lense_thirring_precession
+from pytcl.astronomical.relativity import post_newtonian_acceleration
+from pytcl.astronomical.relativity import proper_time_rate
+from pytcl.astronomical.relativity import relativistic_range_correction
+from pytcl.astronomical.relativity import schwarzschild_precession_per_orbit
+from pytcl.astronomical.relativity import schwarzschild_radius
+from pytcl.astronomical.relativity import shapiro_delay
+from pytcl.astronomical.time_systems import (
+    JD_GPS_EPOCH,  # Julian dates; Time scales; Unix time; GPS week; Sidereal time; Leap seconds; Constants
 )
+from pytcl.astronomical.time_systems import JD_J2000
+from pytcl.astronomical.time_systems import JD_UNIX_EPOCH
+from pytcl.astronomical.time_systems import MJD_OFFSET
+from pytcl.astronomical.time_systems import TT_TAI_OFFSET
+from pytcl.astronomical.time_systems import LeapSecondTable
+from pytcl.astronomical.time_systems import cal_to_jd
+from pytcl.astronomical.time_systems import gast
+from pytcl.astronomical.time_systems import get_leap_seconds
+from pytcl.astronomical.time_systems import gmst
+from pytcl.astronomical.time_systems import gps_to_tai
+from pytcl.astronomical.time_systems import gps_to_utc
+from pytcl.astronomical.time_systems import gps_week_seconds
+from pytcl.astronomical.time_systems import gps_week_to_utc
+from pytcl.astronomical.time_systems import jd_to_cal
+from pytcl.astronomical.time_systems import jd_to_mjd
+from pytcl.astronomical.time_systems import jd_to_unix
+from pytcl.astronomical.time_systems import mjd_to_jd
+from pytcl.astronomical.time_systems import tai_to_gps
+from pytcl.astronomical.time_systems import tai_to_tt
+from pytcl.astronomical.time_systems import tai_to_utc
+from pytcl.astronomical.time_systems import tt_to_tai
+from pytcl.astronomical.time_systems import tt_to_utc
+from pytcl.astronomical.time_systems import unix_to_jd
+from pytcl.astronomical.time_systems import utc_to_gps
+from pytcl.astronomical.time_systems import utc_to_tai
+from pytcl.astronomical.time_systems import utc_to_tt
 
 __all__ = [
     # Time systems - Julian dates
@@ -218,4 +239,24 @@ __all__ = [
     # Reference frames - Ecliptic/equatorial
     "ecliptic_to_equatorial",
     "equatorial_to_ecliptic",
+    # Ephemerides - Classes
+    "DEEphemeris",
+    # Ephemerides - Functions
+    "sun_position",
+    "moon_position",
+    "planet_position",
+    "barycenter_position",
+    # Relativity - Constants
+    "C_LIGHT",
+    "G_GRAV",
+    # Relativity - Functions
+    "schwarzschild_radius",
+    "gravitational_time_dilation",
+    "proper_time_rate",
+    "shapiro_delay",
+    "schwarzschild_precession_per_orbit",
+    "post_newtonian_acceleration",
+    "geodetic_precession",
+    "lense_thirring_precession",
+    "relativistic_range_correction",
 ]