fr.cnes.sirius.patrius.forces.gravity

Class NewtonianGravityModel

java.lang.Object

fr.cnes.sirius.patrius.forces.gravity.AbstractGravityModel

fr.cnes.sirius.patrius.forces.gravity.AbstractHarmonicGravityModel

fr.cnes.sirius.patrius.forces.gravity.NewtonianGravityModel

All Implemented Interfaces:

GravityModel, Serializable

public class NewtonianGravityModel
extends AbstractHarmonicGravityModel

Force model for Newtonian central body attraction.

The implementation of this class enables the computation of partial derivatives with respect to the central attraction coefficient.

Author:

Luc Maisonobe

See Also:

Serialized Form

Field Summary

Fields inherited from class fr.cnes.sirius.patrius.forces.gravity.AbstractGravityModel

MU

Constructor Summary

Constructors

Constructor and Description
NewtonianGravityModel(double mu) Simple constructor for Earth-centered computations: uses GCRF.
NewtonianGravityModel(Frame centralBodyFrame, double mu) Simple constructor.
NewtonianGravityModel(Frame centralBodyFrame, double mu, boolean computePD) Simple constructor.
NewtonianGravityModel(Frame centralBodyFrame, Parameter mu) Simple constructor using Parameter.
NewtonianGravityModel(Frame centralBodyFrame, Parameter mu, boolean computePD) Simple constructor using Parameter.

Method Summary

Modifier and Type	Method and Description
Vector3D	computeNonCentralTermsAcceleration(Vector3D positionInBodyFrame, AbsoluteDate date) Compute the acceleration due to the non-central terms of the gravitational attraction.
double[][]	computeNonCentralTermsDAccDPos(Vector3D positionInBodyFrame, AbsoluteDate date) Compute acceleration derivatives with respect to the state parameters for the non-central terms.
void	setCentralTermContribution(boolean centralTermContributionIn) Set the boolean for the central term contribution (true if the central term is considered, false if not).

Methods inherited from class fr.cnes.sirius.patrius.forces.gravity.AbstractHarmonicGravityModel

computeAcceleration, computeCentralTermAcceleration, computeCentralTermDAccDPos, computeDAccDPos, isCentralTermContributionApplied

Methods inherited from class fr.cnes.sirius.patrius.forces.gravity.AbstractGravityModel

getBodyFrame, getMu, getMuParameter, setMu

Methods inherited from class java.lang.Object

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

Constructor Detail

NewtonianGravityModel

public NewtonianGravityModel(double mu)

Simple constructor for Earth-centered computations: uses GCRF.

Parameters:

mu - central attraction coefficient (m^3/s^2)

NewtonianGravityModel

public NewtonianGravityModel(Frame centralBodyFrame,
                             double mu)

Simple constructor.
Note that the body frame is used for translation only. Therefore it shall be as high as possible in the tree of frames so as to avoid unnecessary calculations.

Parameters:

centralBodyFrame - body frame of the central body

mu - central attraction coefficient (m^3/s^2)

NewtonianGravityModel

public NewtonianGravityModel(Frame centralBodyFrame,
                             double mu,
                             boolean computePD)

Simple constructor.
Note that the body frame is used for translation only. Therefore it shall be as high as possible in the tree of frames so as to avoid unnecessary calculations.

Parameters:

centralBodyFrame - body frame of the central body

mu - central attraction coefficient (m^3/s^2)

computePD - true if partial derivatives wrt position have to be computed

NewtonianGravityModel

public NewtonianGravityModel(Frame centralBodyFrame,
                             Parameter mu)

Simple constructor using Parameter.
Note that the body frame is used for translation only. Therefore it shall be as high as possible in the tree of frames so as to avoid unnecessary calculations.

Parameters:

centralBodyFrame - body frame of the central body

mu - parameter representing central attraction coefficient (m^3/s^2)

NewtonianGravityModel

public NewtonianGravityModel(Frame centralBodyFrame,
                             Parameter mu,
                             boolean computePD)

Simple constructor using Parameter.
Note that the body frame is used for translation only. Therefore it shall be as high as possible in the tree of frames so as to avoid unnecessary calculations.

Parameters:

centralBodyFrame - body frame of the central body

mu - parameter representing central attraction coefficient (m^3/s^2)

computePD - true if partial derivatives wrt position have to be computed

Method Detail

computeNonCentralTermsAcceleration

public Vector3D computeNonCentralTermsAcceleration(Vector3D positionInBodyFrame,
                                                   AbsoluteDate date)
                                            throws PatriusException

Compute the acceleration due to the non-central terms of the gravitational attraction..

Specified by:

computeNonCentralTermsAcceleration in class AbstractHarmonicGravityModel

Parameters:

positionInBodyFrame - the position expressed in the body frame

date - the date

Returns:

the non-central terms acceleration in the given frame

Throws:

PatriusException - if some specific error occurs

computeNonCentralTermsDAccDPos

public final double[][] computeNonCentralTermsDAccDPos(Vector3D positionInBodyFrame,
                                                       AbsoluteDate date)
                                                throws PatriusException

Compute acceleration derivatives with respect to the state parameters for the non-central terms..

Specified by:

computeNonCentralTermsDAccDPos in class AbstractHarmonicGravityModel

Parameters:

positionInBodyFrame - position of the spacecraft in the body frame

date - date

Returns:

acceleration derivatives with respect to position in the body frame

Throws:

PatriusException - if derivatives cannot be computed

setCentralTermContribution

public void setCentralTermContribution(boolean centralTermContributionIn)

Set the boolean for the central term contribution (true if the central term is considered, false if not).

This class does not accept the desactivation of the central term since it only contains the central term.

Overrides:

setCentralTermContribution in class AbstractHarmonicGravityModel

Parameters:

centralTermContributionIn - the boolean for the central term contribution (true if the central term is considered, false if not).