keplemon 0.3.3__cp311-cp311-macosx_11_0_arm64.whl → 1.0.0__cp311-cp311-macosx_11_0_arm64.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,10 +1,10 @@
-keplemon-0.3.3.dist-info/METADATA,sha256=ftj1MBl3mYuEDk9WgcUnibGTGChWrgMfiRECC6e04-g,4159
-keplemon-0.3.3.dist-info/WHEEL,sha256=4POUqOUvk-fNEqEa1NBlmMsgWQGl6FnEg9vsbsvEmNM,104
-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=FQD2wNSk7QdKfwuvlrA52DGgdDYb2Xq1PtLwlu6bv-w,104
+keplemon-1.0.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-311-darwin.so,sha256=DV4xxoKh6_18VM1FVITMHb30Oa-PsN__TUXAc_xc1Pg,1823232
+keplemon/_keplemon.cpython-311-darwin.so,sha256=DfwiLXti-Zluxcxe9guS4xu8PGut_-n8MUk41x8AZcI,1862496
 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,11 +17,11 @@ 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=2kxW_n6skCf_QuVUGM_CeZIwf1UOyXu1TKCp_Y_txDk,7189
+keplemon/bodies.pyi,sha256=X6hXvrGJ4wGqc0Nbn04PvSbeo7U71jTPC5vC6xTER-U,7089
 keplemon/catalogs.py,sha256=lw71NiXlVtb-z3pQR03afxtkLca4HJcnpZ6kDCcR-Lk,102
-keplemon/catalogs.pyi,sha256=NlWv2E7g5JH8LZyyPCDe9Lh_Me5Fmpv3sPinnbJpLf8,524
+keplemon/catalogs.pyi,sha256=ls2HTk7CMGnxutyR5XLsVtzMuB_OoB45-Vhj4BpKQEw,524
 keplemon/elements.py,sha256=QSSiUGN8cA8X85FR-CVfy8lwsNrBtrQbrw9HWr_cH3I,481
-keplemon/elements.pyi,sha256=kkujHEbZykzdBLmhoJW9kWYBrjpI47m9X06vei7GudY,9373
+keplemon/elements.pyi,sha256=8ZbXx4euKeW4Bj5jUhP87npmNoesmD4DpND1u3JxnTs,9437
 keplemon/enums.py,sha256=Jh0tFHg_rZXnOyLUXmHjSm3MSZFbvQKTBcP0BqHXeMY,308
 keplemon/enums.pyi,sha256=s9uqkm3Zrx6HLV4dQBScRiUy0CT4QoQwFjaCLOEMW1c,2330
 keplemon/estimation.py,sha256=2K87pFhOfaFohbAtBXv2SA6m_oIN-56toJOftu350fY,228
@@ -51,12 +51,12 @@ keplemon/propagation.pyi,sha256=YSA3cBzgHLW3_dykrjMX4PbReYJmz5Z7bzfuibPaegc,464
 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=gjXnmJuSmgxPEgLnqUZCP1_m0jHujPgmHt4YkERVcpk,652
-keplemon/saal/astro_func_interface.pyi,sha256=bEystOU2WG3KYeq93SJygnf30QsouHQMRcWlV3Tc0VM,2457
+keplemon/saal/astro_func_interface.py,sha256=uJuJAV4beTHjk5Jr5rHzMkeBFSo-2vDiW818AnIEYPs,702
+keplemon/saal/astro_func_interface.pyi,sha256=8__K4QTOYGAAwgIm5KloUADXNrR3fOrReyiN8RZcVhQ,2696
 keplemon/saal/obs_interface.py,sha256=EtsaPKixjMWfCUpMd79SvhCs3f9sRcBaal6-ickj3Vs,248
 keplemon/saal/obs_interface.pyi,sha256=eIXbFnZSF3cX3MyXaCYLUAp0wUAbJiQ4rosqpXdf2I0,228
 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-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: cp311-cp311-macosx_11_0_arm64

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>.
-