keplemon 1.3.1__cp311-cp311-win_amd64.whl → 1.5.0__cp311-cp311-win_amd64.whl

keplemon/__init__.py

@@ -4,6 +4,7 @@ from keplemon._keplemon import (  # type: ignore
     set_thread_count,
     set_license_file_path,
     get_license_file_path,
+    set_jpl_ephemeris_file_path,
 )
 from pathlib import Path
 
@@ -18,10 +19,15 @@ set_license_file_path(ASSETS_DIRECTORY.as_posix())
 TIME_CONSTANTS_PATH = ASSETS_DIRECTORY / "time_constants.dat"
 load_time_constants(TIME_CONSTANTS_PATH.as_posix())
 
+# Load the JPL path
+JPL_EPHEMERIS_PATH = ASSETS_DIRECTORY / "JPLcon_1950_2050.405"
+set_jpl_ephemeris_file_path(JPL_EPHEMERIS_PATH.as_posix())
+
 __all__ = [
     "get_thread_count",
     "set_thread_count",
     "TIME_CONSTANTS_PATH",
+    "JPL_EPHEMERIS_PATH",
     "set_license_file_path",
     "PACKAGE_DIRECTORY",
     "ASSETS_DIRECTORY",

keplemon/bodies.pyi

@@ -7,6 +7,8 @@ from keplemon.elements import (
     GeodeticPosition,
     OrbitPlotData,
     TopocentricElements,
+    RelativeState,
+    BoreToBodyAngles,
 )
 from keplemon.catalogs import TLECatalog
 from keplemon.time import Epoch, TimeSpan
@@ -80,6 +82,26 @@ class Satellite:
         """
         ...
 
+    def get_relative_state_at_epoch(self, other: Satellite, epoch: Epoch) -> RelativeState | None:
+        """
+        Calculate the relative state between this satellite and another satellite at a given epoch.
+
+        Args:
+            other: Secondary satellite to calculate the relative state against
+            epoch: UTC epoch at which the relative state will be calculated
+        """
+        ...
+
+    def get_body_angles_at_epoch(self, other: Satellite, epoch: Epoch) -> BoreToBodyAngles | None:
+        """
+        Calculate the bore-to-body angles between this satellite and another satellite at a given epoch.
+
+        Args:
+            other: Secondary satellite to calculate the bore-to-body angles against
+            epoch: UTC epoch at which the bore-to-body angles will be calculated
+        """
+        ...
+
     def get_plot_data(self, start: Epoch, end: Epoch, step: TimeSpan) -> OrbitPlotData | None: ...
     def get_observatory_access_report(
         self,

keplemon/elements.py

@@ -12,6 +12,8 @@ from keplemon._keplemon.elements import (  # type: ignore
     GeodeticPosition,
     OrbitPlotData,
     OrbitPlotState,
+    RelativeState,
+    BoreToBodyAngles,
 )
 
 __all__ = [
@@ -28,4 +30,6 @@ __all__ = [
     "GeodeticPosition",
     "OrbitPlotData",
     "OrbitPlotState",
+    "RelativeState",
+    "BoreToBodyAngles",
 ]

keplemon/elements.pyi

@@ -4,6 +4,18 @@ from keplemon.time import Epoch
 from keplemon.enums import Classification, KeplerianType, ReferenceFrame
 from keplemon.events import CloseApproach
 
+class RelativeState:
+    epoch: Epoch
+    position: CartesianVector
+    velocity: CartesianVector
+    origin_satellite_id: str
+    secondary_satellite_id: str
+
+class BoreToBodyAngles:
+    earth_angle: float
+    sun_angle: float
+    moon_angle: float
+
 class OrbitPlotData:
     satellite_id: str
     epochs: list[str]

keplemon/saal/astro_func_interface.py

@@ -3,6 +3,9 @@ from keplemon._keplemon.saal.astro_func_interface import (  # type: ignore
     ra_dec_to_az_el_time,
     ra_dec_to_az_el,
     mean_motion_to_sma,
+    sma_to_mean_motion,
+    kozai_to_brouwer,
+    brouwer_to_kozai,
     topo_date_to_equinox,
     topo_equinox_to_date,
     theta_teme_to_lla,
@@ -20,6 +23,7 @@ from keplemon._keplemon.saal.astro_func_interface import (  # type: ignore
     XA_TOPO_SIZE,
     YROFEQNX_2000,
     YROFEQNX_CURR,
+    get_jpl_sun_and_moon_position,
 )
 
 __all__ = [
@@ -44,4 +48,8 @@ __all__ = [
     "YROFEQNX_2000",
     "YROFEQNX_CURR",
     "topo_equinox_to_date",
+    "get_jpl_sun_and_moon_position",
+    "kozai_to_brouwer",
+    "brouwer_to_kozai",
+    "sma_to_mean_motion",
 ]

keplemon/saal/astro_func_interface.pyi

@@ -2,13 +2,41 @@
 
 def mean_motion_to_sma(mean_motion: float) -> float:
     """
-    Convert mean motion to semi-major axis.
+    Convert mean motion to semi-major axis in kilometers.
 
     Args:
         mean_motion: Mean motion in revolutions/day.
+    """
+    ...
 
-    Returns:
-        Semi-major axis in kilometers.
+def sma_to_mean_motion(sma: float) -> float:
+    """
+    Convert semi-major axis to mean motion in revolutions/day.
+
+    Args:
+        sma: Semi-major axis in kilometers.
+    """
+    ...
+
+def kozai_to_brouwer(e_kozai: float, i_kozai: float, n_kozai: float) -> float:
+    """
+    Convert Kozai orbital elements to Brouwer orbital elements.
+
+    Args:
+        e_kozai: Eccentricity (unitless).
+        i_kozai: Inclination in degrees.
+        n_kozai: Mean motion in revolutions/day.
+    """
+    ...
+
+def brouwer_to_kozai(e_brouwer: float, i_brouwer: float, n_brouwer: float) -> float:
+    """
+    Convert Brouwer orbital elements to Kozai orbital elements.
+
+    Args:
+        e_brouwer: Eccentricity (unitless).
+        i_brouwer: Inclination in degrees.
+        n_brouwer: Mean motion in revolutions/day.
     """
     ...
 
@@ -121,6 +149,20 @@ def theta_teme_to_lla(theta: float, lat: float, long: float, ra: float, dec: flo
     """
     ...
 
+def get_jpl_sun_and_moon_position(ds50_utc: float) -> tuple[list[float], list[float]]:
+    """
+    Get the JPL ephemeris positions of the Sun and Moon in TEME coordinates.
+
+    Args:
+        ds50_utc: Epoch in DS50 UTC format.
+
+    Returns:
+        A tuple containing two lists:
+            - Sun position in TEME coordinates [x, y, z] in kilometers.
+            - Moon position in TEME coordinates [x, y, z] in kilometers.
+    """
+    ...
+
 def time_teme_to_lla(ds50_utc: float, lat: float, long: float, ra: float, dec: float) -> tuple[float, float]:
     """
     Convert TEME coordinates to latitude, longitude, and altitude.

keplemon/saal/sat_state_interface.py

@@ -0,0 +1,5 @@
+from keplemon._keplemon.saal.sat_state_interface import (  # type: ignore
+    get_relative_state,
+)
+
+__all__ = ["get_relative_state"]

keplemon/saal/sat_state_interface.pyi

@@ -0,0 +1,9 @@
+def get_relative_state(state_1: list[float], state_2: list[float], utc_ds50: float) -> list[float]:
+    """Calculate the relative state between two satellites
+
+    Args:
+        state_1: primary satellite TEME state vector [x, y, z, vx, vy, vz] in km and km/s
+        state_2: secondary satellite TEME state vector [x, y, z, vx, vy, vz] in km and km/s
+        utc_ds50: UTC time in days since 1950
+    """
+    ...

keplemon/time.py

@@ -27,8 +27,14 @@ def _now() -> Epoch:
     return _from_datetime(datetime.now(timezone.utc))
 
 
+def _to_datetime(epoch: Epoch) -> datetime:
+    iso_str = epoch.to_iso()
+    return datetime.fromisoformat(iso_str.replace("Z", "+00:00"))
+
+
 Epoch.now = staticmethod(_now)
 Epoch.from_datetime = staticmethod(_from_datetime)
+Epoch.to_datetime = _to_datetime
 
 
 def request_time_constants_update(output_path: str) -> None:

keplemon/time.pyi

@@ -146,6 +146,13 @@ class Epoch:
     day_of_year: float
     """Decimal day of the year (1-365.999...)"""
 
+    def to_datetime(self) -> datetime:
+        """
+        Returns:
+            Aware datetime object in UTC time system
+        """
+        ...
+
     @classmethod
     def from_datetime(cls, dt: datetime) -> Epoch:
         """

{keplemon-1.3.1.dist-info → keplemon-1.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: keplemon
-Version: 1.3.1
+Version: 1.5.0
 Requires-Dist: requests
 Requires-Dist: click
 Requires-Dist: maturin>=1.0,<2.0 ; extra == 'dev'

{keplemon-1.3.1.dist-info → keplemon-1.5.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
-keplemon-1.3.1.dist-info/METADATA,sha256=fl7n1Iefcs9qhxB00Y617U8cbU94YAwmuswu_482oJc,863
-keplemon-1.3.1.dist-info/WHEEL,sha256=bNaa2-XeaoMXnkzV391Sm2NgCjpJ3A2VmfN6ZUnNTZA,96
-keplemon-1.3.1.dist-info/entry_points.txt,sha256=eYbCkvQvWfRDQ0LzaCELov1xeLAxQEHlfdgNq-LXyb0,49
+keplemon-1.5.0.dist-info/METADATA,sha256=5zcpgXY79lEuvKCf89MaAfoXWmf0xeEsqGEu-zLVHzo,863
+keplemon-1.5.0.dist-info/WHEEL,sha256=bNaa2-XeaoMXnkzV391Sm2NgCjpJ3A2VmfN6ZUnNTZA,96
+keplemon-1.5.0.dist-info/entry_points.txt,sha256=eYbCkvQvWfRDQ0LzaCELov1xeLAxQEHlfdgNq-LXyb0,49
 keplemon/AstroFunc.dll,sha256=RwDLeYGuSd3MxQ3O_Ljb0maS5KoDL8HZLpAvcQhDmnQ,357376
 keplemon/AstroFunc.lib,sha256=q0Ob5NGUgbywJg6XqH48QLNmFv8T5p8NVLSx2kKkL4A,56480
 keplemon/DllMain.dll,sha256=vYgOfGAUHn2z1MrVu9wV-k_LRdtuF8RuWrbuu2xk7jk,121344
@@ -27,10 +27,10 @@ keplemon/Tle.dll,sha256=Yt6hY3-PoJFFgB2idJQFC_Ia49grYhpSe_gPAmVswMs,195584
 keplemon/Tle.lib,sha256=6NCJPR7JQ63mxCISyvYteq4-oHcqs3Ib8bwhTjJfk-I,23622
 keplemon/Vcm.dll,sha256=EWx2eZAdBa1F2yGSUYzgAItnP6-nJT35sfJsrBW1Vfs,274432
 keplemon/Vcm.lib,sha256=q2FPbH_DJXjIzNIzli2f1uV2faHHBjLbffZrL3Nagpw,19404
-keplemon/__init__.py,sha256=JymfGXbJ9UJDdwRW0CXS7j5j_LPk1_P_ViKbjoTdCFU,861
+keplemon/__init__.py,sha256=2OlT1xsx5c_QHS1Mxg3wPmxMejkrx9d_gJ2NqPL6frk,1069
 keplemon/__init__.pyi,sha256=PgtL8CNupZCJibx07RLmFf56gMkCFx7voUIxBpeADO8,1349
 keplemon/__main__.py,sha256=Bbbzny3eE3NOikVCEVFAGJiSRGooAkLzPwoSz-rpaxc,689
-keplemon/_keplemon.cp311-win_amd64.pyd,sha256=NvqT2V5bWUbe8vdjr0-G1NHpnyHElXxeDk3gXFvZAq8,1672192
+keplemon/_keplemon.cp311-win_amd64.pyd,sha256=FUhj7JC9eBeRz-9nZbcuY5Be8i_G6d_cuzAixxCZI24,1705472
 keplemon/assets/EGM-2008.GEO,sha256=K2nG8HGLATIHZYMfw3GSClYOTCuZ7rq4RdCeUNgCw5A,148770
 keplemon/assets/EGM-96.GEO,sha256=VBkILuvEMwAPuWmUHy2PeyEfULOwJ4PEJLNf5hr84mU,148770
 keplemon/assets/GEM_5-22.GEO,sha256=stemYLn1ChXa-VdLGHYfa15AXZa_xxGZQ65p4c3gffI,6852
@@ -43,11 +43,11 @@ keplemon/assets/SGP4_Open_License.txt,sha256=ThQ87DpbbXt-9K0-0U13tcZqsndte_UkaG3
 keplemon/assets/WGS84-70.GEO,sha256=ARjEC_5s2SVd0Kh9udbTy1ztBwTeuBYPOhUVJgIqit8,148510
 keplemon/assets/time_constants.dat,sha256=3nsYjFgq0QnTUHPxuQPdtMG-AqxShVbvmG2zPcZfdcA,1246208
 keplemon/bodies.py,sha256=MjdAGL25eF5pA3KHo5ipjz0DDql5EEEbBqR735M254g,217
-keplemon/bodies.pyi,sha256=wTgjk63L5_GNBIotvvZCCjrJ8ZIHHJG-6kOH5dEPjjk,10434
+keplemon/bodies.pyi,sha256=WJnWEltpkYNfQXjlgZJYPUViiL4egcAnl54nvY3xCgI,11324
 keplemon/catalogs.py,sha256=AKONH7zWBOnUZI0ty0lYiYZtrdILfKivoUgk1nU3PZ8,107
 keplemon/catalogs.pyi,sha256=UxwRVMfuySXNYOQ7KuCXtwHcu3zL3Fgo1sBP77qUKaU,606
-keplemon/elements.py,sha256=Z0zzwjbOnqi4lXO4Iw5Nio2eZcdrlObzAJ2oLRDzyJY,640
-keplemon/elements.pyi,sha256=EQEqEduwsMqhKjLPbbVS3eyGxNRQitLfzM8KhuxPDLs,10647
+keplemon/elements.py,sha256=-xnzE4wM6VESsenEdzJrVLmxwG68nWwfqOpfXY1F0xI,730
+keplemon/elements.pyi,sha256=VzuP2qT8miPWohOHXGGzPcp-kWaUh48Far6G7qtxls0,10910
 keplemon/enums.py,sha256=5MejXeSwXPtfpIYeNuFQH3LSIRf4aTFZTK2Q1AYyaEg,325
 keplemon/enums.pyi,sha256=OSS71WesYTgzWGUSjpxaYtzj6XmoyLBXq_Zd13IBwyQ,2418
 keplemon/estimation.py,sha256=Of0rHiapW4s1wRipBCZrp4oOiIzs794w1nhqM7AVrGs,236
@@ -63,14 +63,16 @@ keplemon/propagation.pyi,sha256=BjBIlp_8fdEb5gii5OsvLtXfIzV_Mo2pLlX75bZ1SDo,715
 keplemon/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 keplemon/saal/__init__.py,sha256=JS-tjVFqN1B3ZjIG2g7v1GrmUPi9eIv0_Le1reYuQ2o,126
 keplemon/saal/__init__.pyi,sha256=7wosTC1KhEJis-zp2LlZmW7hlr8BzFO4gx0TJ9c3J80,148
-keplemon/saal/astro_func_interface.py,sha256=i0b1a7y2Y1IJWcBbm6WdFhGUBMrSxwvWpgra-QepXF0,1031
-keplemon/saal/astro_func_interface.pyi,sha256=soshmSZ7k1v_1WgVfE93pM-h7RNF17e5-xmdBPGu7vo,4955
+keplemon/saal/astro_func_interface.py,sha256=GlS_JBSU12yjw4jbiHLQtL9QMM_VI91sm1VYhTDChVw,1253
+keplemon/saal/astro_func_interface.pyi,sha256=eY-Z86rquRMHhSP_q7pAGAwGQSi67JONBY_x0zmd_Cw,6221
 keplemon/saal/obs_interface.py,sha256=ax8T4Y61pWh3VnQ4K2bCDNdrK-H6WKWr14pEDAY8WxE,257
 keplemon/saal/obs_interface.pyi,sha256=Y9PE1t2Kdz1Sne1t_M-ctOp9G4hWGKgMMkuES6v1U6Q,235
+keplemon/saal/sat_state_interface.py,sha256=iiL_qIAaqXWlBu5FIdxhPWK4K9E7OmMzYIxkZPsShSo,139
+keplemon/saal/sat_state_interface.pyi,sha256=w3KGIYiRuhpY1bx7Hp8F9gKbfDhi0ofBRSYcMw1glR0,423
 keplemon/saal/sgp4_prop_interface.py,sha256=biuhXWIsauR4BO8chsWILfb8-E8OdRNWT5cSL3OYsVQ,134
 keplemon/saal/sgp4_prop_interface.pyi,sha256=9NpOUhf03VQYVEyq1Kutqp6J6bZ3x0NCFSBlVY-Nb9s,244
 keplemon/saal/time_func_interface.py,sha256=C18Q_PIMUFBcB0pHN6wlVj35Vrt83VQNKOEmHDHvZSA,438
 keplemon/saal/time_func_interface.pyi,sha256=3QKtsuxMoTgG--bDvbVNcJyD8vfcAUlw2n69g1m0kNM,1578
-keplemon/time.py,sha256=21gJUjG6ijI34j6Q5NwDisFZN3jXLcBIxoXeQ48D9Ak,3348
-keplemon/time.pyi,sha256=TD60TgcCnAbgo0hnQlD5iMhOmQR57kKs05fGv32oVNY,6914
-keplemon-1.3.1.dist-info/RECORD,,
+keplemon/time.py,sha256=rjS9bRLlfdcELE25e72sjqTw5I2Igb50rNqeStpFC-k,3528
+keplemon/time.pyi,sha256=IDSNfQa0zy4YspWSjdUAMzrGUrHzZUDWLBKz9WZ4ZA0,7067
+keplemon-1.5.0.dist-info/RECORD,,