keplemon 1.0.5__cp311-cp311-win_amd64.whl → 1.1.0__cp311-cp311-win_amd64.whl

keplemon/bodies.pyi

@@ -1,8 +1,16 @@
 # flake8: noqa
-from keplemon.elements import TLE, CartesianState, Ephemeris, KeplerianState
+from keplemon.elements import (
+    TLE,
+    CartesianState,
+    Ephemeris,
+    KeplerianState,
+    GeodeticPosition,
+    OrbitPlotData,
+    TopocentricElements,
+)
 from keplemon.catalogs import TLECatalog
 from keplemon.time import Epoch, TimeSpan
-from keplemon.events import CloseApproach, CloseApproachReport, HorizonAccessReport
+from keplemon.events import CloseApproach, CloseApproachReport, HorizonAccessReport, FieldOfViewReport
 from keplemon.propagation import ForceProperties
 
 class Earth:
@@ -35,6 +43,9 @@ class Satellite:
     keplerian_state: KeplerianState | None
     """Keplerian state of the satellite at the epoch of the TLE, if available"""
 
+    geodetic_position: GeodeticPosition | None
+    """Geodetic position of the satellite at the epoch of the TLE, if available"""
+
     def __init__(self) -> None: ...
     @classmethod
     def from_tle(cls, tle: TLE) -> Satellite:
@@ -68,6 +79,8 @@ class Satellite:
         """
         ...
 
+    def get_plot_data(self, start: Epoch, end: Epoch, step: TimeSpan) -> OrbitPlotData | None: ...
+
 class Constellation:
 
     count: int
@@ -77,6 +90,7 @@ class Constellation:
     """Human-readable name of the constellation"""
 
     def __init__(self) -> None: ...
+    def get_plot_data(self, start: Epoch, end: Epoch, step: TimeSpan) -> dict[str, OrbitPlotData]: ...
     @classmethod
     def from_tle_catalog(cls, tle_catalog: TLECatalog) -> Constellation:
         """
@@ -255,3 +269,23 @@ class Observatory:
             Horizon access report for the satellite from the observatory
         """
         ...
+
+    def get_field_of_view_report(
+        self,
+        epoch: Epoch,
+        sensor_direction: TopocentricElements,
+        angular_threshold: float,
+        sats: Constellation,
+    ) -> FieldOfViewReport:
+        """
+        Calculate field of view report for a sensor at the observatory.
+
+        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
+        """
+        ...

keplemon/catalogs.pyi

@@ -1,5 +1,5 @@
 # flake8: noqa
-from keplemon.elements import TLE
+from keplemon.elements import TLE, OrbitPlotData
 
 class TLECatalog:
     count: int
@@ -14,3 +14,4 @@ class TLECatalog:
     def get_count(self) -> int: ...
     def clear(self) -> None: ...
     def __getitem__(self, satellite_id: str) -> TLE: ...
+    def get_plot_data(self) -> OrbitPlotData: ...

keplemon/elements.py

@@ -9,6 +9,9 @@ from keplemon._keplemon.elements import (  # type: ignore
     TopocentricElements,
     HorizonState,
     HorizonElements,
+    GeodeticPosition,
+    OrbitPlotData,
+    OrbitPlotState,
 )
 
 __all__ = [
@@ -22,4 +25,7 @@ __all__ = [
     "TopocentricElements",
     "HorizonState",
     "HorizonElements",
+    "GeodeticPosition",
+    "OrbitPlotData",
+    "OrbitPlotState",
 ]

keplemon/elements.pyi

@@ -4,6 +4,39 @@ from keplemon.time import Epoch
 from keplemon.enums import Classification, KeplerianType, ReferenceFrame
 from keplemon.events import CloseApproach
 
+class OrbitPlotData:
+    satellite_id: str
+    epochs: list[str]
+    semi_major_axes: list[float]
+    eccentricities: list[float]
+    inclinations: list[float]
+    raans: list[float]
+    radii: list[float]
+    apogee_radii: list[float]
+    perigee_radii: list[float]
+    latitudes: list[float]
+    longitudes: list[float]
+    altitudes: list[float]
+
+class GeodeticPosition:
+    """
+    Args:
+        latitude: Latitude in **_degrees_**
+        longitude: Longitude in **_degrees_**
+        altitude: Altitude in **_kilometers_**
+    """
+
+    latitude: float
+    """Latitude in **_degrees_**"""
+
+    longitude: float
+    """Longitude in **_degrees_**"""
+
+    altitude: float
+    """Altitude in **_kilometers_**"""
+
+    def __init__(self, latitude: float, longitude: float, altitude: float) -> None: ...
+
 class HorizonElements:
     """
     Args:

keplemon/events.py

@@ -3,6 +3,15 @@ from keplemon._keplemon.events import (  # type: ignore
     CloseApproachReport,
     HorizonAccess,
     HorizonAccessReport,
+    FieldOfViewCandidate,
+    FieldOfViewReport,
 )
 
-__all__ = ["CloseApproach", "CloseApproachReport", "HorizonAccess", "HorizonAccessReport"]
+__all__ = [
+    "CloseApproach",
+    "CloseApproachReport",
+    "HorizonAccess",
+    "HorizonAccessReport",
+    "FieldOfViewCandidate",
+    "FieldOfViewReport",
+]

keplemon/events.pyi

@@ -1,6 +1,29 @@
 # flake8: noqa
 from keplemon.time import Epoch, TimeSpan
-from keplemon.elements import HorizonState
+from keplemon.elements import HorizonState, CartesianVector, TopocentricElements
+
+class FieldOfViewCandidate:
+    satellite_id: str
+    """ID of the candidate satellite"""
+
+    direction: TopocentricElements
+    """Measured direction to the candidate satellite in the sensor's topocentric frame"""
+
+class FieldOfViewReport:
+    epoch: Epoch
+    """UTC epoch of the field of view report"""
+
+    sensor_position: CartesianVector
+    """TEME position of the sensor in the observatory's topocentric frame in **_kilometers_**"""
+
+    sensor_direction: TopocentricElements
+    """Direction of the sensor in the observatory's topocentric frame"""
+
+    fov_angle: float
+    """Field of view angle of the sensor in **_degrees_**"""
+
+    candidates: list[FieldOfViewCandidate]
+    """List of candidate satellites within the field of view"""
 
 class CloseApproach:
     epoch: Epoch

keplemon/saal/astro_func_interface.py

@@ -3,6 +3,7 @@ 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,
+    topo_date_to_equinox,
     XA_TOPO_RA,
     XA_TOPO_DEC,
     XA_TOPO_AZ,
@@ -14,6 +15,8 @@ from keplemon._keplemon.saal.astro_func_interface import (  # type: ignore
     XA_TOPO_ELDOT,
     XA_TOPO_RANGEDOT,
     XA_TOPO_SIZE,
+    YROFEQNX_2000,
+    YROFEQNX_CURR,
 )
 
 __all__ = [
@@ -32,4 +35,7 @@ __all__ = [
     "XA_TOPO_RANGEDOT",
     "XA_TOPO_SIZE",
     "mean_motion_to_sma",
+    "topo_date_to_equinox",
+    "YROFEQNX_2000",
+    "YROFEQNX_CURR",
 ]

keplemon/saal/astro_func_interface.pyi

@@ -78,6 +78,21 @@ def teme_to_topo(
     """
     ...
 
+def topo_date_to_equinox(yr_of_equinox: int, ds50utc: float, ra: float, dec: float) -> tuple[float, float]:
+    """
+    Convert topocentric right ascension and declination to equinox coordinates for a given year of equinox.
+
+    Args:
+        yr_of_equinox: Year of the equinox (e.g., 2000 for J2000).
+        ds50utc: Epoch in DS50 UTC format.
+        ra: Topocentric right ascension in degrees.
+        dec: Topocentric declination in degrees.
+
+    Returns:
+        A tuple containing the equinox right ascension and declination in degrees.
+    """
+    ...
+
 XA_TOPO_AZ: int
 """Index for topocentric azimuth in degrees."""
 
@@ -110,3 +125,9 @@ XA_TOPO_DEC: int
 
 XA_TOPO_SIZE: int
 """Size of XA_TOPO_ array"""
+
+YROFEQNX_2000: int
+"""Year of equinox 2000 constant"""
+
+YROFEQNX_CURR: int
+"""Year of current equinox constant"""

keplemon/saal/sgp4_prop_interface.py

@@ -0,0 +1,7 @@
+from keplemon._keplemon.saal.sgp4_prop_interface import (  # type: ignore
+    reepoch_tle,
+)
+
+__all__ = [
+    "reepoch_tle",
+]

keplemon/saal/sgp4_prop_interface.pyi

@@ -0,0 +1,9 @@
+def reepoch_tle(tle_key: int, new_ds50_epoch: float) -> None:
+    """
+    Re-epoch a TLE in the SGP4 propagator.
+
+    Args:
+        tle_key: Key of the TLE to re-epoch.
+        new_ds50_epoch: New epoch in DS50 format.
+    """
+    ...

{keplemon-1.0.5.dist-info → keplemon-1.1.0.dist-info}/METADATA

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

{keplemon-1.0.5.dist-info → keplemon-1.1.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
-keplemon-1.0.5.dist-info/METADATA,sha256=l0b2cTyJbCUpNiCbm8PHD1dSWuq1kEpseFXtf80GMIw,863
-keplemon-1.0.5.dist-info/WHEEL,sha256=Ncll1xfKuKRSH9zs2vSEuHQoNZLcJWpzadJbiEni0qk,96
-keplemon-1.0.5.dist-info/entry_points.txt,sha256=eYbCkvQvWfRDQ0LzaCELov1xeLAxQEHlfdgNq-LXyb0,49
+keplemon-1.1.0.dist-info/METADATA,sha256=8Ob7y_2GYYtVzAUssxxuo4Mj4HH7eR-sPjzOvE7eaWU,863
+keplemon-1.1.0.dist-info/WHEEL,sha256=YCZ9Vxhf2aXNyfoR2QH-PPqnUr48Igr9zjgnGhp3xTc,96
+keplemon-1.1.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.cp311-win_amd64.pyd,sha256=mbBWFV0i9Ki1_D6uusZg5osCWdeJy4XIUZt68lwTkgU,1480192
+keplemon/_keplemon.cp311-win_amd64.pyd,sha256=tbeza-XTjhaOfOYI25kzlCzruzo7ojTWzfUqKUHwv8s,1626112
 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,17 +43,17 @@ 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=Cw-Bs_UG96VN-8TZOqmr9QoB-gwfA9q6NBvLeLJiawA,7526
+keplemon/bodies.pyi,sha256=ANgociClcS9hhzvA-g57HHDQfExED3z0QvOxBWWWCiM,8733
 keplemon/catalogs.py,sha256=AKONH7zWBOnUZI0ty0lYiYZtrdILfKivoUgk1nU3PZ8,107
-keplemon/catalogs.pyi,sha256=0xKUNjmioF_cd5atqiGbRxaZuTUIBr2hbEJ0J0A4c-s,540
-keplemon/elements.py,sha256=AzE0xyBNDynGtBcIkpQaV7qHW-xNdA9bFkIcr5CC1oY,506
-keplemon/elements.pyi,sha256=qbUm5uQ9FNjQP5b99K8NxeaC6xnDSSaaY8NnofoAJIg,9811
+keplemon/catalogs.pyi,sha256=UxwRVMfuySXNYOQ7KuCXtwHcu3zL3Fgo1sBP77qUKaU,606
+keplemon/elements.py,sha256=Z0zzwjbOnqi4lXO4Iw5Nio2eZcdrlObzAJ2oLRDzyJY,640
+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/events.py,sha256=MNf_CCxbTr-MoUoFAbB78rSqKNAT0_EmRjhWFvaGGKI,246
-keplemon/events.pyi,sha256=bncrIlvZbPFEZZf0HIPkDvRqOLIViU0W4_UJdh-pcTo,2098
+keplemon/events.py,sha256=gl2eqYWkTtMxLPstZziIbNbeVHJzEiMPyhrFaC-gcmA,376
+keplemon/events.pyi,sha256=o24TRnO4pZ2gh0aeJvxFsLj_SrBV3s3SvPrAdx0TmxU,2909
 keplemon/exceptions.py,sha256=kdFwToNBHfbpzj311wHfTDztdgwRg2-OM3sHYhmd3AI,107
 keplemon/libifcoremd.dll,sha256=x8iFLCgtUCJjWdfdmQycUx9BlXcNCW-Q3MeGpcIN12k,1885224
 keplemon/libiomp5md.dll,sha256=C2O3Lj2yJYPGTyH0Z1c4FSrflnSzxHARp6y0dE3H2ZI,2030632
@@ -63,12 +63,14 @@ 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=6Y26Qtpg-vf4K5pya2DRzPyv4_4vnp9vmnribbpqYyw,737
-keplemon/saal/astro_func_interface.pyi,sha256=b0QKQhoeBWZ1ouuux9ZoojHpNNnHlNz_bi8kalBgSA0,2808
+keplemon/saal/astro_func_interface.py,sha256=ZiGQm-ysZbH0ocLFzYHgLVGWuNabO5obLMVuv6nSTPQ,877
+keplemon/saal/astro_func_interface.pyi,sha256=cwsPQlowxLr3tj8EKP1wJhd_qOLpk4yRef-PyGCnAxU,3504
 keplemon/saal/obs_interface.py,sha256=ax8T4Y61pWh3VnQ4K2bCDNdrK-H6WKWr14pEDAY8WxE,257
 keplemon/saal/obs_interface.pyi,sha256=Y9PE1t2Kdz1Sne1t_M-ctOp9G4hWGKgMMkuES6v1U6Q,235
+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=fa6AKPPU18lX44emrAy5ZZ5TRam-Vhm8ecsauvQ_wdg,2888
 keplemon/time.pyi,sha256=bS5UrY2loeT2mzONRFl2LTG5ZLaC3EnCXKB8fZRks4Q,6529
-keplemon-1.0.5.dist-info/RECORD,,
+keplemon-1.1.0.dist-info/RECORD,,

{keplemon-1.0.5.dist-info → keplemon-1.1.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.3)
+Generator: maturin (1.9.4)
 Root-Is-Purelib: false
 Tag: cp311-cp311-win_amd64