Package org.orekit.control.indirect.adjoint.cost

Class QuadraticallyPenalizedCartesianFuel

java.lang.Object

org.orekit.control.indirect.adjoint.cost.AbstractCartesianCost

org.orekit.control.indirect.adjoint.cost.PenalizedCartesianFuelCost

org.orekit.control.indirect.adjoint.cost.QuadraticallyPenalizedCartesianFuel

All Implemented Interfaces:

CartesianCost

public class QuadraticallyPenalizedCartesianFuel
extends PenalizedCartesianFuelCost

Fuel cost penalized with a quadratic term. For epsilon equal to 1, one gets the bounded energy cost.

Since:

13.0

Author:

Romain Serra

See Also:

BoundedCartesianEnergy

Constructor Summary

Constructors

Constructor	Description
QuadraticallyPenalizedCartesianFuel(String name, double massFlowRateFactor, double maximumThrustMagnitude, double epsilon)	Constructor with default event detection settings.
QuadraticallyPenalizedCartesianFuel(String name, double massFlowRateFactor, double maximumThrustMagnitude, double epsilon, EventDetectionSettings eventDetectionSettings)	Constructor.

Method Summary

Modifier and Type	Method	Description
double	evaluatePenaltyFunction(double controlNorm)	Evaluate the penalty term (without the weight), assumed to be a function of the control norm.
Stream<EventDetector>	getEventDetectors()	Get the detectors needed for propagation.
Vector3D	getThrustAccelerationVector(double[] adjointVariables, double mass)	Computes the thrust acceleration vector in propagation frame from the adjoint variables and the mass.
void	updateAdjointDerivatives(double[] adjointVariables, double mass, double[] adjointDerivatives)	Update the adjoint derivatives if necessary.

Methods inherited from class org.orekit.control.indirect.adjoint.cost.PenalizedCartesianFuelCost

getEpsilon, getEventDetectionSettings, getHamiltonianContribution, getMaximumThrustMagnitude, getThrustDirection

Methods inherited from class org.orekit.control.indirect.adjoint.cost.AbstractCartesianCost

getAdjointName, getAdjointVelocityNorm, getFieldAdjointVelocityNorm, getMassFlowRateFactor

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.orekit.control.indirect.adjoint.cost.CartesianCost

getAdjointDimension

Constructor Detail

QuadraticallyPenalizedCartesianFuel

public QuadraticallyPenalizedCartesianFuel(String name,
                                           double massFlowRateFactor,
                                           double maximumThrustMagnitude,
                                           double epsilon,
                                           EventDetectionSettings eventDetectionSettings)

Constructor.

Parameters:

name - adjoint name

massFlowRateFactor - mass flow rate factor

maximumThrustMagnitude - maximum thrust magnitude

epsilon - penalty weight

eventDetectionSettings - detection settings

QuadraticallyPenalizedCartesianFuel

public QuadraticallyPenalizedCartesianFuel(String name,
                                           double massFlowRateFactor,
                                           double maximumThrustMagnitude,
                                           double epsilon)

Constructor with default event detection settings.

Parameters:

name - adjoint name

massFlowRateFactor - mass flow rate factor

maximumThrustMagnitude - maximum thrust magnitude

epsilon - penalty weight

Method Detail

evaluatePenaltyFunction

public double evaluatePenaltyFunction(double controlNorm)

Evaluate the penalty term (without the weight), assumed to be a function of the control norm.

Specified by:

evaluatePenaltyFunction in class PenalizedCartesianFuelCost

Parameters:

controlNorm - Euclidean norm of control vector

Returns:

penalty function

getThrustAccelerationVector

public Vector3D getThrustAccelerationVector(double[] adjointVariables,
                                            double mass)

Computes the thrust acceleration vector in propagation frame from the adjoint variables and the mass.

Parameters:

adjointVariables - adjoint vector

mass - mass

Returns:

thrust vector

updateAdjointDerivatives

public void updateAdjointDerivatives(double[] adjointVariables,
                                     double mass,
                                     double[] adjointDerivatives)

Update the adjoint derivatives if necessary.

Parameters:

adjointVariables - adjoint vector

mass - mass

adjointDerivatives - derivatives to update

getEventDetectors

public Stream<EventDetector> getEventDetectors()

Get the detectors needed for propagation.

Returns:

event detectors