ostk.astrodynamics.Trajectory

class Trajectory(*args, **kwargs)

Bases: pybind11_object

Path followed by an object through space as a function of time.

Overloaded function.

1. __init__(self: ostk.astrodynamics.Trajectory, model: ostk::astrodynamics::trajectory::Model) -> None

   Construct a Trajectory object from a model.

   Args:

   model (trajectory.Model): The model of the trajectory.

   Returns:

   Trajectory: The Trajectory object.

2. __init__(self: ostk.astrodynamics.Trajectory, states: list[ostk::astrodynamics::trajectory::State]) -> None

   Construct a Trajectory object from an array of states.

   Args:

   states (list[State]): The states of the trajectory.

   Returns:

   Trajectory: The Trajectory object.

Methods

access_model	Access the model of the trajectory.
get_state_at	Get the state of the trajectory at a given instant.
get_states_at	Get the states of the trajectory at a given set of instants.
ground_strip	Overloaded function.
ground_strip_geodetic_nadir	Create a Trajectory object representing a ground strip that follows the geodetic nadir of the provided orbit.
is_defined	Check if the trajectory is defined.
position	Create a Trajectory object representing a position.
undefined	Create an undefined Trajectory object.

access_model(

self: ostk.astrodynamics.Trajectory,

) → ostk::astrodynamics::trajectory::Model

Access the model of the trajectory.

Returns:

The model of the trajectory.

Return type:

Model

get_state_at(

self: ostk.astrodynamics.Trajectory,

instant: ostk.physics.time.Instant,

) → ostk::astrodynamics::trajectory::State

Get the state of the trajectory at a given instant.

Parameters:

instant (Instant) -- The instant.

Returns:

The state of the trajectory at the given instant.

Return type:

State

get_states_at(

self: ostk.astrodynamics.Trajectory,

instants: list[ostk.physics.time.Instant],

) → list[ostk::astrodynamics::trajectory::State]

Get the states of the trajectory at a given set of instants. It can be more performant than looping calculate_state_at for multiple instants.

Parameters:

instants (list[Instant]) -- The instants.

Returns:

The states of the trajectory at the given instants.

Return type:

list[State]

static ground_strip(*args, **kwargs)

Overloaded function.

1. ground_strip(start_lla: ostk.physics.coordinate.spherical.LLA, end_lla: ostk.physics.coordinate.spherical.LLA, ground_speed: ostk.physics.unit.Derived, start_instant: ostk.physics.time.Instant, celestial_object: ostk.physics.environment.object.Celestial = Earth.WGS84(), step_size: ostk.physics.time.Duration = Duration.Seconds(1.0)) -> ostk.astrodynamics.Trajectory

   Create a Trajectory object representing a ground strip. Computes the duration as the geodetic distance / ground speed. Instants are generated at a 1 second interval.

   Args:

   start_lla (LLA): The start LLA. end_lla (LLA): The end LLA. ground_speed (Derived): The ground speed. start_instant (Instant): The start instant. celestial_object (Celestial): The celestial object. Defaults to Earth.WGS84(). step_size (Duration): The step size. Defaults to 1 second.

   Returns:

   Trajectory: The Trajectory object representing the ground strip.

2. ground_strip(start_lla: ostk.physics.coordinate.spherical.LLA, end_lla: ostk.physics.coordinate.spherical.LLA, instants: list[ostk.physics.time.Instant], celestial_object: ostk.physics.environment.object.Celestial = Earth.WGS84()) -> ostk.astrodynamics.Trajectory

   Create a Trajectory object representing a ground strip. This method computes the duration as the geodetic distance / ground speed.

   Args:

   start_lla (LLA): The start LLA. end_lla (LLA): The end LLA. instants (list[Instant]): The instants. celestial_object (Celestial): The celestial object. Defaults to Earth.WGS84().

   Returns:

   Trajectory: The Trajectory object representing the ground strip.

static ground_strip_geodetic_nadir(orbit: ostk::astrodynamics::trajectory::Orbit, instants: list[ostk.physics.time.Instant], celestial_object: ostk.physics.environment.object.Celestial = Earth.WGS84()) → ostk.astrodynamics.Trajectory

Create a Trajectory object representing a ground strip that follows the geodetic nadir of the provided orbit.

Parameters:

• orbit (Orbit) -- The orbit.

• instants (list[Instant]) -- The instants.

• celestial_object (Celestial) -- The celestial object. Defaults to Earth.WGS84().

Returns:

The Trajectory object representing the ground strip.

Return type:

Trajectory

is_defined(self: ostk.astrodynamics.Trajectory) → bool

Check if the trajectory is defined.

Returns:

True if the trajectory is defined, False otherwise.

Return type:

bool

static position(

position: ostk.physics.coordinate.Position,

) → ostk.astrodynamics.Trajectory

Create a Trajectory object representing a position.

Parameters:

position (Position) -- The position. Must be in the ITRF frame.

Returns:

The Trajectory object representing the position.

Return type:

Trajectory

static undefined() → ostk.astrodynamics.Trajectory

Create an undefined Trajectory object.

Returns:

The undefined Trajectory object.

Return type:

Trajectory