open-space-toolkit-astrodynamics 16.3.0__py313-none-manylinux2014_x86_64.whl → 16.5.0__py313-none-manylinux2014_x86_64.whl

ostk/astrodynamics/test/trajectory/model/test_tabulated_trajectory.py

@@ -0,0 +1,303 @@
+# Apache License 2.0
+
+import pytest
+
+import numpy as np
+
+from ostk.mathematics.curve_fitting import Interpolator
+
+from ostk.physics.time import Instant
+from ostk.physics.time import DateTime
+from ostk.physics.time import Scale
+from ostk.physics.coordinate import Position
+from ostk.physics.coordinate import Velocity
+from ostk.physics.coordinate import Frame
+
+from ostk.astrodynamics.trajectory import State
+from ostk.astrodynamics.trajectory.model import Tabulated
+
+
+@pytest.fixture
+def reference_states() -> list[State]:
+    data = [
+        [
+            "2023-04-18T08:28:32.744064",
+            -3310024.847608758,
+            -6052528.239971979,
+            7626.534641683145,
+            -855.2088930507367,
+            495.9541573743367,
+            7536.520188134902,
+        ],
+        [
+            "2023-04-18T08:28:33.744064",
+            -3310878.047628086,
+            -6052028.610429457,
+            15163.0493833017,
+            -851.1838953959017,
+            503.31279367207185,
+            7536.506322816037,
+        ],
+        [
+            "2023-04-18T08:28:34.744064",
+            -3311727.222133691,
+            -6051521.622540367,
+            22699.545682944226,
+            -847.1578341126227,
+            510.67087060642456,
+            7536.483268627912,
+        ],
+        [
+            "2023-04-18T08:28:35.744064",
+            -3312572.370064364,
+            -6051007.276868478,
+            30236.014351773065,
+            -843.1307141262514,
+            518.0283791399937,
+            7536.451025467619,
+        ],
+        [
+            "2023-04-18T08:28:36.744064",
+            -3313413.490363804,
+            -6050485.573986613,
+            37772.44620082258,
+            -839.1025403636198,
+            525.3853102358,
+            7536.40959324377,
+        ],
+        [
+            "2023-04-18T08:28:37.744064",
+            -3314250.5819806806,
+            -6049956.514476612,
+            45308.83204108345,
+            -835.0733177529921,
+            532.7416548573802,
+            7536.358971876497,
+        ],
+        [
+            "2023-04-18T08:28:38.744064",
+            -3315083.6438685474,
+            -6049420.098929363,
+            52845.16268340493,
+            -831.0430512241197,
+            540.0974039686765,
+            7536.299161297429,
+        ],
+        [
+            "2023-04-18T08:28:39.744064",
+            -3315912.6749859042,
+            -6048876.327944793,
+            60381.42893867038,
+            -827.0117457081434,
+            547.4525485342174,
+            7536.23016144972,
+        ],
+        [
+            "2023-04-18T08:28:40.744064",
+            -3316737.6742961914,
+            -6048325.2021318525,
+            67917.62161760827,
+            -822.9794061376964,
+            554.8070795189376,
+            7536.1519722880375,
+        ],
+        [
+            "2023-04-18T08:28:41.744064",
+            -3317558.640767768,
+            -6047766.722108539,
+            75453.73153099201,
+            -818.9460374467976,
+            562.1609878883643,
+            7536.064593778564,
+        ],
+        [
+            "2023-04-18T08:28:42.744064",
+            -3318375.5733739412,
+            -6047200.888501875,
+            82989.7494894997,
+            -814.9116445709234,
+            569.5142646084902,
+            7535.968025898996,
+        ],
+        [
+            "2023-04-18T08:28:43.744064",
+            -3319188.471092942,
+            -6046627.7019479135,
+            90525.66630384693,
+            -810.8762324469382,
+            576.866900645898,
+            7535.862268638544,
+        ],
+        [
+            "2023-04-18T08:28:44.744064",
+            -3319997.332907958,
+            -6046047.163091751,
+            98061.47278470133,
+            -806.8398060131411,
+            584.2188869676824,
+            7535.747321997941,
+        ],
+        [
+            "2023-04-18T08:28:45.744064",
+            -3320802.157807084,
+            -6045459.272587514,
+            105597.15974279115,
+            -802.8023702092072,
+            591.5702145415504,
+            7535.62318598943,
+        ],
+        [
+            "2023-04-18T08:28:46.744064",
+            -3321602.9447833803,
+            -6044864.0310983565,
+            113132.71798877101,
+            -798.7639299762548,
+            598.9208743356983,
+            7535.48986063679,
+        ],
+        [
+            "2023-04-18T08:28:47.744064",
+            -3322399.692834845,
+            -6044261.439296465,
+            120668.13833342775,
+            -794.7244902567405,
+            606.2708573190106,
+            7535.347345975296,
+        ],
+        [
+            "2023-04-18T08:28:48.744064",
+            -3323192.400964402,
+            -6043651.497863061,
+            128203.41158748553,
+            -790.6840559945587,
+            613.6201544608678,
+            7535.195642051765,
+        ],
+        [
+            "2023-04-18T08:28:49.744064",
+            -3323981.068179951,
+            -6043034.207488383,
+            135738.52856182377,
+            -786.6426321349277,
+            620.9687567313651,
+            7535.034748924513,
+        ],
+        [
+            "2023-04-18T08:28:50.744064",
+            -3324765.6934943097,
+            -6042409.568871722,
+            143273.48006733102,
+            -782.6002236244674,
+            628.3166551011666,
+            7534.864666663388,
+        ],
+        [
+            "2023-04-18T08:28:51.744064",
+            -3325546.2759252544,
+            -6041777.582721372,
+            150808.25691495842,
+            -778.5568354111685,
+            635.6638405415614,
+            7534.68539534976,
+        ],
+    ]
+    return [
+        State(
+            instant=Instant.date_time(DateTime.parse(row[0]), Scale.UTC),
+            position=Position.meters(
+                [float(row[1]), float(row[2]), float(row[3])], Frame.GCRF()
+            ),
+            velocity=Velocity.meters_per_second(
+                [float(row[4]), float(row[5]), float(row[6])], Frame.GCRF()
+            ),
+        )
+        for row in data
+    ]
+
+
+@pytest.fixture
+def test_states(reference_states: list[State]) -> list[State]:
+    return reference_states[::4]
+
+
+@pytest.fixture
+def interpolation_type() -> Interpolator.Type:
+    return Interpolator.Type.CubicSpline
+
+
+@pytest.fixture
+def tabulated(
+    test_states: list[State],
+    interpolation_type: Interpolator.Type,
+) -> Tabulated:
+    return Tabulated(
+        states=test_states,
+        interpolation_type=interpolation_type,
+    )
+
+
+class TestTabulatedTrajectory:
+    @pytest.mark.parametrize(
+        "interpolation_type",
+        (
+            (Interpolator.Type.Linear),
+            (Interpolator.Type.CubicSpline),
+            (Interpolator.Type.BarycentricRational),
+        ),
+    )
+    def test_constructor(
+        self,
+        test_states: list[State],
+        interpolation_type: Interpolator.Type,
+    ):
+        assert (
+            Tabulated(
+                states=test_states,
+                interpolation_type=interpolation_type,
+            )
+            is not None
+        )
+
+    def test_get_interpolation_type(
+        self,
+        test_states: list[State],
+        tabulated: Tabulated,
+        interpolation_type: Interpolator.Type,
+    ):
+        assert tabulated.get_interpolation_type() == Interpolator.Type.CubicSpline
+
+    @pytest.mark.parametrize(
+        "interpolation_type,error_tolerance",
+        (
+            (Interpolator.Type.Linear, 420.0),
+            (Interpolator.Type.CubicSpline, 5e-3),
+            (Interpolator.Type.BarycentricRational, 5e-2),
+        ),
+    )
+    def test_calculate_state_at(
+        self,
+        test_states: list[State],
+        reference_states: list[State],
+        interpolation_type: Interpolator.Type,
+        error_tolerance: float,
+    ):
+        tabulated: Tabulated = Tabulated(
+            states=test_states,
+            interpolation_type=interpolation_type,
+        )
+
+        for reference_state in reference_states:
+            if not tabulated.get_interval().contains_instant(
+                reference_state.get_instant()
+            ):
+                continue
+
+            calculated_state: State = tabulated.calculate_state_at(
+                reference_state.get_instant()
+            )
+            assert np.all(
+                np.abs(
+                    calculated_state.get_coordinates() - reference_state.get_coordinates()
+                )
+                < error_tolerance
+            )

ostk/astrodynamics/test/trajectory/model/test_target_scan_trajectory.py

@@ -0,0 +1,126 @@
+# Apache License 2.0
+
+import pytest
+
+from ostk.physics.coordinate.spherical import LLA
+from ostk.physics.environment.object.celestial import Earth
+from ostk.physics.time import Instant
+from ostk.physics.time import DateTime
+from ostk.physics.time import Scale
+from ostk.physics.time import Duration
+from ostk.physics.unit import Derived
+from ostk.astrodynamics.trajectory.model import TargetScan
+from ostk.astrodynamics.trajectory import State
+
+
+@pytest.fixture
+def earth() -> Earth:
+    return Earth.WGS84()
+
+
+@pytest.fixture
+def start_lla() -> LLA:
+    return LLA.vector([0.0, 0.0, 0.0])
+
+
+@pytest.fixture
+def end_lla() -> LLA:
+    return LLA.vector([0.0, 1.0, 0.0])
+
+
+@pytest.fixture
+def start_instant() -> Instant:
+    return Instant.date_time(DateTime(2023, 1, 1, 0, 0, 0), Scale.UTC)
+
+
+@pytest.fixture
+def end_instant() -> Instant:
+    return Instant.date_time(DateTime(2023, 1, 1, 0, 10, 0), Scale.UTC)
+
+
+@pytest.fixture
+def target_scan(
+    earth: Earth,
+    start_lla: LLA,
+    end_lla: LLA,
+    start_instant: Instant,
+    end_instant: Instant,
+) -> TargetScan:
+    return TargetScan(
+        start_lla=start_lla,
+        end_lla=end_lla,
+        start_instant=start_instant,
+        end_instant=end_instant,
+        celestial=earth,
+    )
+
+
+class TestTargetScan:
+    def test_constructor(
+        self,
+        target_scan: TargetScan,
+    ):
+        assert target_scan.is_defined()
+
+    def test_calculate_state_at(
+        self,
+        target_scan: TargetScan,
+    ):
+        instant: Instant = Instant.date_time(DateTime(2023, 1, 1, 0, 5, 0), Scale.UTC)
+        state: State = target_scan.calculate_state_at(instant)
+        assert state is not None
+
+    def test_equality_operator(
+        self,
+        target_scan: TargetScan,
+    ):
+        assert target_scan == target_scan
+
+    def test_inequality_operator(
+        self,
+        target_scan: TargetScan,
+        start_lla: LLA,
+        end_lla: LLA,
+        start_instant: Instant,
+        earth: Earth,
+    ):
+        target_scan2 = TargetScan(
+            start_lla=start_lla,
+            end_lla=end_lla,
+            start_instant=start_instant,
+            end_instant=Instant.undefined(),
+            celestial=earth,
+        )
+        assert target_scan != target_scan2
+
+    def test_getters(
+        self,
+        target_scan: TargetScan,
+    ):
+        assert target_scan.get_start_lla() is not None
+        assert target_scan.get_end_lla() is not None
+        assert target_scan.get_start_instant() is not None
+        assert target_scan.get_end_instant() is not None
+        assert target_scan.get_celestial() is not None
+        assert target_scan.get_step_size() is not None
+
+    def test_from_ground_speed(
+        self,
+        start_lla: LLA,
+        end_lla: LLA,
+        start_instant: Instant,
+        earth: Earth,
+    ):
+        ground_speed: Derived = Derived(100.0, Derived.Unit.meter_per_second())
+        step_size: Duration = Duration.seconds(1.0)
+
+        target_scan = TargetScan.from_ground_speed(
+            start_lla=start_lla,
+            end_lla=end_lla,
+            ground_speed=ground_speed,
+            start_instant=start_instant,
+            celestial=earth,
+            step_size=step_size,
+        )
+
+        assert target_scan.is_defined()

ostk/astrodynamics/test/trajectory/test_orbit.py

@@ -3,6 +3,7 @@
 import pytest
 
 from ostk.physics.environment.object.celestial import Earth
+from ostk.physics.environment.object import Celestial
 from ostk.physics.unit import Length, Angle
 from ostk.physics.time import Scale, Instant, DateTime, Time, Duration, Interval
 
@@ -58,6 +59,12 @@ class TestOrbit:
         assert state is not None
         assert isinstance(state, State)
 
+    def test_access_celestial_object(self, orbit: Orbit):
+        celestial_object = orbit.access_celestial_object()
+
+        assert celestial_object is not None
+        assert isinstance(celestial_object, Celestial)
+
     @pytest.mark.parametrize(
         "frame_type",
         [

ostk/astrodynamics/trajectory/__init__.pyi

@@ -10,9 +10,10 @@ import ostk.physics.environment.object
 import ostk.physics.time
 import ostk.physics.unit
 import typing
+from . import model
 from . import orbit
 from . import state
-__all__ = ['LocalOrbitalFrameDirection', 'LocalOrbitalFrameFactory', 'LocalOrbitalFrameTransformProvider', 'Model', 'Orbit', 'Propagator', 'Segment', 'Sequence', 'State', 'StateBuilder', 'orbit', 'state']
+__all__ = ['LocalOrbitalFrameDirection', 'LocalOrbitalFrameFactory', 'LocalOrbitalFrameTransformProvider', 'Model', 'Orbit', 'Propagator', 'Segment', 'Sequence', 'State', 'StateBuilder', 'model', 'orbit', 'state']
 class LocalOrbitalFrameDirection:
     """
     
@@ -323,7 +324,7 @@ class LocalOrbitalFrameTransformProvider:
 class Model:
     """
     
-                Orbital model.
+                Trajectory model.
     
             
     """
@@ -600,6 +601,13 @@ class Orbit(ostk.astrodynamics.Trajectory):
         ...
     def __str__(self) -> str:
         ...
+    def access_celestial_object(self) -> ostk.physics.environment.object.Celestial:
+        """
+                            Access the celestial object.
+        
+                            Returns:
+                                Celestial: The celestial object.
+        """
     def access_kepler_model(self) -> ...:
         """
                             Access the Kepler orbit model.
@@ -1656,7 +1664,7 @@ class StateBuilder:
                             coordinate_subsets list[CoordinateSubset]: The coordinate subsets.
         
                         Returns:
-                            StateBuilder
+                            StateBuilder: The new `StateBuilder` object.
         """
     @typing.overload
     def __init__(self, frame: ostk.physics.coordinate.Frame, coordinate_broker: state.CoordinateBroker) -> None:
@@ -1718,18 +1726,18 @@ class StateBuilder:
                             coordinates (VectorXd): The coordinates of the state.
         
                         Returns:
-                            State: The `State` object built from the `StateBuilder`.
+                            State: A `State` object built from the `StateBuilder`.
         """
     def expand(self, state: State, default_state: State) -> State:
         """
-                        Expand a `State` object to the `StateBuilder`.
+                        Expand a `State` object to the coordinate subsets of the `StateBuilder`.
         
                         Arguments:
                             state (State): The `State` object to expand.
-                            default_state (State): The default `State` object.
+                            default_state (State): The `State` object used to supply any additional coordinates.
         
                         Returns:
-                            StateBuilder: The `StateBuilder` object expanded from the `State`.
+                            State: A `State` object with the coordinate subsets of the `StateBuilder`.
         """
     def get_coordinate_subsets(self) -> list[state.CoordinateSubset]:
         """
@@ -1761,11 +1769,11 @@ class StateBuilder:
         """
     def reduce(self, state: State) -> State:
         """
-                        Reduce a `State` object to the `StateBuilder`.
+                        Reduce a `State` object to the coordinate subsets of the `StateBuilder`.
         
                         Arguments:
                             state (State): The `State` object to reduce.
         
                         Returns:
-                            StateBuilder: The `StateBuilder` object reduced from the `State`.
+                            State: A `State` object with the coordinate subsets of the `StateBuilder`.
         """