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:
- Header: SpiView logo and version, and below it the name of the loaded scenario.
- Main toolbar: Menu, Time, Bodies, Sensors and Snapshot buttons.
- Settings button: access to display options.
- Playback panel and timeline: time controls at the bottom of the screen.
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.
2.2 Main toolbar
| Button | Function |
|---|---|
| Menu | Expands or collapses the toolbar. |
| Time | Opens the dialog to enter a specific date and time. |
| Bodies | Opens the viewpoint selector (spacecraft and bodies). |
| Sensors | Opens the spacecraft sensor controller. |
| Snapshot | Captures 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.
3. Viewpoint selector (Bodies)
The Bodies button opens the View Point dialog, where you choose the object the camera focuses on.
- 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.
- 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.
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.
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.
| Option | Function |
|---|---|
| Orbits | Shows or hides orbits of the solar system bodies. |
| Labels | Shows 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>
| Option | Function |
|---|---|
| Hide Trajectory / Show Trajectory | Hides or shows the spacecraft trajectory line. |
| Show Label / Hide Label | Shows or hides the spacecraft name label. |
| Show Axes / Hide Axes | Shows or hides the spacecraft reference-frame axes. |
| Show Direction Vectors / Hide Direction Vectors | Shows or hides vectors pointing from the spacecraft towards the Sun, the Earth and the body it orbits (or the centre of its trajectory). |
| Goto Spacecraft | Moves 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).
- 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>.
| Option | Function |
|---|---|
| Hide Trajectory / Show Trajectory | Hides or shows the body trajectory line. |
| Show Label / Hide Label | Shows or hides the body name label. |
| Show Grid / Hide Grid | Shows or hides the planetographic grid (latitude and longitude lines with their labels) on the body. |
| Show Axes / Hide Axes | Shows or hides the body reference-frame axes. |
| Track Body | Shortcut 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.
| Field | Meaning |
|---|---|
| Altitude above <body> surface | Distance 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.
- 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).
| Action | Mouse | Touch (mobile) |
|---|---|---|
| Rotate (orbit) | Left button + drag | One-finger drag |
| Zoom | Mouse wheel (or middle button + drag) | Two-finger pinch |
| Pan | Right button + drag | Two-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
- Go to a specific date: Time → fill in the fields → Select (or click on the timeline).
- Centre the view on a body: Bodies → search for the object → GOTO.
- See an instrument field of view: Sensors → find the group → switch on its sensors (or Show all).
- View the scene from a sensor: right-click the sensor field of view → Look through.
- Return from a sensor view: Menu → Bodies → select the destination.
- Read the spacecraft distances and signal time: click on the spacecraft.
- Return to the present: Now.
- 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.