keplemon 0.3.3__cp313-cp313-win_amd64.whl → 1.0.0__cp313-cp313-win_amd64.whl

keplemon/bodies.pyi

@@ -17,12 +17,11 @@ class Earth:
     def get_kem() -> float: ...
 
 class Satellite:
-    satellite_id: int
-    """Number used to distinguish the satellite from other objects.
-    
-    !!! note
-        Every attempt should be made to make this unique to support satellite methods that perform comparisons or
-        bookkeeping.
+    id: str
+    """Unique identifier for the satellite."""
+
+    norad_id: int
+    """Number corresponding to the satellite's NORAD catalog ID.
     """
     name: str | None
     """Human-readable name of the satellite"""
@@ -100,7 +99,7 @@ class Constellation:
         start: Epoch,
         end: Epoch,
         step: TimeSpan,
-    ) -> dict[int, Ephemeris]:
+    ) -> dict[str, Ephemeris]:
         """
         Args:
             start: UTC epoch of the start of the ephemeris
@@ -155,7 +154,7 @@ class Constellation:
         """
         ...
 
-    def __getitem__(self, satellite_id: int) -> Satellite: ...
+    def __getitem__(self, satellite_id: str) -> Satellite: ...
     def get_horizon_access_report(
         self,
         site: Observatory,

keplemon/catalogs.pyi

@@ -8,9 +8,9 @@ class TLECatalog:
     @classmethod
     def from_tle_file(cls, filename: str) -> TLECatalog: ...
     def add(self, tle: TLE) -> None: ...
-    def get(self, satellite_id: int) -> TLE: ...
-    def remove(self, satellite_id: int) -> None: ...
-    def keys(self) -> list[int]: ...
+    def get(self, satellite_id: str) -> TLE: ...
+    def remove(self, satellite_id: str) -> None: ...
+    def keys(self) -> list[str]: ...
     def get_count(self) -> int: ...
     def clear(self) -> None: ...
-    def __getitem__(self, satellite_id: int) -> TLE: ...
+    def __getitem__(self, satellite_id: str) -> TLE: ...

keplemon/elements.pyi

@@ -90,7 +90,11 @@ class KeplerianElements:
     ) -> None: ...
 
 class TLE:
-    satellite_id: int
+
+    norad_id: int
+    """NORAD catalog ID of the satellite"""
+
+    satellite_id: str
     """"""
 
     name: str

keplemon/saal/astro_func_interface.py

@@ -2,6 +2,7 @@ from keplemon._keplemon.saal.astro_func_interface import (  # type: ignore
     teme_to_topo,
     ra_dec_to_az_el_time,
     ra_dec_to_az_el,
+    mean_motion_to_sma,
     XA_TOPO_RA,
     XA_TOPO_DEC,
     XA_TOPO_AZ,
@@ -30,4 +31,5 @@ __all__ = [
     "XA_TOPO_ELDOT",
     "XA_TOPO_RANGEDOT",
     "XA_TOPO_SIZE",
+    "mean_motion_to_sma",
 ]

keplemon/saal/astro_func_interface.pyi

@@ -1,5 +1,17 @@
 # flake8: noqa: F401
 
+def mean_motion_to_sma(mean_motion: float) -> float:
+    """
+    Convert mean motion to semi-major axis.
+
+    Args:
+        mean_motion: Mean motion in revolutions/day.
+
+    Returns:
+        Semi-major axis in kilometers.
+    """
+    ...
+
 def ra_dec_to_az_el(
     theta: float,
     lat: float,

keplemon-1.0.0.dist-info/METADATA

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: keplemon
+Version: 1.0.0
+Requires-Dist: requests
+Requires-Dist: click
+Requires-Dist: maturin>=1.0,<2.0 ; extra == 'dev'
+Requires-Dist: keplemon[test] ; extra == 'dev'
+Requires-Dist: mkdocstrings[python] ; extra == 'dev'
+Requires-Dist: mkdocs-material ; extra == 'dev'
+Requires-Dist: markdown-include ; extra == 'dev'
+Requires-Dist: tomli ; python_full_version < '3.11' and extra == 'dev'
+Requires-Dist: pytest ; extra == 'test'
+Provides-Extra: dev
+Provides-Extra: test
+Summary: Citra Space Corporation's Rust-accelerated astrodynamics library.
+Author-email: Brandon Sexton <brandon@citra.space>
+License-Expression: MIT
+Requires-Python: >=3.9
+Project-URL: Documentation, https://keplemon.citra.space
+Project-URL: Repository, https://github.com/citra-space/keplemon.git
+Project-URL: Issues, https://github.com/citra-space/keplemon/issues

{keplemon-0.3.3.dist-info → keplemon-1.0.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
-keplemon-0.3.3.dist-info/METADATA,sha256=ebzVnPrH-QKb08UKH8Bg2U9HnCICe_9do36rAEifJps,4249
-keplemon-0.3.3.dist-info/WHEEL,sha256=oXe_QNnB5QbkkMcbfZh2d88Kje6edNs5JzpWke0-klE,96
-keplemon-0.3.3.dist-info/entry_points.txt,sha256=eYbCkvQvWfRDQ0LzaCELov1xeLAxQEHlfdgNq-LXyb0,49
+keplemon-1.0.0.dist-info/METADATA,sha256=-5xvAQVYzKt011pNsM6bT83WOZEnqkRlpMQBfy7nYdM,863
+keplemon-1.0.0.dist-info/WHEEL,sha256=DfU-bXnJK60cJceeC-xy2sa_ryw_ZpNrTnTQMSW4eNA,96
+keplemon-1.0.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=5lIXTAZtmxffYAqL-NtNcFkjui4hDJD54Cjla1sOcZQ,1484800
+keplemon/_keplemon.cp313-win_amd64.pyd,sha256=v-479Kzbdce89blNdKJj0z-aaVhDjObLs91JnCKRgE4,1500672
 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,11 +43,11 @@ 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=RJ1hgKQMU37-w861rtyJwpkvdJfyJsiYPsr57VL2Nng,7443
+keplemon/bodies.pyi,sha256=US0kcDcJz8Ypv75bsx0BYHjZJdPUkDfETEwoz63OhQI,7342
 keplemon/catalogs.py,sha256=AKONH7zWBOnUZI0ty0lYiYZtrdILfKivoUgk1nU3PZ8,107
-keplemon/catalogs.pyi,sha256=xcXEaiQY4wNvd95YdQDmqjD-nkirc_phSwL256Fejuc,540
+keplemon/catalogs.pyi,sha256=0xKUNjmioF_cd5atqiGbRxaZuTUIBr2hbEJ0J0A4c-s,540
 keplemon/elements.py,sha256=AzE0xyBNDynGtBcIkpQaV7qHW-xNdA9bFkIcr5CC1oY,506
-keplemon/elements.pyi,sha256=k-sALyXTHhU1YDyvV4RDDsjpTuHCJBD4J8GjLLpB2Q8,9743
+keplemon/elements.pyi,sha256=qbUm5uQ9FNjQP5b99K8NxeaC6xnDSSaaY8NnofoAJIg,9811
 keplemon/enums.py,sha256=5MejXeSwXPtfpIYeNuFQH3LSIRf4aTFZTK2Q1AYyaEg,325
 keplemon/enums.pyi,sha256=OSS71WesYTgzWGUSjpxaYtzj6XmoyLBXq_Zd13IBwyQ,2418
 keplemon/estimation.py,sha256=Of0rHiapW4s1wRipBCZrp4oOiIzs794w1nhqM7AVrGs,236
@@ -63,12 +63,12 @@ keplemon/propagation.pyi,sha256=ZWqjxwg4MQebRukTysK2ZyTtIxvAyZIkUybO3wsZO9Q,483
 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=4hhtCVWBYdBBOlvQXt7XJuDJ5lWk8GbsV3iSJfkkFfc,685
-keplemon/saal/astro_func_interface.pyi,sha256=Dx4ryXnpDK9ZnFL6afkIvTu3rH14Wi8q3rRxeY0Qoew,2557
+keplemon/saal/astro_func_interface.py,sha256=6Y26Qtpg-vf4K5pya2DRzPyv4_4vnp9vmnribbpqYyw,737
+keplemon/saal/astro_func_interface.pyi,sha256=b0QKQhoeBWZ1ouuux9ZoojHpNNnHlNz_bi8kalBgSA0,2808
 keplemon/saal/obs_interface.py,sha256=ax8T4Y61pWh3VnQ4K2bCDNdrK-H6WKWr14pEDAY8WxE,257
 keplemon/saal/obs_interface.pyi,sha256=Y9PE1t2Kdz1Sne1t_M-ctOp9G4hWGKgMMkuES6v1U6Q,235
 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-0.3.3.dist-info/RECORD,,
+keplemon-1.0.0.dist-info/RECORD,,

{keplemon-0.3.3.dist-info → keplemon-1.0.0.dist-info}/WHEEL

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

keplemon-0.3.3.dist-info/METADATA

@@ -1,114 +0,0 @@
-Metadata-Version: 2.4
-Name: keplemon
-Version: 0.3.3
-Requires-Dist: requests
-Requires-Dist: click
-Requires-Dist: maturin>=1.0,<2.0 ; extra == 'dev'
-Requires-Dist: keplemon[test] ; extra == 'dev'
-Requires-Dist: mkdocstrings[python] ; extra == 'dev'
-Requires-Dist: mkdocs-material ; extra == 'dev'
-Requires-Dist: markdown-include ; extra == 'dev'
-Requires-Dist: tomli ; python_full_version < '3.11' and extra == 'dev'
-Requires-Dist: pytest ; extra == 'test'
-Provides-Extra: dev
-Provides-Extra: test
-Summary: Citra Space Corporation's Rust-accelerated astrodynamics library.
-Author-email: Brandon Sexton <brandon@citra.space>
-License: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Documentation, https://keplemon.citra.space
-Project-URL: Repository, https://github.com/citra-space/keplemon.git
-Project-URL: Issues, https://github.com/citra-space/keplemon/issues
-
-# KepLemon
-
-[Citra Space Corporation's](https://citra.space) Rust-accelerated astrodynamics package built on the shared libraries
-provided by [space-track](https://space-track.org). Please visit the [documentation](https://keplemon.citra.space)
-page for additional details.
-
-## Installation
-
-### From PyPI (Preferred)
-
-KepLemon can be installed directly for any operating system from a command line using `pip install keplemon`.
-
-### From a Local Build
-
-For python users, the **_preferred installation method is through [PyPI](https://www.pypi.org)_**; however, the package can be
-installed locally by following the steps below.
-
-1. `git clone https://github.com/citra-space/keplemon.git`
-2. `cargo install cargo-make`
-3. `cargo make build-<os>-<architecture>` (e.g. for Linux x86 `cargo make build-linux-x86`)
-4. `pip install target/wheels/*.whl`
-
-To avoid potential conflicts with system libraries, you can alternatively build the wheel using Docker.
-
-```bash
-docker buildx build \
-  --build-arg OS="${OS:-linux}" \
-  --build-arg ARCH="${ARCH:-x86}" \
-  --build-arg PYTHON_VERSION="${PYTHON_VERSION:-310}" \
-  --output type=local,dest=./target .
-```
-
-Then install the wheel the same way with:
-`pip install target/wheels/*.whl`
-
-## Environment Settings
-
-Although not required, it is recommended to explicitly apply the settings in this section before using KepLemon to avoid
-unexpected behaviors and inaccurate calculations.
-
-### CPU Limits
-
-By default, KepLemon will have access to all available cores when performing parallel functions. Limit this by calling
-`set_thread_count` **_before_** using other KepLemon functions.
-
-```python
-from keplemon import set_thread_count, get_thread_count
-
-# Update this to the desired core count
-set_thread_count(4)
-```
-
-### Time Constants and Earth-Orientation Parameters (EOP)
-
-All astrodynamics packages have a strict dependence on measured changes to time and Earth's orientation. Since KepLemon
-uses the public Standardized Astrodynamics Algorithms Library (SAAL) at the core, the time and (EOP) data must conform
-to a specific format required by the underlying binaries. Rather than referencing data directly provided by the
-[USNO](https://maia.usno.navy.mil/), utility scripts are provided in KepLemon to request and export the relevant data.
-
-#### Global Update
-
-Use the command below from a terminal to update time constants and EOP data package-wide.
-
-```bash
-keplemon --update-eop global
-```
-
-#### Local Override
-
-EOP data can also be written to explicit paths for inspection or package overrides using the commands below.
-
-```bash
-keplemon --update-eop custom_path.txt
-```
-
-!!! note
-If you intend to use the data written to a local override, you must use the `load_time_constants` method at the
-beginning of your scripts. **_This is not needed if you maintain constants using the global method_**.
-
-```python
-from keplemon.time import load_time_constants
-
-# Update this to reflect the desired override path
-load_time_constants("custom_path.txt")
-```
-
-## Contributing
-
-Anyone is welcome to contribute to KepLemon. Users are encouraged to start by opening issues or forking the repository.
-Changes directly to the baseline may be approved by contacting the owner at <brandon@citra.space>.
-