keplemon 1.1.3__cp313-cp313-macosx_11_0_arm64.whl → 1.3.0__cp313-cp313-macosx_11_0_arm64.whl

keplemon/bodies.pyi

@@ -12,6 +12,7 @@ from keplemon.catalogs import TLECatalog
 from keplemon.time import Epoch, TimeSpan
 from keplemon.events import CloseApproach, CloseApproachReport, HorizonAccessReport, FieldOfViewReport
 from keplemon.propagation import ForceProperties
+from keplemon.enums import ReferenceFrame
 
 class Earth:
     @staticmethod
@@ -226,7 +227,9 @@ class Sensor:
         angular_noise: Angular noise in **_degrees_**
     """
 
-    name: str
+    id: str
+    """Unique identifier for the sensor."""
+    name: str | None
     angular_noise: float
     range_noise: float | None
     """Range noise in **_kilometers_**"""
@@ -236,7 +239,7 @@ class Sensor:
 
     angular_rate_noise: float | None
     """Angular rate noise in **_degrees per second_**"""
-    def __init__(self, name: str, angular_noise: float) -> None: ...
+    def __init__(self, angular_noise: float) -> None: ...
 
 class Observatory:
     """
@@ -310,16 +313,31 @@ class Observatory:
         sensor_direction: TopocentricElements,
         angular_threshold: float,
         sats: Constellation,
+        reference_frame: ReferenceFrame,
     ) -> FieldOfViewReport:
         """
-        Calculate field of view report for a sensor at the observatory.
+        Calculate satellites in the field of view from a given time and direction.
 
         Args:
             epoch: UTC epoch of the report
             sensor_direction: Topocentric direction the sensor is pointing
             angular_threshold: Angular threshold in **_degrees_**
             sats: Constellation of satellites to check for being in the field of view
-        Returns:
-            Field of view report for the sensor at the observatory containing satellites within the field of view
+            reference_frame: Reference frame of the output direction elements
+        """
+        ...
+
+    def get_topocentric_to_satellite(
+        self,
+        epoch: Epoch,
+        sat: Satellite,
+        reference_frame: ReferenceFrame,
+    ) -> TopocentricElements:
+        """
+        Get the topocentric elements of a satellite as seen from the observatory.
+        Args:
+            epoch: UTC epoch of the observation
+            sat: Satellite to observe
+            reference_frame: Reference frame of the output direction elements
         """
         ...

keplemon/estimation.pyi

@@ -17,6 +17,9 @@ class Observation:
         observer_teme_pos: Position of the observer in TEME coordinates
     """
 
+    id: str
+    """Unique identifier for the observation"""
+
     sensor: Sensor
     """Sensor which produced the observation"""
 

keplemon/events.pyi

@@ -1,6 +1,7 @@
 # flake8: noqa
 from keplemon.time import Epoch, TimeSpan
 from keplemon.elements import HorizonState, CartesianVector, TopocentricElements
+from keplemon.enums import ReferenceFrame
 
 class FieldOfViewCandidate:
     satellite_id: str
@@ -25,6 +26,9 @@ class FieldOfViewReport:
     candidates: list[FieldOfViewCandidate]
     """List of candidate satellites within the field of view"""
 
+    reference_frame: ReferenceFrame
+    """Reference frame of the output direction elements"""
+
 class CloseApproach:
     epoch: Epoch
     """UTC epoch of the close approach"""

keplemon/time.py

@@ -4,7 +4,7 @@ from keplemon._keplemon.time import (  # type: ignore
     Epoch,
 )
 import requests  # type: ignore
-from datetime import datetime
+from datetime import datetime, timezone
 from keplemon._keplemon.enums import TimeSystem  # type: ignore
 
 __all__ = [
@@ -15,6 +15,22 @@ __all__ = [
 ]
 
 
+def _from_datetime(dt: datetime) -> Epoch:
+    if dt.tzinfo is None:
+        dt = dt.replace(tzinfo=timezone.utc)
+    elif dt.tzinfo != timezone.utc:
+        dt = dt.astimezone(timezone.utc)
+    return Epoch.from_iso(dt.strftime("%Y-%m-%dT%H:%M:%S.%fZ"), TimeSystem.UTC)
+
+
+def _now() -> Epoch:
+    return _from_datetime(datetime.now(timezone.utc))
+
+
+Epoch.now = staticmethod(_now)
+Epoch.from_datetime = staticmethod(_from_datetime)
+
+
 def request_time_constants_update(output_path: str) -> None:
     finals = requests.get("https://maia.usno.navy.mil/ser7/finals.all").text.splitlines()
 

keplemon/time.pyi

@@ -3,6 +3,7 @@ from __future__ import annotations
 from pathlib import Path
 from keplemon.enums import TimeSystem
 from typing import overload, Any
+from datetime import datetime
 
 def request_time_constants_update(output_path: str | Path) -> None:
     """
@@ -145,6 +146,22 @@ class Epoch:
     day_of_year: float
     """Decimal day of the year (1-365.999...)"""
 
+    @classmethod
+    def from_datetime(cls, dt: datetime) -> Epoch:
+        """
+        Args:
+            dt: Aware or naive datetime object (assumed to be UTC if naive)
+        """
+        ...
+
+    @classmethod
+    def now(cls) -> Epoch:
+        """
+        Returns:
+            Current epoch in UTC time system
+        """
+        ...
+
     @classmethod
     def from_days_since_1950(cls, days: float, time_system: TimeSystem) -> Epoch:
         """

{keplemon-1.1.3.dist-info → keplemon-1.3.0.dist-info}/METADATA

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

{keplemon-1.1.3.dist-info → keplemon-1.3.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
-keplemon-1.1.3.dist-info/METADATA,sha256=nIV1B6nVcgMIMYk8CBPRexx82ZXOJ1IK9DkT9fsoo4Q,863
-keplemon-1.1.3.dist-info/WHEEL,sha256=7EyPuU1vQDftlqyV8jHPuI-hSsV6D32-W3PQHFWI9CA,104
-keplemon-1.1.3.dist-info/entry_points.txt,sha256=eYbCkvQvWfRDQ0LzaCELov1xeLAxQEHlfdgNq-LXyb0,49
+keplemon-1.3.0.dist-info/METADATA,sha256=3sQ1D7MO2aczJbdHH_zcbQTqM7AgkqE_Tsw28zQPcO8,863
+keplemon-1.3.0.dist-info/WHEEL,sha256=7EyPuU1vQDftlqyV8jHPuI-hSsV6D32-W3PQHFWI9CA,104
+keplemon-1.3.0.dist-info/entry_points.txt,sha256=eYbCkvQvWfRDQ0LzaCELov1xeLAxQEHlfdgNq-LXyb0,49
 keplemon/__init__.py,sha256=M9q5lNYh_BE6l4xCGJ5IH5PQH9aNm4q_r67ljsNkKvM,832
 keplemon/__init__.pyi,sha256=uE60ln_KJgcfvKburVmbcKT0h_wLPgjBWuyNLgI8ETI,1295
 keplemon/__main__.py,sha256=-3GVkDOA0lV0MIqU9gPb4zbVimg2lA8HMkvdPDw1O28,669
-keplemon/_keplemon.cpython-313-darwin.so,sha256=BZocYFcRoUBIBuu6TCno1OQQ8MMBrsIADh1vsxhaHig,2041536
+keplemon/_keplemon.cpython-313-darwin.so,sha256=ylJ1R39Kvi8_beIgInpp06iy111ybpUMfztwyRfoLiE,2040144
 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
@@ -17,7 +17,7 @@ keplemon/assets/SGP4_Open_License.txt,sha256=0WofOXQb5YJqnYhXWXnBdCajiTJQAT60UAk
 keplemon/assets/WGS84-70.GEO,sha256=ARjEC_5s2SVd0Kh9udbTy1ztBwTeuBYPOhUVJgIqit8,148510
 keplemon/assets/time_constants.dat,sha256=qDpJ2UrQvIDfxsBc4P2AdLS-b2lyR7RCzjqmeG4Ypl8,1226736
 keplemon/bodies.py,sha256=XnaY6XTuj8CHM3XOwOSY3E8nSo0RWwCcAY0FGxAVWa8,208
-keplemon/bodies.pyi,sha256=AU8veUqXkgA3CnYO3XycMUlOwnep-YoUvJZA2cXieYs,9532
+keplemon/bodies.pyi,sha256=xpciSiscdGgXJ_RTLCd08U6vJIdNX0dYAnlBzPW8240,10091
 keplemon/catalogs.py,sha256=lw71NiXlVtb-z3pQR03afxtkLca4HJcnpZ6kDCcR-Lk,102
 keplemon/catalogs.pyi,sha256=NU_6Mc_JY8xTYAKXOqubtPnt91YA9ZHd1hMqMFf6onc,589
 keplemon/elements.py,sha256=P4tlpQpCUG5jkgAT_yIeL2V14AhXtekMYxRBOsPlOgc,609
@@ -25,9 +25,9 @@ keplemon/elements.pyi,sha256=L5s_2AJz6HYYIncKmpkbYcejMVht09WWVrXRqo-ZV-Y,10240
 keplemon/enums.py,sha256=Jh0tFHg_rZXnOyLUXmHjSm3MSZFbvQKTBcP0BqHXeMY,308
 keplemon/enums.pyi,sha256=s9uqkm3Zrx6HLV4dQBScRiUy0CT4QoQwFjaCLOEMW1c,2330
 keplemon/estimation.py,sha256=2K87pFhOfaFohbAtBXv2SA6m_oIN-56toJOftu350fY,228
-keplemon/estimation.pyi,sha256=zb_llx8pCx9Iv95mXXpGnXPZeJsg9Oh5GRWDLyXrMFI,5521
+keplemon/estimation.pyi,sha256=3TtNCCwuwIX6J4UKyEL4Mwzmz_x9Sgj2TxSsSaOBz3U,5582
 keplemon/events.py,sha256=PGp-xE-eyjYSMWpugplA7bPlrYjkR1NKSHRurFMnBcE,359
-keplemon/events.pyi,sha256=8ydd7aWJ6upPRs6oHQL1-Mpp8iv_dOHxRnNyto1FbwA,2905
+keplemon/events.pyi,sha256=4wKWpQIVkCrE0jbRUk6KpmtXtzkksnEKJUAYY8Duw58,3043
 keplemon/exceptions.py,sha256=gTKSkN4yJ2VwR3_anpWqnIO9kQcJCO41_818NjgItiM,102
 keplemon/libastrofunc.dylib,sha256=guF0v4MRjoz8Ine-1nLxXYTktvlwHfQHUSa-GKjJZw0,241840
 keplemon/libdllmain.dylib,sha256=eyJQawgeOfDj4lAf2-YSJcvbdJ6abehX5nTChIOOLbs,112144
@@ -59,6 +59,6 @@ keplemon/saal/sgp4_prop_interface.py,sha256=BBKlIvXdUypcZspC8GJ2rPqfFoDKy0RM7w5q
 keplemon/saal/sgp4_prop_interface.pyi,sha256=Fv41UrqSPuITtYy_CcbyMxhysqtN3oeY38Ov4t81hvw,235
 keplemon/saal/time_func_interface.py,sha256=cshqJ15p_gcenMdmVuXTIoLeij1gsgVi0tujRQ4O6kA,421
 keplemon/saal/time_func_interface.pyi,sha256=GCj_EOmOceJorYQLGQQj1fE2cHxPvNrYml1DLvsaMy4,1508
-keplemon/time.py,sha256=vvHcwWQ1JXPaQSvdBfXYZrk2_-ukDw0RnXDeN5wy3nU,2792
-keplemon/time.pyi,sha256=S2Ul8fpuWnor9wKNFBxLwAiwrGrVN_LJH_xy6WSocv4,6260
-keplemon-1.1.3.dist-info/RECORD,,
+keplemon/time.py,sha256=OuJYhv9WFi0SF3P_6YKLSoLWDnbhQ-W8CDlNUvQJsxQ,3236
+keplemon/time.pyi,sha256=tFbv5qdVMGexvSHr_a6RxkXe0aDKcNWOxW3GmKf3eRc,6628
+keplemon-1.3.0.dist-info/RECORD,,