fr.cnes.sirius.patrius.forces.maneuvers.orbman

Class ImpulseDeManeuver

java.lang.Object

fr.cnes.sirius.patrius.events.AbstractDetector

fr.cnes.sirius.patrius.forces.maneuvers.ImpulseManeuver

fr.cnes.sirius.patrius.forces.maneuvers.orbman.ImpulseDeManeuver

All Implemented Interfaces:

EventDetector, Maneuver, ImpulseParKepManeuver, Serializable

public class ImpulseDeManeuver
extends ImpulseManeuver
implements ImpulseParKepManeuver

Class defining an impulsive maneuver with an eccentricity and a semi major axis increment as input.

Since:

4.4

Author:

JFG

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface fr.cnes.sirius.patrius.events.EventDetector

EventDetector.Action

Field Summary

Fields inherited from class fr.cnes.sirius.patrius.forces.maneuvers.ImpulseManeuver

deltaVSat

Fields inherited from class fr.cnes.sirius.patrius.events.AbstractDetector

actionAtEntry, actionAtExit, DEFAULT_MAXCHECK, DEFAULT_MAXITER, DEFAULT_THRESHOLD, removeAtEntry, removeAtExit, shouldBeRemovedFlag

Fields inherited from interface fr.cnes.sirius.patrius.events.EventDetector

DECREASING, INCREASING, INCREASING_DECREASING

Constructor Summary

Constructors

Constructor and Description
ImpulseDeManeuver(EventDetector inTrigger, double de, double da, double isp, MassProvider massModel, String part, boolean throwExceptionIfNotSolution) Build a new instance.
ImpulseDeManeuver(EventDetector inTrigger, double de, double da, PropulsiveProperty engine, MassProvider massModel, TankProperty tank, boolean throwExceptionIfNotSolution) Build a new instance using propulsive and engine property.

Method Summary

Modifier and Type	Method and Description
void	computeDV(SpacecraftState state) Method to compute the DV thanks to Keplerian parameters included in the Spacecraft state.
double	getDa() Getter for semi-major axis increment.
double	getDe() Getter for eccentricity axis increment.
SpacecraftState	resetState(SpacecraftState oldState) Reset the state (including additional states) prior to continue propagation.

Methods inherited from class fr.cnes.sirius.patrius.forces.maneuvers.ImpulseManeuver

copy, eventOccurred, g, getDeltaVSat, getFrame, getIsp, getLofType, getMassProvider, getMaxCheckInterval, getMaxIterationCount, getPropulsiveProperty, getSlopeSelection, getTankProperty, getThreshold, getTrigger, getUsedDV, hasFired, init, shouldBeRemoved

Methods inherited from class fr.cnes.sirius.patrius.events.AbstractDetector

filterEvent, getActionAtEntry, getActionAtExit, isRemoveAtEntry, isRemoveAtExit, logEventsOverTimeInterval, setMaxCheckInterval, setMaxIter

Methods inherited from class java.lang.Object

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

Constructor Detail

ImpulseDeManeuver

public ImpulseDeManeuver(EventDetector inTrigger,
                         double de,
                         double da,
                         double isp,
                         MassProvider massModel,
                         String part,
                         boolean throwExceptionIfNotSolution)
                  throws PatriusException

Build a new instance.

Parameters:

inTrigger - triggering event (it must generate a STOP event action to trigger the maneuver)

de - eccentricity increment

da - semi major axis increment (m)

isp - engine specific impulse (s)

massModel - mass model

part - part of the mass model that provides the propellant

throwExceptionIfNotSolution - flag to throw an exception if no solution found (true), returns 0 otherwise

Throws:

PatriusException - if mass from mass provider is negative

ImpulseDeManeuver

public ImpulseDeManeuver(EventDetector inTrigger,
                         double de,
                         double da,
                         PropulsiveProperty engine,
                         MassProvider massModel,
                         TankProperty tank,
                         boolean throwExceptionIfNotSolution)

Build a new instance using propulsive and engine property.

Parameters:

inTrigger - triggering event (it must generate a STOP event action to trigger the maneuver)

de - eccentricity increment

da - semi major axis increment (m)

engine - engine property (specific impulse)

massModel - mass model

tank - tank property gathering mass and part name information

throwExceptionIfNotSolution - flag to throw an exception if no solution found (true), returns 0 otherwise

Method Detail

resetState

public SpacecraftState resetState(SpacecraftState oldState)
                           throws PatriusException

Reset the state (including additional states) prior to continue propagation.

This method is called after the step handler has returned and before the next step is started, but only when EventDetector.eventOccurred(fr.cnes.sirius.patrius.propagation.SpacecraftState, boolean, boolean) has itself returned the EventDetector.Action.RESET_STATE indicator. It allows the user to reset the state for the next step, without perturbing the step handler of the finishing step. If the EventDetector.eventOccurred(fr.cnes.sirius.patrius.propagation.SpacecraftState, boolean, boolean) never returns the EventDetector.Action.RESET_STATE indicator, this function will never be called, and it is safe to simply return null.

Specified by:

resetState in interface EventDetector

Overrides:

resetState in class ImpulseManeuver

Parameters:

oldState - old state

Returns:

new state

Throws:

PatriusException - thrown if the mass becomes negative (PatriusMessages.SPACECRAFT_MASS_BECOMES_NEGATIVE)

computeDV

public void computeDV(SpacecraftState state)
               throws PatriusException

Method to compute the DV thanks to Keplerian parameters included in the Spacecraft state.

Specified by:

computeDV in interface ImpulseParKepManeuver

Parameters:

state - S/C state

Throws:

PatriusException - thrown if there is no solution

getDa

public double getDa()

Getter for semi-major axis increment.

Returns:

semi-major axis increment

getDe

public double getDe()

Getter for eccentricity axis increment.

Returns:

eccentricity axis increment