Struct nyx_space::md::opti::optimizer::Optimizer

pub struct Optimizer<'a, E: ErrorCtrl, const V: usize, const O: usize> {
    pub prop: &'a Propagator<'a, SpacecraftDynamics<'a>, E>,
    pub objectives: [Objective; O],
    pub objective_frame: Option<(Frame, Arc<Cosm>)>,
    pub variables: [Variable; V],
    pub correction_frame: Option<Frame>,
    pub iterations: usize,
}

An optimizer structure with V control variables and O objectives.

Fields

prop: &'a Propagator<'a, SpacecraftDynamics<'a>, E>

The propagator setup (kind, stages, etc.)

objectives: [Objective; O]

The list of objectives of this targeter

objective_frame: Option<(Frame, Arc<Cosm>)>

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

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, E: ErrorCtrl> Optimizer<'a, E, 3, 6>

pub fn convert_impulsive_mnvr( spacecraft: Spacecraft, dv: Vector3<f64>, prop: &'a Propagator<'a, SpacecraftDynamics<'_>, E> ) -> Result<Mnvr, NyxError>

Create a new Targeter which will apply an impulsive delta-v correction. The spacecraft must be the spacecraft BEFORE the Δv is applied

impl<'a, E: ErrorCtrl, const O: usize> Optimizer<'a, E, 3, O>

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

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

pub fn delta_r( prop: &'a Propagator<'a, SpacecraftDynamics<'a>, E>, 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<'a, SpacecraftDynamics<'a>, E>, 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, E: ErrorCtrl, const O: usize> Optimizer<'a, E, 4, O>

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

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

impl<'a, E: ErrorCtrl, const O: usize> Optimizer<'a, E, 7, O>

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

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

impl<'a, E: ErrorCtrl, const O: usize> Optimizer<'a, E, 10, O>

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

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

impl<'a, E: ErrorCtrl, const V: usize, const O: usize> Optimizer<'a, E, V, O>

pub fn new( prop: &'a Propagator<'a, SpacecraftDynamics<'a>, E>, 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<'a, SpacecraftDynamics<'a>, E>, variables: [Variable; V], objectives: [Objective; O], objective_frame: Frame, cosm: Arc<Cosm> ) -> Self

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

pub fn vnc_with_components( prop: &'a Propagator<'a, SpacecraftDynamics<'a>, E>, 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 ) -> Result<TargeterSolution<V, O>, NyxError>

Runs the targeter using finite differencing (for now).

pub fn apply( &self, solution: &TargeterSolution<V, O> ) -> Result<Spacecraft, NyxError>

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> ) -> Result<(Spacecraft, Traj<Spacecraft>), NyxError>

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

impl<'a, E: ErrorCtrl, const V: usize, const O: usize> Optimizer<'a, E, V, O>

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

Differential correction using finite differencing

impl<'a, E: ErrorCtrl, const V: usize, const O: usize> Optimizer<'a, E, V, O>

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

Differential correction using hyperdual numbers for the objectives

Trait Implementations

impl<'a, E: Clone + ErrorCtrl, const V: usize, const O: usize> Clone for Optimizer<'a, E, V, O>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, E: ErrorCtrl, const V: usize, const O: usize> Display for Optimizer<'a, E, V, O>

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

Formats the value using the given formatter.