keplemon 1.0.6__cp312-cp312-win_amd64.whl → 1.1.1__cp312-cp312-win_amd64.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,6 +1,6 @@
-keplemon-1.0.6.dist-info/METADATA,sha256=N2FoAuRlTq2QklipfVMJvGTMfbVhn_N91oIbe8WaLpg,863
-keplemon-1.0.6.dist-info/WHEEL,sha256=4hYCffp0RsSVQAuv2PMtXQ9QS7YSHeZi4PrSg-wi2q0,96
-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=Vushk_AfQsqwYbIXsl4S77IMWqfvHn15JAMZT_B7E3Y,96
+keplemon-1.1.1.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.cp312-win_amd64.pyd,sha256=5jIMRr0rfWbHRjgtjdAPueq2G373WNz18YyF_3Ikc7U,1618432
+keplemon/_keplemon.cp312-win_amd64.pyd,sha256=XCB8a5Ogb8Zf5AhfGirsDxj3CdvkE92c30MvyFUDj-c,1658368
 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=fnwSde5vqtiTSZDyRVEg8YQjF_uTHPkLtcTABw9NcBM,7899
+keplemon/bodies.pyi,sha256=ANgociClcS9hhzvA-g57HHDQfExED3z0QvOxBWWWCiM,8733
 keplemon/catalogs.py,sha256=AKONH7zWBOnUZI0ty0lYiYZtrdILfKivoUgk1nU3PZ8,107
 keplemon/catalogs.pyi,sha256=UxwRVMfuySXNYOQ7KuCXtwHcu3zL3Fgo1sBP77qUKaU,606
 keplemon/elements.py,sha256=Z0zzwjbOnqi4lXO4Iw5Nio2eZcdrlObzAJ2oLRDzyJY,640
@@ -52,8 +52,8 @@ 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,8 +63,8 @@ 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
@@ -73,4 +73,4 @@ keplemon/saal/time_func_interface.py,sha256=C18Q_PIMUFBcB0pHN6wlVj35Vrt83VQNKOEm
 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.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: cp312-cp312-win_amd64