fr.cnes.sirius.patrius.attitudes

Class ConstantSpinSlew

java.lang.Object

fr.cnes.sirius.patrius.attitudes.ConstantSpinSlew

All Implemented Interfaces:

AttitudeLeg, AttitudeProvider, Slew, 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.

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, String natureIn) Constructor for slew with a duration constraint.

Method Summary

Modifier and Type	Method and Description
void	compute(PVCoordinatesProvider pvProv) Deprecated. as of 4.5, ConstantSpinSlew object should be built either from constructor or from class ConstantSpinSlewComputer.
Attitude	getAttitude(AbsoluteDate date, Frame frame) Compute the attitude.
Attitude	getAttitude(Orbit orbit) Compute the attitude corresponding to an orbital state.
Attitude	getAttitude(PVCoordinatesProvider pvProv, AbsoluteDate date, Frame frame) Warning: provided PVCoordinatesProvider is here not used.
double	getDuration()
String	getNature() Return the nature of the leg.
AbsoluteDateInterval	getTimeInterval() Return the time interval of validity of the leg
void	setSpinDerivativesComputation(boolean computeSpinDerivatives) Method to activate spin derivative computation.
void	truncate(AbsoluteDateInterval newIntervalOfValidityIn) Truncate the time interval of validity of the leg

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.utils.legs.Leg

toPrettyString

Constructor Detail

ConstantSpinSlew

public ConstantSpinSlew(Attitude initAtt,
                        Attitude finalAtt)
                 throws PatriusException

Constructor for slew with a duration constraint.

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.

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

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

Method Detail

compute

@Deprecated
public void compute(PVCoordinatesProvider pvProv)
                         throws PatriusException

Deprecated. as of 4.5, ConstantSpinSlew object should be built either from constructor or from class ConstantSpinSlewComputer.

Compute the slew corresponding to an orbital state.

Specified by:

compute in interface Slew

Parameters:

pvProv - : local position-velocity provider around current date

Throws:

PatriusException - orekit exception

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 attitude on the specified date and position-velocity state

Throws:

PatriusException - if attitude cannot be computed

getAttitude

public Attitude getAttitude(Orbit orbit)
                     throws PatriusException

Compute the attitude corresponding to an orbital state.

Specified by:

getAttitude in interface AttitudeProvider

Parameters:

orbit - current orbit

Returns:

attitude attitude on the current orbit

Throws:

PatriusException - if attitude cannot be computed

getTimeInterval

public final AbsoluteDateInterval getTimeInterval()

Return the time interval of validity of the leg

Specified by:

getTimeInterval in interface Leg

Returns:

time interval of validity of the leg

truncate

public void truncate(AbsoluteDateInterval newIntervalOfValidityIn)
              throws PatriusException

Truncate the time interval of validity of the leg

Specified by:

truncate in interface Leg

Parameters:

newIntervalOfValidityIn - the new time interval

Throws:

PatriusException - if the new time interval is not included in the current time 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()

Return the nature of the leg.

Specified by:

getNature in interface Leg

Returns:

nature of the leg