fr.cnes.sirius.patrius.stela.forces.atmospheres

Class MSIS00Adapter

java.lang.Object

fr.cnes.sirius.patrius.stela.forces.atmospheres.MSIS00Adapter

All Implemented Interfaces:

Atmosphere, ExtendedAtmosphere, Serializable

public class MSIS00Adapter
extends Object
implements ExtendedAtmosphere

This class implements the MSIS00 atmospheric model.
It is an interface layer between the NRLMSISE00 class - adapted from Fortran - and the SIRIUS data structures. It implements the method getDensity of the interface Atmosphere, based on the MSIS00 atmospheric model.

Warning: this model is not continuous. There is a discontinuity every day (at 0h in UTC time scale). Discontinuities are however very small (1E-3 on a relative scale).

Since:

1.3

Version:

$Id: MSIS00Adapter.java 18465 2017-11-22 16:29:52Z bignon $

Author:

Vincent Ruch, Rami Houdroge, Tiziana Sabatini

See Also:

Serialized Form

Concurrency :

thread-hostile

Concurrency comment :

The direct use of thread hostile objects makes this class thread hostile itself.

Constructor Summary

Constructors

Constructor and Description
MSIS00Adapter(MSISE2000InputParameters data, double rEq, double f, CelestialBody sunBody) Simple constructor for class MSIS00Adapter.

Method Summary

Methods

Modifier and Type	Method and Description
AtmosphereData	getData(AbsoluteDate date, Vector3D position, Frame frame) Get detailed atmospheric data.
double	getDensity(AbsoluteDate date, Vector3D position, Frame frame) Get the local density.
double	getPressure(AbsoluteDate date, Vector3D position, Frame frame) Returns pressure.
double	getSpeedOfSound(AbsoluteDate date, Vector3D position, Frame frame) Get the local speed of sound.
Vector3D	getVelocity(AbsoluteDate date, Vector3D position, Frame frame) Get the spacecraft velocity relative to the atmosphere.

Methods inherited from class java.lang.Object

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

Constructor Detail

MSIS00Adapter

public MSIS00Adapter(MSISE2000InputParameters data,
             double rEq,
             double f,
             CelestialBody sunBody)

Simple constructor for class MSIS00Adapter.

Parameters:

data - solar data

rEq - the Earth equatorial radius

f - the Earth flattening

sunBody - the sun

Method Detail

getDensity

public double getDensity(AbsoluteDate date,
                Vector3D position,
                Frame frame)
                  throws PatriusException

Get the local density.

Specified by:

getDensity in interface Atmosphere

Parameters:

date - current date

position - current position in frame

frame - the frame in which is defined the position

Returns:

local density (kg/m³)

Throws:

PatriusException - if date is out of range of solar activity model or if some frame conversion cannot be performed

getPressure

public double getPressure(AbsoluteDate date,
                 Vector3D position,
                 Frame frame)
                   throws PatriusException

Returns pressure.

Parameters:

date - date

position - position

frame - frame

Returns:

pressure at date

Throws:

PatriusException - thrown if pressure could not be computed

getVelocity

public Vector3D getVelocity(AbsoluteDate date,
                   Vector3D position,
                   Frame frame)
                     throws PatriusException

Description copied from interface: Atmosphere

Get the spacecraft velocity relative to the atmosphere.

Specified by:

getVelocity in interface Atmosphere

Parameters:

date - current date

position - current position in frame

frame - the frame in which is defined the position

Returns:

velocity (m/s) (defined in the same frame as the position)

Throws:

PatriusException - if some conversion cannot be performed

getSpeedOfSound

public double getSpeedOfSound(AbsoluteDate date,
                     Vector3D position,
                     Frame frame)
                       throws PatriusException

Get the local speed of sound.

Specified by:

getSpeedOfSound in interface Atmosphere

Parameters:

date - current date

position - current position in frame

frame - the frame in which is defined the position

Returns:

speed of sound (m/s)

Throws:

PatriusException - if some conversion cannot be performed

getData

public AtmosphereData getData(AbsoluteDate date,
                     Vector3D position,
                     Frame frame)
                       throws PatriusException

Get detailed atmospheric data.

MSISE00Adapter provides all data mentioned in AtmosphereData.

Specified by:

getData in interface ExtendedAtmosphere

Parameters:

date - current date

position - current position in frame

frame - the frame in which is defined the position

Returns:

detailed atmospheric data

Throws:

PatriusException - if some atmospheric data cannot be retrieved (because date is out of range of solar activity model or if some frame conversion cannot be performed)