fr.cnes.sirius.patrius.wrenches

Class SolarRadiationWrench

java.lang.Object

fr.cnes.sirius.patrius.math.parameter.Parameterizable

fr.cnes.sirius.patrius.wrenches.SolarRadiationWrench

All Implemented Interfaces:

IParameterizable, WrenchModel, Serializable

public class SolarRadiationWrench
extends Parameterizable
implements WrenchModel

This class represents a solar radiation wrench model. It requires a spacecraft capable of computing the wrench caused by solar radiation pressure.

Since:

2.1

Version:

$Id$

Author:

Rami Houdroge

See Also:

RadiationWrenchSensitive, Serialized Form

Concurrency :

not thread-safe

Concurrency comment :

class uses internal mutable attributes and frames

Constructor Summary

Constructors

Constructor and Description
SolarRadiationWrench(double distance, double pressure, double sunRadius, PVCoordinatesProvider sunBody, BodyShape shape, RadiationWrenchSensitive spacecraftModel) Complete constructor.
SolarRadiationWrench(Parameter distance, Parameter pressure, Parameter sunRadius, PVCoordinatesProvider sunBody, BodyShape shape, RadiationWrenchSensitive spacecraftModel) Complete constructor using Parameter.
SolarRadiationWrench(PVCoordinatesProvider sunBody, BodyShape shape, RadiationWrenchSensitive spacecraftModel) Simple constructor with default reference values.

Method Summary

Modifier and Type	Method and Description
protected double	computeRawP(SpacecraftState s) Compute radiation coefficient.
Vector3D	computeTorque(SpacecraftState s) Compute the resulting torque at the mass centre of the spacecraft in the frame of the main part.
Vector3D	computeTorque(SpacecraftState s, Vector3D origin, Frame frame) Compute the resulting wrench.
Wrench	computeWrench(SpacecraftState s) Compute the resulting wrench at the mass centre of the spacecraft in the frame of the main part.
Wrench	computeWrench(SpacecraftState s, Vector3D origin, Frame frame) Compute the resulting wrench.
protected Vector3D	getSatSunVector(SpacecraftState state) Compute sat-Sun vector in spacecraft state frame.

Methods inherited from class fr.cnes.sirius.patrius.math.parameter.Parameterizable

addAllParameters, addAllParameters, addParameter, getParameters, supportsParameter

Methods inherited from class java.lang.Object

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

Constructor Detail

SolarRadiationWrench

public SolarRadiationWrench(PVCoordinatesProvider sunBody,
                            BodyShape shape,
                            RadiationWrenchSensitive spacecraftModel)

Simple constructor with default reference values.

When this constructor is used, the reference values are:

• d_ref = 149597870000.0 m
• p_ref = 4.56 10^-6 N/m²

Parameters:

sunBody - Sun model

shape - earth model (for umbra/penumbra computation)

spacecraftModel - the object physical and geometrical information

SolarRadiationWrench

public SolarRadiationWrench(double distance,
                            double pressure,
                            double sunRadius,
                            PVCoordinatesProvider sunBody,
                            BodyShape shape,
                            RadiationWrenchSensitive spacecraftModel)

Complete constructor.

Note that reference solar radiation pressure pRef in N/m² is linked to solar flux SF in W/m² using formula pRef = SF/c where c is the speed of light (299792458 m/s). So at 1UA a 1367 W/m² solar flux is a 4.56 10^-6 N/m² solar radiation pressure.

Parameters:

distance - reference distance for the solar radiation pressure

pressure - reference solar radiation pressure at dRef

sunRadius - reference sun radius

sunBody - Sun model

shape - earth model (for umbra/penumbra computation)

spacecraftModel - the object physical and geometrical information

SolarRadiationWrench

public SolarRadiationWrench(Parameter distance,
                            Parameter pressure,
                            Parameter sunRadius,
                            PVCoordinatesProvider sunBody,
                            BodyShape shape,
                            RadiationWrenchSensitive spacecraftModel)

Complete constructor using Parameter.

Parameters:

distance - the parameter representing the reference distance for the solar radiation pressure

pressure - the parameter representing the reference solar radiation pressure at dRef

sunRadius - the parameter representing the reference sun radius

sunBody - Sun model

shape - earth model (for umbra/penumbra computation)

spacecraftModel - the object physical and geometrical information

Method Detail

getSatSunVector

protected Vector3D getSatSunVector(SpacecraftState state)
                            throws PatriusException

Compute sat-Sun vector in spacecraft state frame.

Parameters:

state - current spacecraft state

Returns:

sat-Sun vector in spacecraft state frame

Throws:

PatriusException - if sun position cannot be computed

computeRawP

protected double computeRawP(SpacecraftState s)
                      throws PatriusException

Compute radiation coefficient.

Parameters:

s - spacecraft state

Returns:

coefficient for acceleration computation

Throws:

PatriusException - if position cannot be computed

computeWrench

public Wrench computeWrench(SpacecraftState s)
                     throws PatriusException

Compute the resulting wrench at the mass centre of the spacecraft in the frame of the main part.

Specified by:

computeWrench in interface WrenchModel

Parameters:

s - spacecraft state

Returns:

resulting wrench

Throws:

PatriusException - if some error occurs

computeWrench

public Wrench computeWrench(SpacecraftState s,
                            Vector3D origin,
                            Frame frame)
                     throws PatriusException

Compute the resulting wrench.

Specified by:

computeWrench in interface WrenchModel

Parameters:

s - spacecraft state

origin - point in which to express wrench

frame - frame in which point is expressed

Returns:

resulting wrench

Throws:

PatriusException - if some error occurs

computeTorque

public Vector3D computeTorque(SpacecraftState s)
                       throws PatriusException

Compute the resulting torque at the mass centre of the spacecraft in the frame of the main part.

Specified by:

computeTorque in interface WrenchModel

Parameters:

s - spacecraft state

Returns:

resulting torque at center of spacecraft state frame

Throws:

PatriusException - if some error occurs

computeTorque

public Vector3D computeTorque(SpacecraftState s,
                              Vector3D origin,
                              Frame frame)
                       throws PatriusException

Compute the resulting wrench.

Specified by:

computeTorque in interface WrenchModel

Parameters:

s - spacecraft state

origin - point in which to express torque

frame - frame in which point is expressed

Returns:

resulting torque expressed at origin

Throws:

PatriusException - if some error occurs