Skip to content

Commit 40c6e6c

Browse files
Docs: reword intro to Planetary Reference Frames
Hopefully this starts to clarify that a planet’s ellipsoid parameters are a different concept than the planet’s reference frame, which is purely a coordinate system oriented to the planet’s surface.
1 parent 7dfae00 commit 40c6e6c

1 file changed

Lines changed: 28 additions & 18 deletions

File tree

documentation/planetary.rst

Lines changed: 28 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,33 @@
44
============================
55

66
Skyfield has limited support for planetary reference frames
7-
as defined in Jet Propulsion Lab data files.
8-
It supports:
9-
10-
* Loading ``.tf`` and ``.tpc`` text files
11-
defining a wide array of planetary constants.
12-
13-
* Loading ``.bcp`` binary arrays
14-
that predict the orientation in space of Solar System bodies
15-
over a range of dates.
16-
17-
* Given a latitude and longitude on a Solar System body like the Moon that is
18-
(a) spherical and
19-
(b) whose orientation is defined by a data series in a ``.bcp`` file,
20-
computing that surface position’s location in space —
21-
allowing observations either from the point of view of that surface position,
22-
or observations of that surface position
23-
for other observers in the Solar System.
7+
and planetary constants
8+
as defined in Jet Propulsion Lab (JPL) data files.
9+
Skyfield can:
10+
11+
* Load a ``.tpc`` “Text Planetary Constants” file
12+
that can specify a wide array of planetary constants,
13+
including a body’s radius and the shape of its ellipsoid.
14+
15+
* Load a ``.tf`` “Text Frame” file
16+
that defines one or more reference frames
17+
describing the axis and rotation of a body and,
18+
thus, the orientation of that body’s surface in space.
19+
20+
* Load a ``.bcp`` binary array
21+
that provides the same information but in binary form.
22+
23+
* Compute the position of a location on a body’s surface
24+
relative to that body’s center,
25+
given (1) a Solar System body
26+
that’s spherical
27+
and whose orientation is defined by a data series in a ``.bcp`` file
28+
(the Moon is a good example),
29+
and (2) the latitude and longitude of the position.
30+
This allows the user
31+
both to observe other targets from that surface position,
32+
and to observe the surface position itself
33+
from elsewhere in the Solar System.
2434

2535
This leaves several features of such files still unsupported, though.
2636
Skyfield:
@@ -181,7 +191,7 @@ Computing a raw rotation matrix
181191
If you are directly manipulating vectors,
182192
you might simply want Skyfield to compute the NumPy rotation matrix
183193
for rotating vectors from the ICRF into the frame of reference
184-
of the Solar System body.
194+
of the Solar System body’s longitude and latitude.
185195
The ``frame`` object returned above
186196
can return these matrices directly.
187197
If given a single time ``t``,

0 commit comments

Comments
 (0)