Skip to content

Commit 8df6ac2

Browse files
committed
Update README to reflect added gravity model
1 parent 7abc5f2 commit 8df6ac2

1 file changed

Lines changed: 32 additions & 15 deletions

File tree

README.md

Lines changed: 32 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,24 +2,36 @@
22
[![Release](https://github.com/cmorrison31/TerraFrame/actions/workflows/release.yml/badge.svg)](https://github.com/cmorrison31/TerraFrame/actions/workflows/release.yml)
33

44
# TerraFrame
5+
TerraFrame is a library designed to provided key Earth related calculations and
6+
associated functionality to modeling & simulation software. Primarily,
7+
TerraFrame provides Earth orientation and gravity routines.
58

6-
TerraFrame is a library designed to provide earth-orientation functionally to
7-
modeling and simulation software by calculating the transformation
8-
tensor between the Geocentric Celestial Reference System (GCRS) and the
9-
International Terrestrial Reference System (ITRS). This transformation accounts for
10-
precession, nutation, and polar motion using the IAU 2006/2000A
11-
precession-nutation theory and IERS data files.
9+
## Earth Orientation
10+
TerraFrame provides an implementation of the IAU 2006/2000A precession-nutation
11+
model which accounts for precession, nutation, and polar motion. Specifically,
12+
this implementation provides a transformation tensor between the Geocentric
13+
Celestial Reference System (GCRS) and the International Terrestrial Reference
14+
System (ITRS).
1215

13-
Additionally, support is provided for converting from geodetic latitude,
14-
longitude, and height above ellipsoid to geocentric cartesian coordinates or
15-
vice versa. The WGS84 spheroid and a simple spherical earth are provided as
16-
built-in options.
16+
IERS precession and nutation model data files are shipped with TerraFrame.
17+
Utility code is also provided which automates the downloading of IERS data for
18+
polar motion, UTC, and UT1 offsets.
1719

18-
TerraFrame provides robust datetime and timescale conversion functionality that
19-
is fully leap second aware. Conversions between UTC, UT1, TT, and TAI are
20-
provided. The user is encouraged to not work in UTC directly to avoid
21-
leap second ambiguity. Conversion to UTC from TT or TAI can be safely done
22-
in post-processing.
20+
## Gravity
21+
Gravity calculations are provided by an implementation of the EGM2008. A double
22+
Clenshaw summation approach is used to evaluate the spherical harmonics which
23+
yields high numerical stability and computational efficiency. TerraFrame is
24+
numerically capable of evaluating EGM2008 to it’s complete degree and
25+
order: 2190.
26+
27+
By default, only data for degree and order 200 is shipped with TerraFrame for
28+
space efficiency. Most near earth modeling & simulation applications will not
29+
need to exceed degree and order 100 per WGS84 guidance.
30+
31+
## Ancillary Functionality
32+
Support is provided for converting from geodetic latitude, longitude, and height above ellipsoid to geocentric cartesian coordinates or vice versa. The WGS84 spheroid and a simple spherical earth are provided as built-in options.
33+
34+
TerraFrame also provides robust datetime and timescale conversion functionality that is fully leap second aware. Conversions between UTC, UT1, TT, and TAI are provided. The user is encouraged to not work in UTC directly to avoid leap second ambiguity. Conversion to UTC from TT or TAI can be safely done in post-processing.
2335

2436
![Animation of CGRS to ITRS Transformation](https://raw.githubusercontent.com/cmorrison31/TerraFrame/main/Animations/GCRS_to_ITRS.gif)
2537

@@ -51,6 +63,8 @@ provided by the following sources:
5163
- Gérard Petit and Brian Luzum (Eds.). IERS Conventions (2010), IERS Technical
5264
Note No. 36, Frankfurt am Main: Verlag des Bundesamts für Kartographie und
5365
Geodäsie, 2010. ISBN: 3-89888-989-6.
66+
- Deakin, R.E., 1998, 'Derivatives of the earth’s potentials'. Geomatics
67+
Research Australasia, No.68, June, 1998, pp. 31-60.
5468

5569
# Acronyms and Abbreviations
5670

@@ -60,6 +74,7 @@ provided by the following sources:
6074
| CIP | Celestial Intermediate Pole |
6175
| CIRS | Celestial Intermediate Reference System |
6276
| CEO | Celestial Ephemeris Origin |
77+
| EGM | Earth Gravitational Model |
6378
| GCRS | Geocentric Celestial Reference System |
6479
| IAU | International Astronomical Union |
6580
| IERS | International Earth Rotation and Reference Systems Service |
@@ -71,4 +86,6 @@ provided by the following sources:
7186
| TT | Terrestrial Time |
7287
| UT1 | Universal Time |
7388
| UTC | Coordinated Universal Time |
89+
| WGS | World Geodetic System |
90+
7491

0 commit comments

Comments
 (0)