satnogs-predict 0.2__tar.gz → 0.3__tar.gz

{satnogs_predict-0.2 → satnogs_predict-0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: satnogs-predict
-Version: 0.2
+Version: 0.3
 Summary: A package for calculating passes and observation windows for satellites.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -13,8 +13,7 @@ Dynamic: license-file
 [![Pipeline Status](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/badges/main/pipeline.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/pipelines)
 [![Coverage](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/badges/main/coverage.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/pipelines)
 [![PyPI version](https://img.shields.io/pypi/v/satnogs-predict.svg)](https://pypi.org/project/satnogs-predict/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/satnogs-predict.svg)](https://pypi.org/project/satnogs-predict/)
-
+![Python Version](https://img.shields.io/badge/dynamic/toml?url=https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/raw/fb6964df5384da584c1dbb92ac157104c8a3948d/pyproject.toml&query=project.requires-python&label=python)
 ---
 
 ## 🚀 Overview
@@ -45,6 +44,8 @@ pip install satnogs-predict
 from satnogs_predict import find_observation_windows
 ```
 
+For more complete examples and usage patterns, see [docs/docs.md](docs/docs.md).
+
 ## License
 
 [![license](https://img.shields.io/badge/license-AGPL%203.0-6672D8.svg)](LICENSE)

{satnogs_predict-0.2 → satnogs_predict-0.3}/README.md

@@ -3,8 +3,7 @@
 [![Pipeline Status](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/badges/main/pipeline.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/pipelines)
 [![Coverage](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/badges/main/coverage.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/pipelines)
 [![PyPI version](https://img.shields.io/pypi/v/satnogs-predict.svg)](https://pypi.org/project/satnogs-predict/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/satnogs-predict.svg)](https://pypi.org/project/satnogs-predict/)
-
+![Python Version](https://img.shields.io/badge/dynamic/toml?url=https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/raw/fb6964df5384da584c1dbb92ac157104c8a3948d/pyproject.toml&query=project.requires-python&label=python)
 ---
 
 ## 🚀 Overview
@@ -35,6 +34,8 @@ pip install satnogs-predict
 from satnogs_predict import find_observation_windows
 ```
 
+For more complete examples and usage patterns, see [docs/docs.md](docs/docs.md).
+
 ## License
 
 [![license](https://img.shields.io/badge/license-AGPL%203.0-6672D8.svg)](LICENSE)

{satnogs_predict-0.2 → satnogs_predict-0.3}/docs/docs.md

@@ -44,6 +44,7 @@ from satnogs_predict import (
     get_and_validate_pass_from_range,
     check_observation_density_limit_respected,
     has_range_list_overlap,
+    generate_fake_tle,
 
     MaxDurationConstraint,
     MinCulminationConstraint,
@@ -86,6 +87,20 @@ satellite = Satellite.from_tle(
 )
 ```
 
+For testing or development, you can also generate a synthetic TLE:
+
+```python
+from datetime import datetime, timezone
+
+fake_tle = generate_fake_tle(
+    latitude=37.983810,
+    longitude=23.727539,
+    date=datetime(2026, 3, 6, 12, 0, 0, tzinfo=timezone.utc),
+)
+
+line0, line1, line2 = fake_tle.to_list()
+```
+
 
 ## 3.2 - Observer
 

{satnogs_predict-0.2 → satnogs_predict-0.3}/src/satnogs_predict/__init__.py

@@ -3,7 +3,9 @@ from .constraints import *  # noqa: F401,F403
 from .core.engine import find_observation_windows, get_and_validate_pass_from_range
 from .domain import *  # noqa: F401,F403
 from .planning.planner import check_observation_density_limit_respected, has_range_list_overlap
+from .tle import generate_fake_tle
 
 __all__ = list(domain.__all__) + list(constraints.__all__)
 __all__ += ["check_observation_density_limit_respected", "has_range_list_overlap"]
 __all__ += ["find_observation_windows", "get_and_validate_pass_from_range"]
+__all__ += ["generate_fake_tle"]

{satnogs_predict-0.2 → satnogs_predict-0.3}/src/satnogs_predict/domain/orbit.py

@@ -15,6 +15,9 @@ class TLE:
     def __post_init__(self) -> None:
         ensure_required_fields_not_none(self)
 
+    def to_list(self) -> list[str]:
+        return [self.line0, self.line1, self.line2]
+
 
 class OrbitRepresentation(IntEnum):
     TLE = 0

satnogs_predict-0.3/src/satnogs_predict/tle.py

@@ -0,0 +1,107 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from datetime import datetime, timezone
+
+from skyfield.api import load  # type: ignore[import-untyped]
+
+from satnogs_predict.domain.orbit import TLE
+
+_ts = load.timescale()
+
+
+@dataclass(frozen=True)
+class FakeTLEParameters:
+    name: str = "FAKESAT-1"
+    catalog_num: int = 0
+    classifier: str = "U"
+    cospar_id: str = "00000A"
+    mean_motion_first: str = ".00000000"
+    mean_motion_second: str = "00000-0"
+    drag_term: str = "50000-4"
+    set_number: str = "0"
+    inclination: str = "90.0000"
+    eccentricity: str = "0001000"
+    argument_perigee: str = "000.0000"
+    mean_motion: str = "15.50000000"
+    revolutions: str = "0"
+
+
+DEFAULT_FAKE_TLE_PARAMETERS = FakeTLEParameters()
+
+
+def _tle_checksum(line_without_checksum: str) -> int:
+    total = 0
+    for char in line_without_checksum:
+        if char.isdigit():
+            total += int(char)
+        elif char == "-":
+            total += 1
+    return total % 10
+
+
+def _epoch_day_of_year_fraction(epoch: datetime) -> float:
+    year_start = datetime(epoch.year, 1, 1, tzinfo=timezone.utc)
+    delta = epoch - year_start
+    day = delta.days + 1
+    day_fraction = (delta.seconds + delta.microseconds / 1_000_000) / 86_400
+    return day + day_fraction
+
+
+def generate_fake_tle(
+    latitude: float,
+    longitude: float,
+    date: datetime,
+    params: FakeTLEParameters = DEFAULT_FAKE_TLE_PARAMETERS,
+) -> TLE:
+    """
+    Generate a deterministic, synthetic TLE from observer coordinates and an epoch.
+
+    The result is intended for testing and development scenarios where a plausible
+    but not physically accurate TLE is sufficient.
+    """
+    if date.tzinfo is None:
+        raise ValueError("date must be timezone-aware")
+
+    epoch = date.astimezone(timezone.utc)
+    skyfield_time = _ts.from_datetime(epoch)
+
+    # Derived values
+    right_ascension = (skyfield_time.gmst * 15.0 + longitude) % 360.0
+    mean_anomaly = latitude % 360.0
+
+    epoch_year = epoch.year
+    epoch_day = _epoch_day_of_year_fraction(epoch)
+
+    line0 = params.name.ljust(24)
+
+    line1_no_checksum = (
+        "1 {:5.5}{:.1} {:8.8} {:.2}{:012.8f} {:>10.10} {:>8.8} {:>8.8} 0 {:>4.4}".format(
+            f"{params.catalog_num:05d}",
+            params.classifier,
+            params.cospar_id,
+            str(epoch_year),
+            epoch_day,
+            params.mean_motion_first,
+            params.mean_motion_second,
+            params.drag_term,
+            params.set_number,
+        )
+    )
+
+    line2_no_checksum = (
+        "2 {:>5.5} {:>8.8} {:>8.4f} {:>7.7} {:>8.8} {:>8.4f} {:>11.11}{:>5.5}".format(
+            f"{params.catalog_num:05d}",
+            params.inclination,
+            right_ascension,
+            params.eccentricity,
+            params.argument_perigee,
+            mean_anomaly,
+            params.mean_motion,
+            params.revolutions,
+        )
+    )
+
+    line1 = f"{line1_no_checksum}{_tle_checksum(line1_no_checksum)}"
+    line2 = f"{line2_no_checksum}{_tle_checksum(line2_no_checksum)}"
+    return TLE(line0=line0, line1=line1, line2=line2)

{satnogs_predict-0.2 → satnogs_predict-0.3}/src/satnogs_predict.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: satnogs-predict
-Version: 0.2
+Version: 0.3
 Summary: A package for calculating passes and observation windows for satellites.
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -13,8 +13,7 @@ Dynamic: license-file
 [![Pipeline Status](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/badges/main/pipeline.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/pipelines)
 [![Coverage](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/badges/main/coverage.svg)](https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/pipelines)
 [![PyPI version](https://img.shields.io/pypi/v/satnogs-predict.svg)](https://pypi.org/project/satnogs-predict/)
-[![Python Versions](https://img.shields.io/pypi/pyversions/satnogs-predict.svg)](https://pypi.org/project/satnogs-predict/)
-
+![Python Version](https://img.shields.io/badge/dynamic/toml?url=https://gitlab.com/librespacefoundation/satnogs/satnogs-predict/-/raw/fb6964df5384da584c1dbb92ac157104c8a3948d/pyproject.toml&query=project.requires-python&label=python)
 ---
 
 ## 🚀 Overview
@@ -45,6 +44,8 @@ pip install satnogs-predict
 from satnogs_predict import find_observation_windows
 ```
 
+For more complete examples and usage patterns, see [docs/docs.md](docs/docs.md).
+
 ## License
 
 [![license](https://img.shields.io/badge/license-AGPL%203.0-6672D8.svg)](LICENSE)

{satnogs_predict-0.2 → satnogs_predict-0.3}/src/satnogs_predict.egg-info/SOURCES.txt

@@ -11,6 +11,7 @@ uv.lock
 docs/docs.md
 src/satnogs_predict/__init__.py
 src/satnogs_predict/py.typed
+src/satnogs_predict/tle.py
 src/satnogs_predict.egg-info/PKG-INFO
 src/satnogs_predict.egg-info/SOURCES.txt
 src/satnogs_predict.egg-info/dependency_links.txt
@@ -36,6 +37,7 @@ src/satnogs_predict/propagation/propagator.py
 tests/__init__.py
 tests/conftest.py
 tests/helpers.py
+tests/test_tle.py
 tests/constraints/test_constraints.py
 tests/core/test_engine.py
 tests/domain/test_orbit.py

{satnogs_predict-0.2 → satnogs_predict-0.3}/tests/domain/test_orbit.py

@@ -3,6 +3,13 @@ from __future__ import annotations
 from satnogs_predict.domain.orbit import TLE, OrbitRepresentation, Satellite
 
 
+class TestTle:
+    def test_given_tle_when_to_list_then_returns_three_lines_in_order(self) -> None:
+        tle = TLE(line0="LINE0", line1="LINE1", line2="LINE2")
+
+        assert tle.to_list() == ["LINE0", "LINE1", "LINE2"]
+
+
 class TestSatelliteFromTle:
     def test_given_no_identifier_when_created_then_uses_line0(self) -> None:
         line0 = "ISS (ZARYA)"

satnogs_predict-0.3/tests/test_tle.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from datetime import datetime, timezone
+
+import pytest
+from skyfield.api import EarthSatellite, load  # type: ignore[import-untyped]
+
+from satnogs_predict import generate_fake_tle
+
+ts = load.timescale()
+
+
+def _checksum(line_without_checksum: str) -> int:
+    total = 0
+    for char in line_without_checksum:
+        if char.isdigit():
+            total += int(char)
+        elif char == "-":
+            total += 1
+    return total % 10
+
+
+class TestGenerateFakeTle:
+    def test_given_valid_input_when_generated_then_returns_parseable_tle(self) -> None:
+        tle = generate_fake_tle(
+            latitude=37.9838,
+            longitude=23.7275,
+            date=datetime(2026, 3, 6, 12, 0, 0, tzinfo=timezone.utc),
+        )
+
+        assert len(tle.line1) == 69
+        assert len(tle.line2) == 69
+        assert tle.line1[-1] == str(_checksum(tle.line1[:-1]))
+        assert tle.line2[-1] == str(_checksum(tle.line2[:-1]))
+
+        sat = EarthSatellite(tle.line1, tle.line2, tle.line0, ts)
+        assert sat.name == tle.line0.strip()
+
+    def test_given_same_input_when_generated_twice_then_result_is_deterministic(self) -> None:
+        date = datetime(2026, 3, 6, 12, 0, 0, tzinfo=timezone.utc)
+
+        tle1 = generate_fake_tle(latitude=10.0, longitude=20.0, date=date)
+        tle2 = generate_fake_tle(latitude=10.0, longitude=20.0, date=date)
+
+        assert tle1 == tle2
+
+    def test_given_naive_date_when_generated_then_raises(self) -> None:
+        with pytest.raises(ValueError, match="timezone-aware"):
+            generate_fake_tle(
+                latitude=0.0,
+                longitude=0.0,
+                date=datetime(2026, 3, 6, 12, 0, 0),
+            )