Trajectory¶
-
class
heliopy.spice.
Trajectory
(target)¶ Bases:
object
A generic class for the trajectory of a single body.
Objects are initially created using only the body. To perform the actual trajectory calculation run
generate_positions()
. The generated positions are then available via. the attributestimes
,x
,y
, andz
.- Parameters
target (str) – Name of the target. The name must be present in the loaded kernels.
Notes
When an instance of this class is created, a leapseconds kernel and a planets kernel are both automatically loaded.
See also
furnish
for loading in local spice kernels.
Attributes Summary
A
SkyCoord
object.True
if positions have been generated,False
otherwise.Observing body.
Magnitude of position vectors.
Speed (magnitude of velocity vectors).
The coordinate frame used by SPICE.
The body whose coordinates are being calculated.
A
Time
object containing the times sampled.Velocity.
x component of velocity.
y component of velocity.
z component of velocity.
x coordinates of position.
y coordinates of position.
z coordinates of position.
Methods Summary
change_units
(unit)Convert the positions to different units.
generate_positions
(times, observing_body, frame)Generate positions from a spice kernel.
Attributes Documentation
-
coords
¶ A
SkyCoord
object.Notes
The following frames are supported:
Spice name
SkyCoord class
J2000
ICRS
IAU_SUN
HeliographicCarrington
-
generated
¶ True
if positions have been generated,False
otherwise.
-
observing_body
¶ Observing body. The position vectors are all specified relative to this body.
-
r
¶ Magnitude of position vectors.
-
speed
¶ Speed (magnitude of velocity vectors).
-
spice_frame
¶ The coordinate frame used by SPICE.
-
target
¶ The body whose coordinates are being calculated.
-
velocity
¶ Velocity.
Returned as a shape
(n, 3)
array, where then
axis is the time axis.
-
vx
¶ x component of velocity.
-
vy
¶ y component of velocity.
-
vz
¶ z component of velocity.
-
x
¶ x coordinates of position.
-
y
¶ y coordinates of position.
-
z
¶ z coordinates of position.
Methods Documentation
-
change_units
(unit)¶ Convert the positions to different units.
- Parameters
unit (astropy.units.Quantity) – Must be a unit of length (e.g. km, m, AU).
-
generate_positions
(times, observing_body, frame)¶ Generate positions from a spice kernel.
- Parameters
times (time like) – An object that can be parsed by ~astropy.time.Time.
observing_body (str or int) – The observing body. Output position vectors are given relative to the position of this body. See https://naif.jpl.nasa.gov/pub/naif/toolkit_docs/C/req/naif_ids.html for a list of bodies.
frame (str) – The coordinate system to return the positions in. See https://naif.jpl.nasa.gov/pub/naif/toolkit_docs/C/req/frames.html for a list of frames.