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) 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, int maxIterationsNumberIn) 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) Constructor.
IsisSpinBiasSlewComputer(double dtSCAOIn, double thetaMaxAllowedIn, double durationMaxIn, double dtConvergenceThresholdIn, double[][] inertiaMatrixIn, double rwTorqueAllocAccelIn, double rwTorqueAllocDecelIn, double rwDeltaMomentumAllocIn, double[][] rwMatrixIn, double tranquillisationTimeIn, String natureIn) Constructor with default maximum number of iterations allowed for slew duration computation's convergence.

Method Summary

Modifier and Type	Method and Description
TabulatedSlew	computeAnalytical(PVCoordinatesProvider pvProv, AttitudeProvider initialLaw, AbsoluteDate initialDateIn, AttitudeProvider finalLaw, AbsoluteDate finalDate) Compute the slew (analytical version).
double	computeDuration(PVCoordinatesProvider pvProv, AttitudeProvider initialLaw, AbsoluteDate initialDateIn, AttitudeProvider finalLaw, AbsoluteDate finalDate) Computes the slew duration.
TabulatedSlew	computeNumerical(PVCoordinatesProvider pvProv, AttitudeProvider initialLaw, AbsoluteDate initialDateIn, AttitudeProvider finalLaw, AbsoluteDate finalDate) Compute the slew (numerical version).
void	setThrowExceptionOnMaxIterations(boolean throwExceptionOnMaxIterations) Set the boolean to decide if an exception is thrown when the max number of iterations arrive

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)

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)

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)

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

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)

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

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)

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

Method Detail

setThrowExceptionOnMaxIterations

public void setThrowExceptionOnMaxIterations(boolean throwExceptionOnMaxIterations)

Set the boolean to decide if an exception is thrown when the max number of iterations arrive

Parameters:

throwExceptionOnMaxIterations - boolean indicating if an exception is thrown or the duration is returned when the computation loop arrives to the maxIterations

computeAnalytical

public TabulatedSlew computeAnalytical(PVCoordinatesProvider pvProv,
                                       AttitudeProvider initialLaw,
                                       AbsoluteDate initialDateIn,
                                       AttitudeProvider finalLaw,
                                       AbsoluteDate finalDate)
                                throws PatriusException

Compute the slew (analytical version).

Parameters:

pvProv - satellite PV coordinates through time

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)

Returns:

built slew (analytical version)

Throws:

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

computeNumerical

public TabulatedSlew computeNumerical(PVCoordinatesProvider pvProv,
                                      AttitudeProvider initialLaw,
                                      AbsoluteDate initialDateIn,
                                      AttitudeProvider finalLaw,
                                      AbsoluteDate finalDate)
                               throws PatriusException

Compute the slew (numerical version).

Parameters:

pvProv - satellite PV coordinates through time

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)

Returns:

built slew (numerical version)

Throws:

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

computeDuration

public double computeDuration(PVCoordinatesProvider pvProv,
                              AttitudeProvider initialLaw,
                              AbsoluteDate initialDateIn,
                              AttitudeProvider finalLaw,
                              AbsoluteDate finalDate)
                       throws PatriusException

Computes the slew duration.

Parameters:

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)

Returns:

slew duration

Throws:

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