keplemon 1.1.3__cp313-cp313-win_amd64.whl → 1.3.0__cp313-cp313-win_amd64.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,6 +1,6 @@
-keplemon-1.1.3.dist-info/METADATA,sha256=nIV1B6nVcgMIMYk8CBPRexx82ZXOJ1IK9DkT9fsoo4Q,863
-keplemon-1.1.3.dist-info/WHEEL,sha256=TJQY77QRLvXq32tEs9ATmwKO6NAOtuKOAw50eyiSmWU,96
-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=TJQY77QRLvXq32tEs9ATmwKO6NAOtuKOAw50eyiSmWU,96
+keplemon-1.3.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
@@ -30,7 +30,7 @@ keplemon/Vcm.lib,sha256=q2FPbH_DJXjIzNIzli2f1uV2faHHBjLbffZrL3Nagpw,19404
 keplemon/__init__.py,sha256=JymfGXbJ9UJDdwRW0CXS7j5j_LPk1_P_ViKbjoTdCFU,861
 keplemon/__init__.pyi,sha256=PgtL8CNupZCJibx07RLmFf56gMkCFx7voUIxBpeADO8,1349
 keplemon/__main__.py,sha256=Bbbzny3eE3NOikVCEVFAGJiSRGooAkLzPwoSz-rpaxc,689
-keplemon/_keplemon.cp313-win_amd64.pyd,sha256=Bzmx07qTjc8Qzn3EM6OJzbhbKW9P0Boms0RhKiNMcjU,1715712
+keplemon/_keplemon.cp313-win_amd64.pyd,sha256=Aq5s8lxBX_TnnkLGclWLLYcnpnAfGCJ0sM0ZX0BRk9M,1699328
 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,7 +43,7 @@ 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=hDzYm2WGr4Q075I8cjpV61By8h9iUeqpwQCJYj55ra4,9857
+keplemon/bodies.pyi,sha256=wTgjk63L5_GNBIotvvZCCjrJ8ZIHHJG-6kOH5dEPjjk,10434
 keplemon/catalogs.py,sha256=AKONH7zWBOnUZI0ty0lYiYZtrdILfKivoUgk1nU3PZ8,107
 keplemon/catalogs.pyi,sha256=UxwRVMfuySXNYOQ7KuCXtwHcu3zL3Fgo1sBP77qUKaU,606
 keplemon/elements.py,sha256=Z0zzwjbOnqi4lXO4Iw5Nio2eZcdrlObzAJ2oLRDzyJY,640
@@ -51,9 +51,9 @@ keplemon/elements.pyi,sha256=EQEqEduwsMqhKjLPbbVS3eyGxNRQitLfzM8KhuxPDLs,10647
 keplemon/enums.py,sha256=5MejXeSwXPtfpIYeNuFQH3LSIRf4aTFZTK2Q1AYyaEg,325
 keplemon/enums.pyi,sha256=OSS71WesYTgzWGUSjpxaYtzj6XmoyLBXq_Zd13IBwyQ,2418
 keplemon/estimation.py,sha256=Of0rHiapW4s1wRipBCZrp4oOiIzs794w1nhqM7AVrGs,236
-keplemon/estimation.pyi,sha256=kH-erT5qhxKVpHm9NehHsZbHbe96FP3aDX6GgwdntAs,5693
+keplemon/estimation.pyi,sha256=SdjAbSmSvdSoeyO_GU0jWdRY319laCbNRa6LJQXe6As,5757
 keplemon/events.py,sha256=gl2eqYWkTtMxLPstZziIbNbeVHJzEiMPyhrFaC-gcmA,376
-keplemon/events.pyi,sha256=8ynzXST5suvr3VGi_Wx7UHaQpuHZjk-ikKOdNGujiyo,3004
+keplemon/events.pyi,sha256=TBE_hK4iummmhL0ERaJu9uzHz4LV4rZAF5LQZmFbD0U,3146
 keplemon/exceptions.py,sha256=kdFwToNBHfbpzj311wHfTDztdgwRg2-OM3sHYhmd3AI,107
 keplemon/libifcoremd.dll,sha256=x8iFLCgtUCJjWdfdmQycUx9BlXcNCW-Q3MeGpcIN12k,1885224
 keplemon/libiomp5md.dll,sha256=C2O3Lj2yJYPGTyH0Z1c4FSrflnSzxHARp6y0dE3H2ZI,2030632
@@ -71,6 +71,6 @@ keplemon/saal/sgp4_prop_interface.py,sha256=biuhXWIsauR4BO8chsWILfb8-E8OdRNWT5cS
 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=fa6AKPPU18lX44emrAy5ZZ5TRam-Vhm8ecsauvQ_wdg,2888
-keplemon/time.pyi,sha256=bS5UrY2loeT2mzONRFl2LTG5ZLaC3EnCXKB8fZRks4Q,6529
-keplemon-1.1.3.dist-info/RECORD,,
+keplemon/time.py,sha256=21gJUjG6ijI34j6Q5NwDisFZN3jXLcBIxoXeQ48D9Ak,3348
+keplemon/time.pyi,sha256=TD60TgcCnAbgo0hnQlD5iMhOmQR57kKs05fGv32oVNY,6914
+keplemon-1.3.0.dist-info/RECORD,,