Struct Targeter

pub struct Targeter<'a, const V: usize, const O: usize> {
    pub prop: &'a Propagator<SpacecraftDynamics>,
    pub objectives: [Objective; O],
    pub objective_frame: Option<Frame>,
    pub variables: [Variable; V],
    pub correction_frame: Option<LocalFrame>,
    pub iterations: usize,
}

An optimizer structure with V control variables and O objectives.

Fields

prop: &'a Propagator<SpacecraftDynamics>

The propagator setup (kind, stages, etc.)

objectives: [Objective; O]

The list of objectives of this targeter

objective_frame: Option<Frame>

An optional frame (and Cosm) to compute the objectives in. Needed if the propagation frame is separate from objectives frame (e.g. for B Plane targeting).

variables: [Variable; V]

The kind of correction to apply to achieve the objectives

correction_frame: Option<LocalFrame>

The frame in which the correction should be applied, must be either a local frame or inertial

iterations: usize

Maximum number of iterations

Implementations

impl<'a, const V: usize, const O: usize> Targeter<'a, V, O>

pub fn try_achieve_fd( &self, initial_state: Spacecraft, correction_epoch: Epoch, achievement_epoch: Epoch, almanac: Arc<Almanac>, ) -> Result<TargeterSolution<V, O>, TargetingError>

Differential correction using finite differencing

impl<'a, const V: usize, const O: usize> Targeter<'a, V, O>

pub fn try_achieve_dual( &self, initial_state: Spacecraft, correction_epoch: Epoch, achievement_epoch: Epoch, almanac: Arc<Almanac>, ) -> Result<TargeterSolution<V, O>, TargetingError>

Differential correction using hyperdual numbers for the objectives

impl<'a, const O: usize> Targeter<'a, 3, O>

pub fn delta_v( prop: &'a Propagator<SpacecraftDynamics>, objectives: [Objective; O], ) -> Self

Create a new Targeter which will apply an impulsive delta-v correction.

pub fn delta_r( prop: &'a Propagator<SpacecraftDynamics>, objectives: [Objective; O], ) -> Self

Create a new Targeter which will MOVE the position of the spacecraft at the correction epoch

pub fn vnc( prop: &'a Propagator<SpacecraftDynamics>, objectives: [Objective; O], ) -> Self

Create a new Targeter which will apply an impulsive delta-v correction on all components of the VNC frame. By default, max step is 0.5 km/s.

impl<'a, const O: usize> Targeter<'a, 4, O>

pub fn thrust_dir( prop: &'a Propagator<SpacecraftDynamics>, objectives: [Objective; O], ) -> Self

Create a new Targeter which will apply a continuous thrust for the whole duration of the segment

impl<'a, const O: usize> Targeter<'a, 7, O>

pub fn thrust_dir_rate( prop: &'a Propagator<SpacecraftDynamics>, objectives: [Objective; O], ) -> Self

Create a new Targeter which will apply a continuous thrust for the whole duration of the segment

impl<'a, const O: usize> Targeter<'a, 10, O>

pub fn thrust_profile( prop: &'a Propagator<SpacecraftDynamics>, objectives: [Objective; O], ) -> Self

Create a new Targeter which will apply a continuous thrust for the whole duration of the segment

impl<'a, const V: usize, const O: usize> Targeter<'a, V, O>

pub fn new( prop: &'a Propagator<SpacecraftDynamics>, variables: [Variable; V], objectives: [Objective; O], ) -> Self

Create a new Targeter which will apply an impulsive delta-v correction.

pub fn in_frame( prop: &'a Propagator<SpacecraftDynamics>, variables: [Variable; V], objectives: [Objective; O], objective_frame: Frame, ) -> Self

Create a new Targeter which will apply an impulsive delta-v correction.

pub fn vnc_with_components( prop: &'a Propagator<SpacecraftDynamics>, variables: [Variable; V], objectives: [Objective; O], ) -> Self

Create a new Targeter which will apply an impulsive delta-v correction on the specified components of the VNC frame.

pub fn try_achieve_from( &self, initial_state: Spacecraft, correction_epoch: Epoch, achievement_epoch: Epoch, almanac: Arc<Almanac>, ) -> Result<TargeterSolution<V, O>, TargetingError>

Runs the targeter using finite differencing (for now).

pub fn apply( &self, solution: &TargeterSolution<V, O>, almanac: Arc<Almanac>, ) -> Result<Spacecraft, TargetingError>

Apply a correction and propagate to achievement epoch. Also checks that the objectives are indeed matched

pub fn apply_with_traj( &self, solution: &TargeterSolution<V, O>, almanac: Arc<Almanac>, ) -> Result<(Spacecraft, Traj<Spacecraft>), TargetingError>

Apply a correction and propagate to achievement epoch, return the final state and trajectory. Also checks that the objectives are indeed matched.

Trait Implementations

impl<'a, const V: usize, const O: usize> Clone for Targeter<'a, V, O>

fn clone(&self) -> Targeter<'a, V, O>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a, const V: usize, const O: usize> Display for Targeter<'a, V, O>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.