fr.cnes.sirius.patrius.stela.forces.gravity.recurrence

Class StelaRecurrenceZonalEquation

java.lang.Object

fr.cnes.sirius.patrius.stela.forces.gravity.recurrence.StelaRecurrenceZonalEquation

All Implemented Interfaces:

Serializable

public class StelaRecurrenceZonalEquation
extends Object
implements Serializable

This class carries the Earth zonal harmonics recurrence methods equations and is meant to be used by StelaRecurrenceZonalAttraction.

The class is adapted from STELA RecurrenceZonalEq in fr.cnes.los.stela.elib.business.implementation.earthpotential.zonal.

Since:

4.16

Author:

Maxime Ecochard, Thibaut BONIT HISTORY VERSION:4.16:OPENFD-391:25/04/2025:[STELA-PATRIUS] Implementation zonaux par recurrence END-HISTORY

See Also:

Serialized Form

Concurrency :

conditionally thread-safe

Concurrency comment :

thread safe if the inputs arrays are not modified (as they are stored directly for performance purpose)

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	StelaRecurrenceZonalEquation(StelaEquinoctialOrbit orbit, int zonalDegreeMaxPerturbation, double[] powOfTwo, double[][][][][] alphaCoef, double[][][][][] betaCoef) Constructor.

Method Summary

Modifier and Type	Method and Description
double	computeEvenMeanPotential(int np) Compute the mean potential U at a given order of development (even case).
double	computeEvenParDerA(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to a (even case).
double	computeEvenParDerEx(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to ex (even case).
double	computeEvenParDerEy(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to ey (even case).
double	computeEvenParDerIx(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to ix (even case).
double	computeEvenParDerIy(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to iy (even case).
double	computeOddMeanPotential(int np) Compute the mean potential U at a given order of development (odd case).
double	computeOddParDerA(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to a (odd case).
double	computeOddParDerEx(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to ex (odd case).
double	computeOddParDerEy(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to ey (odd case).
double	computeOddParDerIx(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to ix (odd case).
double	computeOddParDerIy(int np, double meanU) Compute the mean potential (at a given order of development) partial derivatives with respect to iy (odd case).

Methods inherited from class java.lang.Object

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

Constructor Detail

StelaRecurrenceZonalEquation

protected StelaRecurrenceZonalEquation(StelaEquinoctialOrbit orbit,
                                       int zonalDegreeMaxPerturbation,
                                       double[] powOfTwo,
                                       double[][][][][] alphaCoef,
                                       double[][][][][] betaCoef)

Constructor.

Note that the given arrays are stored directly. They aren't copied for performance purpose.
This class is designed to be commonly used by StelaRecurrenceZonalAttraction (hence the protected constructor) which compute these arrays only once when initialized.

Parameters:

orbit - orbit information: date, kinematics

zonalDegreeMaxPerturbation - degree of development for zonal perturbations

powOfTwo - Power of two

alphaCoef - Alpha coefficients

betaCoef - Beta coefficients

Method Detail

computeEvenMeanPotential

public double computeEvenMeanPotential(int np)

Compute the mean potential U at a given order of development (even case).
(FAST NT-zonaux-hautsdegres) Eq. (42).

Parameters:

np - n' (order of development)

Returns:

U (even case)

computeEvenParDerA

public double computeEvenParDerA(int np,
                                 double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to a (even case).
(FAST NT-zonaux-hautsdegres) Eq. (67).

Parameters:

np - n' (order of development)

meanU - U (even)

Returns:

dU/da (even case)

computeEvenParDerEx

public double computeEvenParDerEx(int np,
                                  double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to ex (even case).
(FAST NT-zonaux-hautsdegres) Eq. (7).

Parameters:

np - n' (order of development)

meanU - U (even)

Returns:

dU/dex

computeEvenParDerEy

public double computeEvenParDerEy(int np,
                                  double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to ey (even case).
(FAST NT-zonaux-hautsdegres) Eq. (74).

Parameters:

np - n' (order of development)

meanU - U (even)

Returns:

dU/dey

computeEvenParDerIx

public double computeEvenParDerIx(int np,
                                  double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to ix (even case).
(FAST NT-zonaux-hautsdegres) Eq. (77).

Parameters:

np - n' (order of development)

meanU - U (even)

Returns:

dU/dix

computeEvenParDerIy

public double computeEvenParDerIy(int np,
                                  double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to iy (even case).
(FAST NT-zonaux-hautsdegres) Eq. (78).

Parameters:

np - n' (order of development)

meanU - U (even)

Returns:

dU/diy

computeOddMeanPotential

public double computeOddMeanPotential(int np)

Compute the mean potential U at a given order of development (odd case).
(FAST NT-zonaux-hautsdegres) Eq. (46).

Parameters:

np - n' (order of development)

Returns:

U (odd case)

computeOddParDerA

public double computeOddParDerA(int np,
                                double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to a (odd case).
(FAST NT-zonaux-hautsdegres) Eq. (68).

Parameters:

np - n' (order of development)

meanU - U (odd)

Returns:

dU/da (odd case)

computeOddParDerEx

public double computeOddParDerEx(int np,
                                 double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to ex (odd case).
(FAST NT-zonaux-hautsdegres) Eq. (75).

Parameters:

np - n' (order of development)

meanU - U (odd)

Returns:

dU/dex (odd case)

computeOddParDerEy

public double computeOddParDerEy(int np,
                                 double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to ey (odd case).
(FAST NT-zonaux-hautsdegres) Eq. (76).

Parameters:

np - n' (order of development)

meanU - U (odd)

Returns:

dU/dey (odd case)

computeOddParDerIx

public double computeOddParDerIx(int np,
                                 double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to ix (odd case).
(FAST NT-zonaux-hautsdegres) Eq. (79).

Parameters:

np - n' (order of development)

meanU - U (odd)

Returns:

dU/dix (odd case)

computeOddParDerIy

public double computeOddParDerIy(int np,
                                 double meanU)

Compute the mean potential (at a given order of development) partial derivatives with respect to iy (odd case).
(FAST NT-zonaux-hautsdegres) Eq. (80).

Parameters:

np - n' (order of development)

meanU - U (odd)

Returns:

dU/diy (odd case)