1.0.7 user manual

SpiView – User Manual

1. Introduction

SpiView is a web application for 3D visualisation of mission scenarios based on SPICE data. It lets you move through time in a SPICE scenario, watch the position of the spacecraft and celestial bodies, read live telemetry, and show or hide the spacecraft sensor fields of view.

2. Interface overview

The interface has four areas:

  1. Header: SpiView logo and version, and below it the name of the loaded scenario.
  2. Main toolbar: Menu, Time, Bodies, Sensors and Snapshot buttons.
  3. Settings button: access to display options.
  4. Playback panel and timeline: time controls at the bottom of the screen.
Header, toolbar and settings buttons
Playback panel and timeline

2.1 Active scenario

The label under the logo shows the SPICE metakernel used by the loaded scenario, for example bc_plan_v434_20261112_001.

Scenario label

2.2 Main toolbar

ButtonFunction
MenuExpands or collapses the toolbar.
TimeOpens the dialog to enter a specific date and time.
BodiesOpens the viewpoint selector (spacecraft and bodies).
SensorsOpens the spacecraft sensor controller.
SnapshotCaptures the current view and downloads it as a PNG file to the browser’s downloads folder.

2.3 Mobile layout

The timeline and the right-click context menus are not used on mobile version.

SpiView on phone

3. Viewpoint selector (Bodies)

The Bodies button opens the View Point dialog, where you choose the object the camera focuses on.

View Point dialog
  • Search field: filters by body, spacecraft or parts.
  • Spacecrafts: spacecraft available in the scenario. The number next to the title is the item count.
  • Bodies: celestial bodies (in this scenario: Earth, Mercury, Sun and Venus).
  • GOTO: moves the camera to that object and sets it as the centre of the view.
  • Each section can be collapsed or expanded with the triangle to the left of its title.
  • Close (or the ✕ at the top) closes the dialog.

4. Sensor controller (Sensors)

The Sensors button opens the Sensor Controller, which manages the sensors of the selected spacecraft.

Sensor Controller
  • The top indicator shows the active spacecraft and the number of visible sensors out of the total (for example MPO_MMO_MO [0/72] means 0 of 72 sensors shown).
  • Search field: filters the spacecraft sensors by name.
  • Sensors are grouped by instrument (for example PWI_MEF1, MSASI_SLIT, MPPE-LEP, MPPE_ENA). Each group can be collapsed or expanded and shows its sensor count.
  • Show all: shows every sensor in the group at once.
  • Each sensor has a status and a colour band. STBY means standby (not displayed); ACTIVE means the sensor is displayed. The colour band is the colour the sensor field of view is drawn with in the 3D view.
  • Close closes the dialog.

To switch a sensor on, click its label.

5. Date entry (Time)

The Time button opens the Target Epoch Insertion dialog, on the UTC scale.

Target Epoch Insertion

Fields:

  • Year, Month (abbreviated English name) and Day.
  • Hours, Minutes and Seconds.

Values can be typed or changed with the field arrows. Press Select to jump to that epoch, or Cancel to close without changes.

The dialog checks the date against the scenario coverage. When playback reaches the end of the available data, or the selected epoch is outside the range, SpiView shows an END OF COVERAGE REACHED banner with a Restart button and a close (✕) button.

End of coverage banner

Restart returns playback to the start of the scenario coverage.

6. Display settings (Settings)

The Settings button is not a dialog: it only expands (or collapses) a small menu with the Orbits and Labels toggles.

Settings menu
OptionFunction
OrbitsShows or hides orbits of the solar system bodies.
LabelsShows or hides labels of the solar system bodies.

Orbits and Labels are on/off toggles.

7. Context menus (right-click)

On desktop browsers, right-clicking an object in the 3D view opens a context menu specific to that object. Context menus are not used on mobile version.

7.1 Spacecraft menu

Right-click on the spacecraft to open a menu headed SPACECRAFT: <name>

Spacecraft context menu
OptionFunction
Hide Trajectory / Show TrajectoryHides or shows the spacecraft trajectory line.
Show Label / Hide LabelShows or hides the spacecraft name label.
Show Axes / Hide AxesShows or hides the spacecraft reference-frame axes.
Show Direction Vectors / Hide Direction VectorsShows or hides vectors pointing from the spacecraft towards the Sun, the Earth and the body it orbits (or the centre of its trajectory).
Goto SpacecraftMoves the camera to the spacecraft and centres the view on it.

The toggles work as Show/Hide pairs: once applied, the entry changes to its opposite.

7.2 Sensor menu

Right-click on a displayed sensor field of view (the translucent pyramid) to open a menu headed SENSOR: <name> (for example MERTIS_TIR_B_SPACE).

Sensor context menu
  • Colour swatches: pick the colour used to draw the sensor field of view.
  • Look through <sensor>: places the camera at the sensor and shows the scene from its point of view.
  • Hide <sensor>: hides that sensor.

To leave “look through” mode, open Menu → Bodies and select where you want to go (GOTO).

7.3 Body menu

Right-click on a celestial body (for example Mercury) to open a menu headed BODY: <name>.

Body context menu
OptionFunction
Hide Trajectory / Show TrajectoryHides or shows the body trajectory line.
Show Label / Hide LabelShows or hides the body name label.
Show Grid / Hide GridShows or hides the planetographic grid (latitude and longitude lines with their labels) on the body.
Show Axes / Hide AxesShows or hides the body reference-frame axes.
Track BodyShortcut for Bodies → GOTO: moves the camera to the body and centres the view on it.

As in the other menus, each toggle switches between its Show and Hide form.

8. Telemetry panel

Clicking on the spacecraft opens a telemetry panel at the top right of the screen, headed TARGET: SPACECRAFT with the name of the selected object. Close it with the ✕ in the corner.

Telemetry panel
FieldMeaning
Altitude above <body> surfaceDistance above the surface of the body the spacecraft orbits (or the centre of its trajectory), for example Mercury, in km.
Heliocentric distance (to Sun)Distance to the Sun, in AU and in km.
Distance to Earth (range)Distance between the spacecraft and Earth, in km.
One-way signal time (OWST)Time a signal takes to travel from the spacecraft to Earth, in minutes and seconds (and in seconds).

The values update as the scenario time changes.

9. Playback panel and timeline

The bottom of the screen shows the scenario time controls.

Playback panel
  • Speed: playback speed selector. Available options: 1 s, 5 s, 1 minute, 5 minutes, 1 hour, 1 day and 10 days.
  • Pause / Play: stops or resumes playback.
  • Reverse: reverses the direction of time.
  • Current date and time (UTC), in the format 2026 NOV 18 07:18:51.
  • Center: object the view is centred on (in the screenshot, mpo_mmo_mo).
  • Follow: keeps the timeline time pointer following the date evolution.
  • Now: jumps to the current date and time.

9.1 Timeline

Next to the playback controls, the timeline shows the scenario time axis with year ticks and a marker at the current time. The timeline is available on desktop browsers only; it is not used on mobile.

  • Click: jumps to the selected time and enables the spacecraft that are active at that moment.
  • Zoom: mouse wheel over the timeline.
  • Pan: hold Shift and drag.

10. Camera controls

The 3D view camera is controlled with Orbit Controls, so it follows their standard behaviour. The camera orbits around the current centre of the view (see Center in the playback panel).

ActionMouseTouch (mobile)
Rotate (orbit)Left button + dragOne-finger drag
ZoomMouse wheel (or middle button + drag)Two-finger pinch
PanRight button + dragTwo-finger drag

To change the centre of the view, use Bodies → GOTO, the context menus (Goto Spacecraft, Track Body) or the Follow button.

11. Common workflows

  1. Go to a specific date: Time → fill in the fields → Select (or click on the timeline).
  2. Centre the view on a body: Bodies → search for the object → GOTO.
  3. See an instrument field of view: Sensors → find the group → switch on its sensors (or Show all).
  4. View the scene from a sensor: right-click the sensor field of view → Look through.
  5. Return from a sensor view: Menu → Bodies → select the destination.
  6. Read the spacecraft distances and signal time: click on the spacecraft.
  7. Return to the present: Now.
  8. Save an image: Snapshot (PNG saved to the browser downloads folder).

12. Contact

ESA SPICE Service
spice@cosmos.esa.int

13. Known issues

  • On mobile, the timeline are not used.
  • On mobile, contextual menues are not used.
  • Kernel coverage issues, specially on scenarios with dynamic boundaries metakernels (OPS). When there is no coverage for bodies at launching the app, there are weird visualization issues, e.g. wrong scaling.
  • When multiple FoVs are visualized, it seems they overlap the space and no matter where you right-click you get the look through option.
  • Field-of-view depth not computed correctly.