CDPP 3DView Data Provider

CDPP 3DView (Centre de Données de la Physique des Plasmas 3DView) provides planet, spacecraft, and comet trajectories, each available in a choice of coordinate frames. Its integration into Speasy makes it easy to get trajectory data for various missions on any time range.

Note

This provider is enabled by default as of speasy 1.8. It previously shipped disabled while its web service had known issues; those are now mostly resolved, and broader use helps surface what’s left. If you hit problems, you can disable it again via disabled_providers, see Disabling data providers.

Basics: Getting data from Cdpp3dView module

All the trajectories available are discoverable using speasy dynamic inventory, they are organized by body type then body name (e.g. Trajectories.SPACECRAFT.MEX); the coordinate frame is not part of the inventory tree, it’s a keyword argument to get_data() (see coordinate_frame below, default J2000):

>>> import speasy as spz
>>> trajectories = spz.inventories.tree.cdpp3dview.Trajectories
>>> trajectories
<SpeasyIndex: Trajectories>
>>> mex_traj = spz.get_data(spz.inventories.tree.cdpp3dview.Trajectories.SPACECRAFT.MEX, "2010-01-02", "2010-01-03")
>>> mex_traj
<speasy.products.variable.SpeasyVariable object at ...>
>>> mex_traj.shape
(144, 3)
>>> mex_traj.columns
['x', 'y', 'z']

>>> # Optional parameters: coordinate_frame and sampling (in seconds)
>>> mex_framed = spz.get_data(spz.inventories.tree.cdpp3dview.Trajectories.SPACECRAFT.MEX, "2010-01-02", "2010-01-03",
...                             coordinate_frame="ECLIPJ2000")
>>> mex_framed
<speasy.products.variable.SpeasyVariable object at ...>
>>> mex_sampled = spz.get_data(spz.inventories.tree.cdpp3dview.Trajectories.SPACECRAFT.MEX, "2010-01-02", "2010-01-03",
...                                sampling="60")
>>> mex_sampled
<speasy.products.variable.SpeasyVariable object at ...>

Coordinate frames

3DView supports far more frames than the other providers, and the list comes from the server rather than from Speasy, so this is always the authoritative check:

>>> frames = spz.cdpp3dview.get_frames()
>>> 'ECLIPJ2000' in frames
True

Passing a frame the server doesn’t know raises Cdpp3dViewWebException, and the message lists the frames that are available.

Note

coordinate_system (the kwarg name used by the SSCWeb provider) is accepted as an alias for coordinate_frame here too, so switching between SSCWeb and 3DView doesn’t require renaming a kwarg. Passing both with different values raises Cdpp3dViewWebException rather than silently picking one. UiowaEphTool has no such kwarg at all — its coordinate system is chosen by browsing the inventory tree instead, see its own page.

The table below is generated automatically from the server every time these docs are built, so it needs no manual updates and cannot go stale the way a hand-written list would. If the server couldn’t be reached during the build, a note below says so and a cached snapshot is shown instead:

The live query to the 3DView server failed during this build (HTTP Error 502: Proxy Error); showing a cached snapshot captured on 2026-07-22 instead. Build attempted on 2026-09-18 16:06 UTC. Run spz.cdpp3dview.get_frames() yourself for the current list.

Frame	Centered on	Description
J2000	Sun	Earth mean equator, dynamical equinox of J2000
ECLIPJ2000	Sun	Ecliptic coordinates based upon the J2000 frame
HEE	Sun	Heliocentric Earth Ecliptic
HEEQ	Sun	Heliocentric Earth Equatorial
HCI	Sun	Heliocentric Inertial
IAU_SUN	Sun	Body-Fixed Frame
MESO	Mercury	Mercury-centric Solar Orbital
MEME	Mercury	EME2000 centered on Mercury
MECLIP	Mercury	ECLIPJ2000 centered on Mercury
MESE	Mercury	Mercury-centric Solar Ecliptic
MESEQ	Mercury	Mercury-centric Solar Equatorial
IAU_MERCURY	Mercury	Body-Fixed Frame
VSO	Venus	Venus-centric Solar Orbital
VME	Venus	Venus Mean Equator
IAU_VENUS	Venus	Body-Fixed Frame
GSE	Earth	Geocentric Solar Ecliptic
EME	Earth	Earth Mean Equator and Equinox
GSEQ	Earth	Geocentric Solar Equatorial
ECLIPDATE	Earth	Earth Mean Ecliptic and Equinox
MAG	Earth	Geomagnetic coordinate system (definition not valid after 31/12/2014)
GSM	Earth	Geocentric solar magnetospheric system (definition not valid after 31/12/2014)
SM	Earth	Solar magnetic coordinates (definition not valid after 31/12/2014)
IAU_EARTH	Earth	Body-Fixed Frame
LSE	Moon	Moon-centric Solar Ecliptic
LME	Moon	Moon Mean Equator
IAU_MOON	Moon	Body-Fixed Frame
MSO	Mars	Mars-centric Solar Orbital
MME	Mars	Mars Mean Equator
IAU_MARS	Mars	Body-Fixed Frame
PSE	Phobos	Phobos-centric Solar Ecliptic
PME	Phobos	Phobos Mean Equator
DSE	Deimos	Deimos-centric Solar Ecliptic
DME	Deimos	Deimos Mean Equator
JSO	Jupiter	Jovian Solar Orbital Coordinates
JEME	Jupiter	EME2000 centered on Jupiter
JECLIP	Jupiter	ECLIPJ2000 centered on Jupiter
JSM	Jupiter	Jovian Solar Magnetospheric
SYSTEM_3	Jupiter	System 3
IAU_JUPITER	Jupiter	Body-Fixed Frame using IAU 2009 constants
IPHIO	Io	Io phio
EPHIO	Europa	Europa phio
GPHIO	Ganymede	Ganymede phio
CPHIO	Callisto	Callisto phio
KSO	Saturn	Kronocentric Solar Orbital Coordinates
KEME	Saturn	EME2000 centered on Saturn
KECLIP	Saturn	ECLIPJ2000 centered on Saturn
KSM	Saturn	Kronocentric Solar Magnetospheric
IAU_SATURN	Saturn	Body-Fixed Frame
KMIEME	Mimas	EME2000 centered on Mimas
KMIECLIP	Mimas	ECLIPJ2000 centered on Mimas
MIIS	Mimas	Mimas Inter-action coordinate System
KENEME	Enceladus	EME2000 centered on Enceladus
KENECLIP	Enceladus	ECLIPJ2000 centered on Enceladus
ENIS	Enceladus	Enceladus Inter-action coordinate System
KTEEME	Tethys	EME2000 centered on Tethys
KTEECLIP	Tethys	ECLIPJ2000 centered on Tethys
TEIS	Tethys	Tethys Inter-action coordinate System
KDIEME	Dione	EME2000 centered on Dione
KDIECLIP	Dione	ECLIPJ2000 centered on Dione
DIIS	Dione	Dione Inter-action coordinate System
KRHEME	Rhea	EME2000 centered on Rhea
KRHECLIP	Rhea	ECLIPJ2000 centered on Rhea
RHIS	Rhea	Rhea Inter-action coordinate System
KTIEME	Titan	EME2000 centered on TItan
KTIECLIP	Titan	ECLIPJ2000 centered on TItan
TIIS	Titan	TItan Inter-action coordinate System
KHYEME	Hyperion	EME2000 centered on Hyperion
KHYECLIP	Hyperion	ECLIPJ2000 centered on Hyperion
HYIS	Hyperion	Hyperion Inter-action coordinate System
KIAEME	Iapetus	EME2000 centered on Iapetus
KIAECLIP	Iapetus	ECLIPJ2000 centered on Iapetus
IAIS	Iapetus	Iapetus Inter-action coordinate System
KPHEME	Phoebe	EME2000 centered on Phoebe
KPHECLIP	Phoebe	ECLIPJ2000 centered on Phoebe
PHIS	Phoebe	Phoebe Inter-action coordinate System
KHEEME	Helene	EME2000 centered on Helene
KHEECLIP	Helene	ECLIPJ2000 centered on Helene
HEIS	Helene	Helene Inter-action coordinate System
KTLEME	Telesto	EME2000 centered on Telesto
KTLECLIP	Telesto	ECLIPJ2000 centered on Telesto
TLIS	Telesto	Telesto Inter-action coordinate System
UEME	Uranus	EME2000 centered on Uranus
UECLIP	Uranus	ECLIPJ2000 centered on Uranus
USO	Uranus	Uranus-centric Solar Orbital Coordinates
IAU_URANUS	Uranus	Body-Fixed Frame
NEME	Neptune	EME2000 centered on Neptune
NECLIP	Neptune	ECLIPJ2000 centered on Neptune
NSO	Neptune	Neptune-centric Solar Orbital Coordinates
IAU_NEPTUNE	Neptune	Body-Fixed Frame
PEME	Pluto	EME2000 centered on Pluto
PECLIP	Pluto	ECLIPJ2000 centered on Pluto
PSO	Pluto	Pluto-centric Solar Orbital Coordinates
IAU_PLUTO	Pluto	Body-Fixed Frame
67PCG_EME	Churyumov-Gerasimenko	EME2000 centered on comet churyumov gerasimenko
67PCG_CSO	Churyumov-Gerasimenko	Comet solar oriented centered on comet churyumov gerasimenko
LUTETIA_EME	Lutetia	EME2000 centered on asteroid LUTETIA
LUTETIA_CSO	Lutetia	Comet solar oriented centered on asteroid LUTETIA
STEINS_EME	Steins	EME2000 centered on asteroid STEINS
STEINS_CSO	Steins	Comet solar oriented centered on asteroid STEINS
HALLEY_EME	Halley	EME2000 centered on asteroid HALLEY
HALLEY_CSO	Halley	Comet solar oriented centered on asteroid HALLEY
GRIGGSKELL_EME	Grigg-Skjellerup	EME2000 centered on asteroid GRIGG-SKJELLERUP
GRIGGSKELL_CSO	Grigg-Skjellerup	Comet solar oriented centered on asteroid GRIGG-SKJELLERUP
IAU_DIDYMOS	Didymos	Body-Fixed Frame
DIDYMOS_EME	Didymos	EME2000 centered on asteroid DIDYMOS
DIDYMOS_CSO	Didymos	Comet solar oriented centered on asteroid DIDYMOS

The naming follows a consistent pattern across bodies, so you can usually guess an unfamiliar one:

• IAU_<body> — body-fixed frame (rotates with the body), as defined by the IAU.

• <X>SO — “X Solar Orbital”: a GSE-style, Sun-body-line frame generalized to body X.

  Warning

  Guessing <X>SO frames has a collision: Mars is MSO but Mercury is MESO (and the Moon has no SO frame at all). A wrong guess that happens to be a real frame yields perfectly valid data for the wrong planet, with no error — when in doubt, check the table above.

• <X>SM — “X Solar Magnetic”: like SM/GSM, referenced to body X’s magnetic dipole (in 3DView’s frame list, only defined for three of the solar system’s magnetized planets: Earth, Jupiter, Saturn). For Earth specifically, the SM/GSM/MAG frames are not valid after 31/12/2014, as the generated table above mentions; the table is the authoritative check for other bodies.

• <X>ECLIP / <X>EME — inertial frames centred on body X, referenced to the ecliptic or to Earth’s mean equator/equinox (the same convention as ECLIPJ2000/J2000) respectively.

• <BODY>_CSO / <BODY>_EME — the comet/asteroid equivalents of the SO and EME frames, spelled with the full body name as a suffix: 67PCG_CSO, LUTETIA_CSO, HALLEY_CSO, 67PCG_EME, …

get_data() also accepts if_newer_than=... to only fetch data newer than a given timestamp (it sends an If-Modified-Since header to the server).