Documentation Index
Fetch the complete documentation index at: https://docs.valar.space/llms.txt
Use this file to discover all available pages before exploring further.
For the complete documentation index, see llms.txt.
The Burn Plan page allows you to manage spacecraft maneuvers (burns). You can view, import, export, and delete planned and executed burns, as well as analyze their performance after execution.
Route: /maneuvers/burn-plan
Page Layout
Filtering
Spacecraft Filter
Filter which spacecraft’s burn plans are displayed.
| Element | Description |
|---|
| Location | First control in topbar |
| Control | Multi-select dropdown |
| Default | Shows all spacecraft when none selected |
- Click to open popover dropdown
- Check/uncheck spacecraft to include
- Click Apply to confirm
- Click Clear All to deselect
Time Range Filter
Filter burn plans by execution date.
| Option | Description |
|---|
| Week | Last 7 days (default) |
| Month | Last 30 days |
| Custom | Select specific range |
Group By Option
| Option | Effect |
|---|
| Spacecraft | Groups burns by spacecraft with collapsible headers (default) |
| None | Flat list without grouping |
Burn Plan List
List Item Display
Each row shows:
| Element | Description |
|---|
| Checkbox | Hover-reveal, for bulk selection |
| Display ID | User-facing ID (e.g., “MAN-1”) |
| Maneuver ID | System identifier |
| Delta-V Badge | Total delta-v (e.g., “2.500 m/s”) |
| Spacecraft Badge | Spacecraft name with colored satellite icon |
| Execution Date | ”Mon DD” format with full tooltip |
Row Interactions
- Click row: Selects burn plan and shows details in right panel
- Click checkbox: Toggles selection for bulk actions (doesn’t change details view)
- Hover: Reveals checkbox
Grouped View
When grouped by spacecraft, the group header shows:
- Spacecraft name
- Maneuver count
- Collapse/expand chevron
- Page navigation (10 items per page per group)
Per-group actions:
- Select All: Select all burns in current page of group
- Clear: Deselect all in group
Details Panel
Shows the Maneuver ID with a more menu containing:
| Action | Description |
|---|
| Edit Composition | Open modal to edit epoch times |
| Expand Composition | View full CCSDS OCM format |
| Export | Download as OCM file |
| Delete | Delete with confirmation |
| Field | Description | Format |
|---|
| Spacecraft | Spacecraft name | With colored satellite icon |
| Delta-V | Total velocity change | X.XXX m/s |
| Delta-Mass | Propellant consumed | Auto-converts (kg or g) |
| Duration | Burn duration | Xh Ym Zs format |
| Creation Date | When created | Mon DD, HH:MM UTC |
| Epoch | Execution time | Mon DD, HH:MM UTC |
Composition Section
| Field | Description |
|---|
| Basis | PLANNED or TELEMETRY |
| Device | Thruster device (default: “ALL”) |
| Reference Frame | RTN (Radial-Tangential-Normal) or TNW |
| DC Type | CONTINUOUS or IMPULSIVE |
- Purpose: Shows burn efficiency (actual vs planned)
- Display: Bar chart with percentage centered at 100% (nominal)
- Color coding:
- Green (95-105%): Excellent - within 5% of plan
- Yellow (90-110%): Good - within 10% of plan
- Red (outside range): Review needed
Pointing Chart:
- Purpose: Shows angular deviation from planned direction
- Display: Dual bar chart
- Blue: In-Plane (Azimuth) deviation
- Orange: Out-of-Plane (Elevation) deviation
- Unit: Degrees
- Interpretation: Lower values = better accuracy
Import Dialog
Access by clicking the Import button in the topbar.
Configuration
Spacecraft Selection: Choose target spacecraft for import.
Format Selection:
| Format | Description |
|---|
| OCM | CCSDS Orbit Comprehensive Message |
Import Mode
| Mode | Description |
|---|
| New Maneuver | Import new planned maneuvers |
| Telemetry | Report execution of existing maneuvers |
Data Merge Strategy
| Strategy | Description |
|---|
| Update | Overlapping maneuvers updated by ID |
| Replace | Overlapping maneuvers removed and replaced |
File Upload
Drag and drop files onto the upload zone, or click to browse.
Accepted Files:
- New Maneuver (OCM):
.ocm, .txt
- Telemetry:
.tdm, .oem, .csv, .txt, .ocm
Multiple files are supported.
Upload Status
| Status | Display |
|---|
| Idle | Pending upload |
| Uploading | Progress bar |
| Success | Green checkmark |
| Error | Red X with error message |
Export Dialog
Access by clicking the Export button in the topbar.
Configuration:
- Spacecraft: Select spacecraft to export from
- Date Range: Select time period
- Format: OCM (CCSDS standard)
Output: OCM file download with filename including spacecraft ID and date.
Edit Composition Dialog
Access from Details panel > More menu > Edit Composition.
Updates epoch times based on telemetry data.
| Field | Description | Format |
|---|
| Maneuver ID | Read-only reference | - |
| Start Epoch | Actual burn start | YYYY-MM-DD HH:mm:ss.SSSSSS |
| End Epoch | Actual burn end | YYYY-MM-DD HH:mm:ss.SSSSSS |
Expand Composition Dialog
Access from Details panel > More menu > Expand Composition.
Displays the full CCSDS OCM format of the maneuver in a scrollable code block.
Appears when one or more rows are selected via checkboxes. Fixed at bottom center.
| Action | Description |
|---|
| X selected | Shows selection count |
| Select All | Select all visible maneuvers |
| Export as OCM | Export selected to OCM files |
| Delete | Bulk delete with confirmation |
| Clear | Deselect all |
- Single maneuver: Direct OCM file download
- Multiple maneuvers: ZIP file containing OCM files
- Filename:
maneuvers-{spacecraftId}-{date}.zip
Delete Confirmation
Single delete confirmation dialog:
Timeline View
A horizontal Gantt-style visualization of every burn for the selected spacecraft, with orbital events overlaid as bands and markers to give thruster timing the right context.
Route: /maneuvers/burn-plan/timeline
The timeline is anchored to a UTC time axis along the top. Each spacecraft row holds the burns scheduled or executed within the current window, drawn as Gantt-style segments. Orbital events are overlaid above the burn rows as either shaded bands (entry-to-exit duration) or instantaneous markers (single-epoch events).
Zoom Toggle
Two zoom levels control how densely time is packed onto the horizontal axis.
| Mode | Description |
|---|
| Wide | More pixels per hour, useful for inspecting individual burns and short-duration events |
| Compact | Fewer pixels per hour, useful for scanning multi-day windows and long-arc revisit patterns |
Orbital Events
Four orbital event types overlay onto the timeline. Each renders either as a shaded band (covering an entry-to-exit interval) or as an instantaneous marker (a single-epoch crossing).
| Event | Display | Description |
|---|
| Eclipses | Band | Shadow events. Distinguished into Umbra (full shadow) and Penumbra (partial shadow); each subtype renders as a band spanning entry-to-exit duration |
| South Atlantic Anomaly (SAA) | Band | Geographic region of elevated radiation; band spans entry-to-exit duration |
| Apsis | Marker | Periapsis and apoapsis crossings; rendered as instantaneous vertical markers |
| Nodes | Marker | Ascending and descending node crossings; rendered as instantaneous vertical markers |
Display Popover
Click Display in the topbar’s right-aligned controls (accessibility name Display settings) to open the Orbital events popover. Each toggle controls visibility for one event type on the timeline; flipping a toggle is reflected immediately on the visible bands and markers.
| Toggle | State | Effect |
|---|
| Eclipses | On (default) | Show or hide umbra and penumbra bands |
| Apsis | On (default) | Show or hide periapsis and apoapsis markers |
| Nodes | On (default) | Show or hide ascending and descending node markers |
| SAA | On (default) | Show or hide South Atlantic Anomaly bands |
Schedule Export Dialog
Click Export Schedule in the topbar’s right-aligned controls to open the Export Schedule dialog. The dialog generates a Spacecraft Schedule File (.ssf) listing every selected event over a chosen window. The same dialog is also accessible from the passes timeline at /passes/timeline.
Spacecraft
A single-select dropdown listing every spacecraft in your tenant. The dialog defaults to the spacecraft already selected on the timeline.
Date Range
| Element | Description |
|---|
| Start Date | Calendar picker; selectable range covers 7 days before today through 7 days after today |
| End Date | Calendar picker; cannot be earlier than Start Date and cannot exceed 7 days after Start Date |
| Time inputs | HH:MM format, UTC for both Start and End |
| Maximum window | 7 days |
Include
Five checkboxes determine what the exported .ssf file contains. All five are checked by default. With every checkbox unchecked the Download button is disabled and the dialog displays the validation message Select at least one event type.
| Checkbox | State | What it includes |
|---|
| Eclipses | Checked (default) | Umbra and penumbra entry/exit events |
| Apsis | Checked (default) | Periapsis and apoapsis crossings |
| Nodes | Checked (default) | Ascending and descending node crossings |
| Ground Station Passes | Checked (default) | Visibility windows for selected ground stations |
| South Atlantic Anomaly (SAA) | Checked (default) | SAA entry/exit events |
Ground Stations
The Ground Stations card appears only when Ground Station Passes is checked. Use it to restrict the exported passes to specific ground stations.
- Click the trigger button to open the picker.
- Check the stations to include; leave the selection empty to include all configured stations.
- The trigger label reads All ground stations when no stations are selected, or N selected when one or more are picked.
The card’s helper text reads Select specific ground stations or leave empty to include all.
| Button | Description |
|---|
| Cancel | Close the dialog without exporting |
| Download | Generate and download the .ssf file. While the export is in flight, the button label changes to Exporting… |
Quick Reference
| Category | Action | Location |
|---|
| Filter | Select spacecraft | Topbar dropdown |
| Filter | Set time range | Topbar dropdown |
| View | Group by spacecraft | Topbar popover |
| View | Collapse/expand group | Group header chevron |
| View | Navigate group pages | Group header arrows |
| Select | Click row for details | List row |
| Select | Checkbox for bulk | List row checkbox |
| Select | Select all in group | Group header |
| Select | Select all visible | Bulk toolbar |
| Select | Clear selection | Bulk toolbar |
| Edit | Edit composition | Details menu |
| View | Expand composition | Details menu |
| Export | Single OCM | Details menu |
| Export | Bulk OCM/ZIP | Bulk toolbar |
| Export | All via dialog | Topbar Export button |
| Import | New maneuvers | Import dialog |
| Import | Telemetry data | Import dialog |
| Delete | Single burn | Details menu |
| Delete | Bulk delete | Bulk toolbar |
| View | Open timeline | Burn-plan list nav |
| View | Switch zoom (Wide/Compact) | Timeline topbar tabs |
| View | Toggle event visibility | Display popover |
| Export | Schedule (.ssf) | Timeline Export Schedule button |
Key Concepts
What is a Burn Plan?
A burn plan (maneuver) represents a planned or executed thruster firing to change a spacecraft’s orbit. Key parameters include:
- Delta-V: Velocity change in m/s
- Delta-Mass: Propellant consumed
- Duration: Burn length in seconds
- Reference Frame: Coordinate system (RTN or TNW)
Maneuver Lifecycle
- PLANNED: Maneuver is scheduled but not yet executed
- TELEMETRY: Execution reported with actual timing data
- Performance Analysis: Compare actual vs planned after execution
- Magnitude (Efficiency): Actual delta-V vs planned delta-V (100% = perfect)
- Pointing: Angular deviation from planned direction (0 degrees = perfect)
Related Pages
