fr.cnes.sirius.patrius.attitudes.slew

Class IsisSpinBiasSlewComputer

java.lang.Object

fr.cnes.sirius.patrius.attitudes.slew.IsisSpinBiasSlewComputer

public class IsisSpinBiasSlewComputer
extends Object

Class for ISIS spin bias slew computation: slew with trapezoidal angular velocity profile calculated in GCRF. Computation of slew returns a TabulatedSlew.

Since:

4.5

Author:

Emmanuel Bignon

Constructor Summary

Constructors

Constructor and Description
IsisSpinBiasSlewComputer(double dtSCAOIn, double thetaMaxAllowedIn, double durationMaxIn, double dtConvergenceThresholdIn, double[][] inertiaMatrixIn, double rwTorqueAllocAccelIn, double rwTorqueAllocDecelIn, double rwDeltaMomentumAllocIn, double[][] rwMatrixIn, double tranquillisationTimeIn, int maxIterationsNumberIn, PVCoordinatesProvider pvProv, AttitudeProvider initialLaw, AbsoluteDate initialDateIn, AttitudeProvider finalLaw, AbsoluteDate finalDate) Constructor.
IsisSpinBiasSlewComputer(double dtSCAOIn, double thetaMaxAllowedIn, double durationMaxIn, double dtConvergenceThresholdIn, double[][] inertiaMatrixIn, double rwTorqueAllocAccelIn, double rwTorqueAllocDecelIn, double rwDeltaMomentumAllocIn, double[][] rwMatrixIn, double tranquillisationTimeIn, int maxIterationsNumberIn, String natureIn, PVCoordinatesProvider pvProv, AttitudeProvider initialLaw, AbsoluteDate initialDateIn, AttitudeProvider finalLaw, AbsoluteDate finalDate) Constructor.
IsisSpinBiasSlewComputer(double dtSCAOIn, double thetaMaxAllowedIn, double durationMaxIn, double dtConvergenceThresholdIn, double[][] inertiaMatrixIn, double rwTorqueAllocAccelIn, double rwTorqueAllocDecelIn, double rwDeltaMomentumAllocIn, double[][] rwMatrixIn, double tranquillisationTimeIn, int maxIterationsNumberIn, String natureIn, PVCoordinatesProvider pvProv, AttitudeProvider initialLaw, AbsoluteDate initialDateIn, AttitudeProvider finalLaw, AbsoluteDate finalDate, boolean throwExceptionOnMaxIterations) Constructor.
IsisSpinBiasSlewComputer(double dtSCAOIn, double thetaMaxAllowedIn, double durationMaxIn, double dtConvergenceThresholdIn, double[][] inertiaMatrixIn, double rwTorqueAllocAccelIn, double rwTorqueAllocDecelIn, double rwDeltaMomentumAllocIn, double[][] rwMatrixIn, double tranquillisationTimeIn, PVCoordinatesProvider pvProv, AttitudeProvider initialLaw, AbsoluteDate initialDateIn, AttitudeProvider finalLaw, AbsoluteDate finalDate) Constructor with default maximum number of iterations allowed for slew duration computation's convergence.
IsisSpinBiasSlewComputer(double dtSCAOIn, double thetaMaxAllowedIn, double durationMaxIn, double dtConvergenceThresholdIn, double[][] inertiaMatrixIn, double rwTorqueAllocAccelIn, double rwTorqueAllocDecelIn, double rwDeltaMomentumAllocIn, double[][] rwMatrixIn, double tranquillisationTimeIn, String natureIn, PVCoordinatesProvider pvProv, AttitudeProvider initialLaw, AbsoluteDate initialDateIn, AttitudeProvider finalLaw, AbsoluteDate finalDate) Constructor with default maximum number of iterations allowed for slew duration computation's convergence.

Method Summary

Modifier and Type	Method and Description
TabulatedSlew	computeAnalytical() Compute the slew (analytical version).
TabulatedSlew	computeNumerical() Compute the slew (numerical version).
double	getDuration() Getter for the duration of the slew

Methods inherited from class java.lang.Object

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

Constructor Detail

IsisSpinBiasSlewComputer

public IsisSpinBiasSlewComputer(double dtSCAOIn,
                                double thetaMaxAllowedIn,
                                double durationMaxIn,
                                double dtConvergenceThresholdIn,
                                double[][] inertiaMatrixIn,
                                double rwTorqueAllocAccelIn,
                                double rwTorqueAllocDecelIn,
                                double rwDeltaMomentumAllocIn,
                                double[][] rwMatrixIn,
                                double tranquillisationTimeIn,
                                PVCoordinatesProvider pvProv,
                                AttitudeProvider initialLaw,
                                AbsoluteDate initialDateIn,
                                AttitudeProvider finalLaw,
                                AbsoluteDate finalDate)
                         throws PatriusException

Constructor with default maximum number of iterations allowed for slew duration computation's convergence.

Parameters:

dtSCAOIn - time step (s)

thetaMaxAllowedIn - maximum slew angular amplitude allowed (rad)

durationMaxIn - maximum duration expected for the slew, including the tranquilisation phase (s)

dtConvergenceThresholdIn - convergence threshold for the iterative computation of the slew duration (s)

inertiaMatrixIn - satellite inertia matrix in satellite reference frame (kg.m^2)

rwTorqueAllocAccelIn - torque allocation for each RW during the acceleration phase (N.m)

rwTorqueAllocDecelIn - torque allocation for each RW during the deceleration phase (assumed > 0) (N.m)

rwDeltaMomentumAllocIn - angular momentum allocation for each RW during the manoeuvre (N.m.s)

rwMatrixIn - cosine directors matrix of the reaction wheels in the satellite reference frame. Matrix 3xN_RW with N_RW wheels (Reaction wheels spin axes written in column in the satellite reference frame).

tranquillisationTimeIn - tranquilisation time after the end of the slew (s)

pvProv - PV coordinates provider

initialLaw - initial attitude law (before the slew)

initialDateIn - slew start date (null if slew defined with its end date)

finalLaw - final attitude law (after the slew)

finalDate - slew end date (null if slew defined with its start date)

Throws:

PatriusException - thrown if computation failed or if dates are both null or not null

IsisSpinBiasSlewComputer

public IsisSpinBiasSlewComputer(double dtSCAOIn,
                                double thetaMaxAllowedIn,
                                double durationMaxIn,
                                double dtConvergenceThresholdIn,
                                double[][] inertiaMatrixIn,
                                double rwTorqueAllocAccelIn,
                                double rwTorqueAllocDecelIn,
                                double rwDeltaMomentumAllocIn,
                                double[][] rwMatrixIn,
                                double tranquillisationTimeIn,
                                int maxIterationsNumberIn,
                                PVCoordinatesProvider pvProv,
                                AttitudeProvider initialLaw,
                                AbsoluteDate initialDateIn,
                                AttitudeProvider finalLaw,
                                AbsoluteDate finalDate)
                         throws PatriusException

Constructor.

Parameters:

dtSCAOIn - time step (s)

thetaMaxAllowedIn - maximum slew angular amplitude allowed (rad)

durationMaxIn - maximum duration expected for the slew, including the tranquilisation phase (s)

dtConvergenceThresholdIn - convergence threshold for the iterative computation of the slew duration (s)

inertiaMatrixIn - satellite inertia matrix in satellite reference frame (kg.m^2)

rwTorqueAllocAccelIn - torque allocation for each RW during the acceleration phase (N.m)

rwTorqueAllocDecelIn - torque allocation for each RW during the deceleration phase (assumed > 0) (N.m)

rwDeltaMomentumAllocIn - angular momentum allocation for each RW during the manoeuvre (N.m.s)

rwMatrixIn - cosine directors matrix of the reaction wheels in the satellite reference frame. Matrix 3xN_RW with N_RW wheels (Reaction wheels spin axes written in column in the satellite reference frame).

tranquillisationTimeIn - tranquilisation time after the end of the slew (s)

maxIterationsNumberIn - maximum number of iterations allowed for slew duration computation's convergence

pvProv - PV coordinates provider

initialLaw - initial attitude law (before the slew)

initialDateIn - slew start date (null if slew defined with its end date)

finalLaw - final attitude law (after the slew)

finalDate - slew end date (null if slew defined with its start date)

Throws:

PatriusException - thrown if computation failed or if dates are both null or not null

IsisSpinBiasSlewComputer

public IsisSpinBiasSlewComputer(double dtSCAOIn,
                                double thetaMaxAllowedIn,
                                double durationMaxIn,
                                double dtConvergenceThresholdIn,
                                double[][] inertiaMatrixIn,
                                double rwTorqueAllocAccelIn,
                                double rwTorqueAllocDecelIn,
                                double rwDeltaMomentumAllocIn,
                                double[][] rwMatrixIn,
                                double tranquillisationTimeIn,
                                String natureIn,
                                PVCoordinatesProvider pvProv,
                                AttitudeProvider initialLaw,
                                AbsoluteDate initialDateIn,
                                AttitudeProvider finalLaw,
                                AbsoluteDate finalDate)
                         throws PatriusException

Constructor with default maximum number of iterations allowed for slew duration computation's convergence.

Parameters:

dtSCAOIn - time step (s)

thetaMaxAllowedIn - maximum slew angular amplitude allowed (rad)

durationMaxIn - maximum duration expected for the slew, including the tranquilisation phase (s)

dtConvergenceThresholdIn - convergence threshold for the iterative computation of the slew duration (s)

inertiaMatrixIn - satellite inertia matrix in satellite reference frame (kg.m^2)

rwTorqueAllocAccelIn - torque allocation for each RW during the acceleration phase (N.m)

rwTorqueAllocDecelIn - torque allocation for each RW during the deceleration phase (assumed > 0) (N.m)

rwDeltaMomentumAllocIn - angular momentum allocation for each RW during the manoeuvre (N.m.s)

rwMatrixIn - cosine directors matrix of the reaction wheels in the satellite reference frame. Matrix 3xN_RW with N_RW wheels (Reaction wheels spin axes written in column in the satellite reference frame).

tranquillisationTimeIn - tranquilisation time after the end of the slew (s)

natureIn - leg nature

pvProv - PV coordinates provider

initialLaw - initial attitude law (before the slew)

initialDateIn - slew start date (null if slew defined with its end date)

finalLaw - final attitude law (after the slew)

finalDate - slew end date (null if slew defined with its start date)

Throws:

PatriusException - thrown if computation failed or if dates are both null or not null

IsisSpinBiasSlewComputer

public IsisSpinBiasSlewComputer(double dtSCAOIn,
                                double thetaMaxAllowedIn,
                                double durationMaxIn,
                                double dtConvergenceThresholdIn,
                                double[][] inertiaMatrixIn,
                                double rwTorqueAllocAccelIn,
                                double rwTorqueAllocDecelIn,
                                double rwDeltaMomentumAllocIn,
                                double[][] rwMatrixIn,
                                double tranquillisationTimeIn,
                                int maxIterationsNumberIn,
                                String natureIn,
                                PVCoordinatesProvider pvProv,
                                AttitudeProvider initialLaw,
                                AbsoluteDate initialDateIn,
                                AttitudeProvider finalLaw,
                                AbsoluteDate finalDate)
                         throws PatriusException

Constructor.

Parameters:

dtSCAOIn - time step (s)

thetaMaxAllowedIn - maximum slew angular amplitude allowed (rad)

durationMaxIn - maximum duration expected for the slew, including the tranquilisation phase (s)

dtConvergenceThresholdIn - convergence threshold for the iterative computation of the slew duration (s)

inertiaMatrixIn - satellite inertia matrix in satellite reference frame (kg.m^2)

rwTorqueAllocAccelIn - torque allocation for each RW during the acceleration phase (N.m)

rwTorqueAllocDecelIn - torque allocation for each RW during the deceleration phase (assumed > 0) (N.m)

rwDeltaMomentumAllocIn - angular momentum allocation for each RW during the manoeuvre (N.m.s)

rwMatrixIn - cosine directors matrix of the reaction wheels in the satellite reference frame. Matrix 3xN_RW with N_RW wheels (Reaction wheels spin axes written in column in the satellite reference frame).

tranquillisationTimeIn - tranquilisation time after the end of the slew (s)

maxIterationsNumberIn - maximum number of iterations allowed for slew duration computation's convergence

natureIn - leg nature

pvProv - PV coordinates provider

initialLaw - initial attitude law (before the slew)

initialDateIn - slew start date (null if slew defined with its end date)

finalLaw - final attitude law (after the slew)

finalDate - slew end date (null if slew defined with its start date)

Throws:

PatriusException - thrown if computation failed or if dates are both null or not null

IsisSpinBiasSlewComputer

public IsisSpinBiasSlewComputer(double dtSCAOIn,
                                double thetaMaxAllowedIn,
                                double durationMaxIn,
                                double dtConvergenceThresholdIn,
                                double[][] inertiaMatrixIn,
                                double rwTorqueAllocAccelIn,
                                double rwTorqueAllocDecelIn,
                                double rwDeltaMomentumAllocIn,
                                double[][] rwMatrixIn,
                                double tranquillisationTimeIn,
                                int maxIterationsNumberIn,
                                String natureIn,
                                PVCoordinatesProvider pvProv,
                                AttitudeProvider initialLaw,
                                AbsoluteDate initialDateIn,
                                AttitudeProvider finalLaw,
                                AbsoluteDate finalDate,
                                boolean throwExceptionOnMaxIterations)
                         throws PatriusException

Constructor.

Parameters:

dtSCAOIn - time step (s)

thetaMaxAllowedIn - maximum slew angular amplitude allowed (rad)

durationMaxIn - maximum duration expected for the slew, including the tranquilisation phase (s)

dtConvergenceThresholdIn - convergence threshold for the iterative computation of the slew duration (s)

inertiaMatrixIn - satellite inertia matrix in satellite reference frame (kg.m^2)

rwTorqueAllocAccelIn - torque allocation for each RW during the acceleration phase (N.m)

rwTorqueAllocDecelIn - torque allocation for each RW during the deceleration phase (assumed > 0) (N.m)

rwDeltaMomentumAllocIn - angular momentum allocation for each RW during the manoeuvre (N.m.s)

rwMatrixIn - cosine directors matrix of the reaction wheels in the satellite reference frame. Matrix 3xN_RW with N_RW wheels (Reaction wheels spin axes written in column in the satellite reference frame).

tranquillisationTimeIn - tranquilisation time after the end of the slew (s)

maxIterationsNumberIn - maximum number of iterations allowed for slew duration computation's convergence

natureIn - leg nature

pvProv - PV coordinates provider

initialLaw - initial attitude law (before the slew)

initialDateIn - slew start date (null if slew defined with its end date)

finalLaw - final attitude law (after the slew)

finalDate - slew end date (null if slew defined with its start date)

throwExceptionOnMaxIterations - Decision to raise an Exception if the maximum of iterations is reached

Throws:

PatriusException - thrown if computation failed or if dates are both null or not null

Method Detail

computeAnalytical

public TabulatedSlew computeAnalytical()
                                throws PatriusException

Compute the slew (analytical version).

Returns:

built slew (analytical version)

Throws:

PatriusException - thrown if computation failed or if dates are both null or not null

computeNumerical

public TabulatedSlew computeNumerical()
                               throws PatriusException

Compute the slew (numerical version).

Returns:

built slew (numerical version)

Throws:

PatriusException - thrown if computation failed or if dates are both null or not null

getDuration

public double getDuration()

Getter for the duration of the slew

Returns:

the duration of the slew