danielmatz / coesa.jl

The U.S. Committee on Extension to the Standard Atmosphere (COESA) atmosphere model, also known as the U.S. Standard Atmosphere, 1976.

COESA

The U.S. Committee on Extension to the Standard Atmosphere (COESA) atmosphere model, also known as the U.S. Standard Atmosphere, 1976.

Usage

The main function is atmosphere(z), which returns the atmospheric state at geometric altitude z, where z has units of m.

The atmospheric state object that is returned has the following accessors:

• altitude, which returns the altitude in m
• density, which returns the density in units of kg/m³
• pressure, which returns the pressure in units of Pa
• temperature, which returns the temperature in units of K
• speed_of_sound, which returns the speed of sound in units of m/s
• mean_molecular_weight, which returns the mean molecular weight in units of kg/kmol
• dynamic_viscosity, which returns the dynamic viscosity in units of N*s/m^2; only available up to an altitude of 86km

using COESA
atmos = atmosphere(123.0)
rho = density(atmos)
T = temperature(atmos)
P = pressure(atmos)
c = speed_of_sound(atmos)
M = mean_molecular_weight(atmos)

Extensions

Integration with Unitful is provided by a package extension. If the altitude passed to atmosphere is a Quantity, then the accessors for the atmospheric state will also return Quantitys.

Implementation

For altitudes below 86km, the equations from the original report are used. The published tables have a discontinuity in the mean molecular weight and temperature at 86km. The report outlines how to blend out the discontinuity. We implement this blending here. In this region, the model output matches the published tables nearly perfectly. Only a few of the tested altitudes show differences. It is only in the pressure values, and in these cases we only miss the least significant digit.

For the region above 86km, the temperature is computed using the equations from the original report, but the equations for the mean molecular weight and pressure are much more complex. Instead, we adapt the method from Regan's Re-Entry Vehicle Dynamics to interpolate the tabulated mean molecular weight and pressure. We use a quadratic interpolation on the mean molecular weight and the natural log of the pressure. Because we are using interpolation, the computed pressure and density occasionally don't match the published values. The values are very small, and we still have at least 2 significant digits.

The density is computed as outlined by the original report.

The speed of sound is computed as outlined by the original report for altitudes below 86km. For altitudes above 86km, the speed of sound at 86km is used.

References

1. U.S. Standard Atmosphere, 1976. Stock No. 003-017-00323-0. http://ntrs.nasa.gov/archive/nasa/casi.ntrs.nasa.gov/19770009539.pdf.
2. Regan, F.J., Re-Entry Vehicle Dynamics, AIAA Press, New York, 1984.

coesa.jl's Issues

TagBot trigger issue

This issue is used to trigger TagBot; feel free to unsubscribe.

If you haven't already, you should update your TagBot.yml to include issue comment triggers.
Please see this post on Discourse for instructions and more details.

If you'd like for me to do this for you, comment TagBot fix on this issue.
I'll open a PR within a few hours, please be patient!