fr.cnes.sirius.patrius.attitudes

Class ConstantSpinSlew

java.lang.Object

fr.cnes.sirius.patrius.attitudes.ConstantSpinSlew

All Implemented Interfaces:

AttitudeLeg, AttitudeProvider, Slew, TimeStamped, Leg, Serializable

public class ConstantSpinSlew
extends Object
implements Slew

This class represents a constant spin slew.

The Constant spin slew is a "simple" slew that computes the attitude of the satellite using a spherical interpolation of the quaternions representing the starting and ending attitudes.
Some constraints, such as minimal maneuver duration or maximal angular velocity, must be taken into account during the maneuver computation.
Like all the other attitude legs, its interval of validity has closed endpoints.

Since:

1.1

Version:

$Id: ConstantSpinSlew.java 17582 2017-05-10 12:58:16Z bignon $

Author:

Tiziana Sabatini, Julie Anton

See Also:

Serialized Form

Concurrency :

not thread safe

Concurrency comment :

this class is not thread safe because the slew can be re-computed while the method getAttitude(PVCoordinatesProvider, AbsoluteDate, Frame) is called.

Field Summary

Fields inherited from interface fr.cnes.sirius.patrius.attitudes.AttitudeLeg

LEG_NATURE

Constructor Summary

Constructors

Constructor and Description
ConstantSpinSlew(Attitude initAtt, Attitude finalAtt) Constructor for slew with a duration constraint.
ConstantSpinSlew(Attitude initAtt, Attitude finalAtt, double spin, String natureIn) Constructor for slew with an angular velocity constraint.
ConstantSpinSlew(Attitude initAtt, Attitude finalAtt, double spin, String natureIn, Frame pivotFrame) Constructor for slew with an angular velocity constraint.
ConstantSpinSlew(Attitude initAtt, Attitude finalAtt, String natureIn) Constructor for slew with a duration constraint.
ConstantSpinSlew(Attitude initAtt, Attitude finalAtt, String natureIn, Frame pivotFrame) Constructor for slew with a duration constraint.

Method Summary

Modifier and Type	Method and Description
ConstantSpinSlew	copy(AbsoluteDateInterval newIntervalOfValidity) Creates a new leg from this one.
Attitude	getAttitude(AbsoluteDate date, Frame frame) Compute the attitude.
Attitude	getAttitude(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Warning: provided PVCoordinatesProvider is here not used.
double	getDuration()
String	getNature() Returns the nature of the leg.
AbsoluteDateInterval	getTimeInterval() Returns the time interval of the leg.
void	setSpinDerivativesComputation(boolean computeSpinDerivatives) Method to activate spin derivative computation.

Methods inherited from class java.lang.Object

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

Methods inherited from interface fr.cnes.sirius.patrius.attitudes.AttitudeLeg

computeSpinByFD, computeSpinDerivativeByFD

Methods inherited from interface fr.cnes.sirius.patrius.utils.legs.Leg

contains, getDate, getEnd, toPrettyString

Methods inherited from interface fr.cnes.sirius.patrius.attitudes.AttitudeProvider

getAttitude

Constructor Detail

ConstantSpinSlew

public ConstantSpinSlew(Attitude initAtt,
                        Attitude finalAtt)
                 throws PatriusException

Constructor for slew with a duration constraint. Slew is computed in GCRF frame.

Parameters:

initAtt - initial attitude at start date

finalAtt - final attitude at end date

Throws:

PatriusException - thrown if some frame transformation failed

ConstantSpinSlew

public ConstantSpinSlew(Attitude initAtt,
                        Attitude finalAtt,
                        String natureIn)
                 throws PatriusException

Constructor for slew with a duration constraint. Slew is computed in GCRF frame.

Parameters:

initAtt - initial attitude at start date

finalAtt - final attitude at end date

natureIn - nature

Throws:

PatriusException - thrown if some frame transformation failed

ConstantSpinSlew

public ConstantSpinSlew(Attitude initAtt,
                        Attitude finalAtt,
                        String natureIn,
                        Frame pivotFrame)
                 throws PatriusException

Constructor for slew with a duration constraint.

Parameters:

initAtt - initial attitude at start date

finalAtt - final attitude at end date

natureIn - nature

pivotFrame - pivot frame, slew will be computed in this frame

Throws:

PatriusException - thrown if some frame transformation failed

ConstantSpinSlew

public ConstantSpinSlew(Attitude initAtt,
                        Attitude finalAtt,
                        double spin,
                        String natureIn)
                 throws PatriusException

Constructor for slew with an angular velocity constraint. Warning: this constructor should not be used by users. This constructor is to be use only by ConstantSpinSlewComputer for strict backward compatibility Slew is computed in GCRF frame.

Parameters:

initAtt - initial attitude at start date

finalAtt - final attitude at end date

spin - spin value

natureIn - nature

Throws:

PatriusException - thrown if some frame transformation failed

ConstantSpinSlew

public ConstantSpinSlew(Attitude initAtt,
                        Attitude finalAtt,
                        double spin,
                        String natureIn,
                        Frame pivotFrame)
                 throws PatriusException

Constructor for slew with an angular velocity constraint. Warning: this constructor should not be used by users. This constructor is to be use only by ConstantSpinSlewComputer for strict backward compatibility

Parameters:

initAtt - initial attitude at start date

finalAtt - final attitude at end date

spin - spin value

natureIn - nature

pivotFrame - pivot frame, slew will be computed in this frame

Throws:

PatriusException - thrown if some frame transformation failed

Method Detail

getAttitude

public Attitude getAttitude(AbsoluteDate date,
                            Frame frame)
                     throws PatriusException

Compute the attitude.

Specified by:

getAttitude in interface Slew

Parameters:

date - : current date

frame - : reference frame from which attitude is computed

Returns:

attitude : attitude at the specified date

Throws:

PatriusException - orekit exception

setSpinDerivativesComputation

public void setSpinDerivativesComputation(boolean computeSpinDerivatives)

Method to activate spin derivative computation.

Specified by:

setSpinDerivativesComputation in interface AttitudeProvider

Parameters:

computeSpinDerivatives - true if spin derivatives should be computed

getAttitude

public Attitude getAttitude(PVCoordinatesProvider pvProv,
                            AbsoluteDate date,
                            Frame frame)
                     throws PatriusException

Warning: provided PVCoordinatesProvider is here not used.

Specified by:

getAttitude in interface AttitudeProvider

Parameters:

pvProv - local position-velocity provider around current date

date - current date

frame - reference frame from which attitude is computed

Returns:

attitude on the specified date and position-velocity state

Throws:

PatriusException - if attitude cannot be computed for provided date

getTimeInterval

public final AbsoluteDateInterval getTimeInterval()

Returns the time interval of the leg.

Specified by:

getTimeInterval in interface Leg

Returns:

the time interval of the leg.

copy

public ConstantSpinSlew copy(AbsoluteDateInterval newIntervalOfValidity)

Creates a new leg from this one.

Specified by:

copy in interface AttitudeLeg

Specified by:

copy in interface Slew

Specified by:

copy in interface Leg

Parameters:

newIntervalOfValidity - The time interval of the leg to create

Returns:

A new Leg valid on provided interval

getDuration

public final double getDuration()
                         throws PatriusException

Returns:

the duration of the time interval of validity of the slew.

Throws:

PatriusException - if the time interval is not computed

getNature

public String getNature()

Returns the nature of the leg.

Specified by:

getNature in interface Leg

Returns:

The “nature” of the leg.