Help & user guide

What every section and button does. Hover any control in the app to see a short tooltip; this page is the fuller reference.

Sessions

The left rail lists your simulation sessions (slots). Each session holds its own configuration and can run independently.

History icon: Opens the Recent runs history (past and active runs).
Add (+) icon: Creates a new session, up to the capacity shown next to the Sessions heading. Disabled when full.
Expand / collapse (▶): Opens a session to reveal its control panel; opening a session also selects it.
Session name: Click to rename the session in place.
Status badge: Shows the session state (running, paused, stopped, error…). Hover for the orbit summary.
Configure (gear) icon: Opens the configuration editor for that session.
Close (✕) icon: Closes the session and deletes its profile. Refused while the session is active or if it is the last one.

Shown inside an open session. They drive the simulation for that slot.

Start (▶): Starts the simulation with the current configuration.
Pause / Resume (❚❚): Pauses a running simulation; the same button resumes it.
Step: While paused (lockstep runs only), advances the given number of frames — one frame equals one simulation time step.
Stop (■): Stops the simulation and finalizes the run.
Viewer share links: Opens the dialog to create and manage token-gated viewer links for this session.
Browser CLI: Opens the ADCS command console in its own window: the firmware's own adcs-cli, compiled to WebAssembly and run in your browser, or a Web Serial bridge to a physically attached OBC.
Operator console: Opens the operator console in its own window: pointing commands plus a live telemetry dashboard of customisable tabs, cards and charts.

The 3D/geospatial view of the spacecraft. On the dashboard it has a DVR bar; the standalone CesiumJS viewer adds display toggles.

Play / Pause: Plays or pauses the view without affecting the running simulation.
Scrub slider: Rewinds to review earlier moments of the running simulation.
● LIVE: Jumps back to the live edge of the stream.

The history table lists every run. Click a column header to sort; use Previous / Next to page through.

Run name: Double-click a finished run's name to rename it.
Download (↓) icon: Downloads the config snapshot plus the recorded streams as a single .zip.
Logs icon: Opens the console log — live for an active run, the saved log for a finished one.
Play icon: Opens the recorded playback for a finished run.
Replay icon: Deterministically re-runs the run from its captured configuration in a new slot.
Compare icon: Verifies a replay against its original source run.
Delete icon: Permanently removes the run and its recorded data.

The editor defines the hardware, simulation and ground stations for a session. Changes take effect on the next start.

Configure: Edits the configuration with form controls.
View files: Shows the generated sim_config.yaml and parameters.toml.
Save configuration: Saves changes; they apply when the session next starts.
Hardware / Simulation / Ground stations tabs: Switch between spacecraft & sensors, run pacing & orbit, and ground-station settings.
Expand view (⤢): Expands or collapses the mounting-frames viewer.
Add preset / Add custom station: Adds a regional test station, or one with your own coordinates.

Replays a finished run's recorded viewer stream.