keplemon 1.0.6__cp310-cp310-macosx_11_0_arm64.whl → 1.1.1__cp310-cp310-macosx_11_0_arm64.whl

keplemon/bodies.pyi

@@ -1,8 +1,16 @@
 # flake8: noqa
-from keplemon.elements import TLE, CartesianState, Ephemeris, KeplerianState, GeodeticPosition, OrbitPlotData
+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:
@@ -261,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/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-1.0.6.dist-info → keplemon-1.1.1.dist-info}/METADATA

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

{keplemon-1.0.6.dist-info → keplemon-1.1.1.dist-info}/RECORD

@@ -1,10 +1,10 @@
-keplemon-1.0.6.dist-info/METADATA,sha256=N2FoAuRlTq2QklipfVMJvGTMfbVhn_N91oIbe8WaLpg,863
-keplemon-1.0.6.dist-info/WHEEL,sha256=aXz49xVjjC2bkgTnE4xcanfAmG9wdfNG_Q2OldK7oKM,104
-keplemon-1.0.6.dist-info/entry_points.txt,sha256=eYbCkvQvWfRDQ0LzaCELov1xeLAxQEHlfdgNq-LXyb0,49
+keplemon-1.1.1.dist-info/METADATA,sha256=uYVoCOkt9AffNNbAJkp3WIkgNd76kEWsoNyvT-Dvkcs,863
+keplemon-1.1.1.dist-info/WHEEL,sha256=hbdMQumCjl-rVguoVZczmcIRQSHPkB-MkpGMc912Ge8,104
+keplemon-1.1.1.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-310-darwin.so,sha256=577ab7qr29qIrNVaWA-ivL4SIhtuIn_XcpUU-Hum4ZE,1974256
+keplemon/_keplemon.cpython-310-darwin.so,sha256=c8nGs3HBgUAQckQtcJtCo9vIBlIXNWt9rURPEty6OQE,1982880
 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=vTh2m_sbQ5QN56o_fJr46O-b_mvbQiEUMTRE61cxIXE,7636
+keplemon/bodies.pyi,sha256=VfG0cH5EsDGAbrViB4pSjJjvBJ03AXdxDWjYxiy152U,8442
 keplemon/catalogs.py,sha256=lw71NiXlVtb-z3pQR03afxtkLca4HJcnpZ6kDCcR-Lk,102
 keplemon/catalogs.pyi,sha256=NU_6Mc_JY8xTYAKXOqubtPnt91YA9ZHd1hMqMFf6onc,589
 keplemon/elements.py,sha256=P4tlpQpCUG5jkgAT_yIeL2V14AhXtekMYxRBOsPlOgc,609
@@ -26,8 +26,8 @@ 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=guF0v4MRjoz8Ine-1nLxXYTktvlwHfQHUSa-GKjJZw0,241840
 keplemon/libdllmain.dylib,sha256=eyJQawgeOfDj4lAf2-YSJcvbdJ6abehX5nTChIOOLbs,112144
@@ -51,8 +51,8 @@ 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
@@ -61,4 +61,4 @@ keplemon/saal/time_func_interface.py,sha256=cshqJ15p_gcenMdmVuXTIoLeij1gsgVi0tuj
 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.6.dist-info/RECORD,,
+keplemon-1.1.1.dist-info/RECORD,,

{keplemon-1.0.6.dist-info → keplemon-1.1.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.9.4)
+Generator: maturin (1.9.5)
 Root-Is-Purelib: false
 Tag: cp310-cp310-macosx_11_0_arm64