fr.cnes.sirius.patrius.forces.atmospheres

Class US76

java.lang.Object

fr.cnes.sirius.patrius.forces.atmospheres.US76

All Implemented Interfaces:

Atmosphere, Serializable

public class US76
extends Object
implements Atmosphere

This class implements the US76 atmospheric model.

This class is restricted to be used with EllipsoidBodyShape.

Since:

2.3

Version:

$Id: US76.java 15077 2016-01-20 10:47:09Z chabaud $

Author:

Francois Toussaint

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
US76(EllipsoidBodyShape earthBody) Simple constructor for class US76.

Method Summary

Modifier and Type	Method and Description
void	checkSolarActivityData(AbsoluteDate start, AbsoluteDate end) This methods throws an exception if the user did not provide solar activity on the provided interval [start, end].
Atmosphere	copy() A copy of the atmosphere.
double	getDensity(AbsoluteDate date, Vector3D position, Frame frame) Getter for the local density for altitude in interval [0, 1E6]m.
BodyShape	getEarthBody() Getter for the earth body.
double	getPress(AbsoluteDate date, Vector3D position, Frame frame) Getter for the local pressure for altitude in interval [0, 1E6]m.
double	getSpeedOfSound(AbsoluteDate date, Vector3D position, Frame frame) Get the local speed of sound.
double	getTemp(AbsoluteDate date, Vector3D position, Frame frame) Getter for the local temperature for altitude in interval [0, 1E6]m.
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

US76

public US76(EllipsoidBodyShape earthBody)

Simple constructor for class US76.

Parameters:

earthBody - earth body

Method Detail

getTemp

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

Getter for the local temperature for altitude in interval [0, 1E6]m.

Note: if altitude < 0 m or altitude > 1E6 m the temperature corresponding to the closest bound is returned.

Parameters:

date - date to compute temperature, pressure, and density

position - position vector

frame - frame where the position vector is expressed

Returns:

the local temperature

Throws:

PatriusException - if point cannot be converted to body frame

getPress

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

Getter for the local pressure for altitude in interval [0, 1E6]m.

Note: if altitude < 0 m or altitude > 1E6 m the pressure corresponding to the closest bound is returned.

Parameters:

date - date to compute temperature, pression, and density

position - position vector

frame - frame where the position vector is expressed

Returns:

the local pressure

Throws:

PatriusException - if point cannot be converted to body frame

getDensity

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

Getter for the local density for altitude in interval [0, 1E6]m.

Note: if altitude < 0 m or altitude > 1E6 m the density corresponding to the closest bound is returned.

Specified by:

getDensity in interface Atmosphere

Parameters:

date - date

position - position vector

frame - frame where the position vector is expressed

Returns:

the local density value (kg / m³)

Throws:

PatriusException - if point cannot be converted to body frame

getVelocity

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

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

getEarthBody

public BodyShape getEarthBody()

Getter for the earth body.

Returns:

the earth body

copy

public Atmosphere copy()

A copy of the atmosphere. By default copy is deep. If not, atmosphere javadoc will specify which attribute is not fully copied. In that case, the attribute reference is passed.

The following attributes are not deeply copied:

• earth: BodyShape

Specified by:

copy in interface Atmosphere

Returns:

a atmosphere of the detector.

checkSolarActivityData

public void checkSolarActivityData(AbsoluteDate start,
                                   AbsoluteDate end)

This methods throws an exception if the user did not provide solar activity on the provided interval [start, end]. All models should implement their own method since the required data interval depends on the model.

Specified by:

checkSolarActivityData in interface Atmosphere

Parameters:

start - range start date

end - range end date