keplemon 1.0.5__cp312-cp312-macosx_10_12_x86_64.whl → 1.1.0__cp312-cp312-macosx_10_12_x86_64.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,10 +1,10 @@
-keplemon-1.0.5.dist-info/METADATA,sha256=l0b2cTyJbCUpNiCbm8PHD1dSWuq1kEpseFXtf80GMIw,863
-keplemon-1.0.5.dist-info/WHEEL,sha256=vOxQgEJOLLbJ-XpfttO2_O8fNiBfK7Khn1PQTYnkd8c,106
-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=IL3YV51tpydQP7kj9OmuredpauMtSrvXdJ-izRXxqss,106
+keplemon-1.1.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-312-darwin.so,sha256=VK1JLvq9BSyLz7TY1ZAfpT3p2278Nbei8zA3R817Gak,1983108
+keplemon/_keplemon.cpython-312-darwin.so,sha256=TpWLG3Mk9bNeDrSzf8YXA25Vyd9EYyxQ1CVXzw7ncdw,2145796
 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,17 +17,17 @@ 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=onacYuFwIutSQOKhNJxNfwAvP2oWAZcx1RAPo6tt3oQ,7269
+keplemon/bodies.pyi,sha256=VfG0cH5EsDGAbrViB4pSjJjvBJ03AXdxDWjYxiy152U,8442
 keplemon/catalogs.py,sha256=lw71NiXlVtb-z3pQR03afxtkLca4HJcnpZ6kDCcR-Lk,102
-keplemon/catalogs.pyi,sha256=ls2HTk7CMGnxutyR5XLsVtzMuB_OoB45-Vhj4BpKQEw,524
-keplemon/elements.py,sha256=QSSiUGN8cA8X85FR-CVfy8lwsNrBtrQbrw9HWr_cH3I,481
-keplemon/elements.pyi,sha256=8ZbXx4euKeW4Bj5jUhP87npmNoesmD4DpND1u3JxnTs,9437
+keplemon/catalogs.pyi,sha256=NU_6Mc_JY8xTYAKXOqubtPnt91YA9ZHd1hMqMFf6onc,589
+keplemon/elements.py,sha256=P4tlpQpCUG5jkgAT_yIeL2V14AhXtekMYxRBOsPlOgc,609
+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/events.py,sha256=lxSp5m5FhIyU2-1CrSlbRE15E5yh7sf_mTt9uYQwMKA,238
-keplemon/events.pyi,sha256=ilmvy403FzGw1d8nlO7yueVZu836ufjiPImG4rKYVmg,2025
+keplemon/events.py,sha256=PGp-xE-eyjYSMWpugplA7bPlrYjkR1NKSHRurFMnBcE,359
+keplemon/events.pyi,sha256=_5pqLG1wrzC9CD5KQtFuu8VSF8KtbY_FyqvLqgJCqx8,2813
 keplemon/exceptions.py,sha256=gTKSkN4yJ2VwR3_anpWqnIO9kQcJCO41_818NjgItiM,102
 keplemon/libastrofunc.dylib,sha256=gxdCt5hXXE3kKj1SawDDATv1h3SfMq8T3jh_SXCCJNA,283104
 keplemon/libdllmain.dylib,sha256=fAVsGh33yYOp-4AoF5kE6d5DlNRmDV1G-tM6-2ENaBY,87376
@@ -51,12 +51,14 @@ keplemon/propagation.pyi,sha256=qJOCbtgYma4MOg3-aw9_r1IvBDnknwsJlMwlgaJiEZk,688
 keplemon/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 keplemon/saal/__init__.py,sha256=aoTB13q7IvXuQ80jgGCnwXA29yjpOqLiTdrtyjyRqLE,123
 keplemon/saal/__init__.pyi,sha256=GPB5f0dcK7srvSDq2i5wvHMyi-OYZakMvlrstKdDwkk,143
-keplemon/saal/astro_func_interface.py,sha256=uJuJAV4beTHjk5Jr5rHzMkeBFSo-2vDiW818AnIEYPs,702
-keplemon/saal/astro_func_interface.pyi,sha256=8__K4QTOYGAAwgIm5KloUADXNrR3fOrReyiN8RZcVhQ,2696
+keplemon/saal/astro_func_interface.py,sha256=_dFUUnT86u0-yIUB7CtztCUQEvbrxT4UhXsvFp92mz4,836
+keplemon/saal/astro_func_interface.pyi,sha256=RZA1JRidGiazZ0TG01Zxe1AIJj9OJwWnyz4LjgXLMiY,3371
 keplemon/saal/obs_interface.py,sha256=EtsaPKixjMWfCUpMd79SvhCs3f9sRcBaal6-ickj3Vs,248
 keplemon/saal/obs_interface.pyi,sha256=eIXbFnZSF3cX3MyXaCYLUAp0wUAbJiQ4rosqpXdf2I0,228
+keplemon/saal/sgp4_prop_interface.py,sha256=BBKlIvXdUypcZspC8GJ2rPqfFoDKy0RM7w5qsqvobrE,127
+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.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: cp312-cp312-macosx_10_12_x86_64