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 Planner allows you to create and manage orbital maintenance plans for your spacecraft. Using optimization algorithms, the Planner computes a sequence of maneuvers to keep a spacecraft within defined orbital parameters over a given time window.
Route: /maneuvers/planner
Supported Algorithms
| Algorithm | Description | Status |
|---|
| SMA Maintenance | Maintain semi-major axis within a tolerance band | Available |
Page Layout
The Planner page has two main sections: a details panel on the left and a plan list on the right.
The top bar contains:
- Spacecraft Filter — multi-select dropdown to filter plans by spacecraft
- Group By — group plans by Spacecraft, Status, Plan Type, or None
- Time Range — bidirectional time filter (past and future plans)
- New Plan — opens the plan creation wizard
- Toggle Panel — show/hide the plan list
Plan List
The right panel lists all plans matching the current filters. Each row shows the plan ID, status icon, name, spacecraft, plan type icon, and creation date. Hover any element for a tooltip with details.
Plans can be grouped by spacecraft, status, or plan type. Each group header shows the count and supports pagination (5 items per page) and collapse/expand.
Status icons:
| Icon | Status | Description |
|---|
| Magnifier (indigo) | Evaluation | Plan is under review |
| Checkmark (green) | Approved | Plan has been approved for execution |
| Cross (red) | Rejected | Plan has been rejected |
Plan Creation Wizard
Click New Plan to open the plan creation wizard. The wizard guides you through 5 steps. Steps 1–3 and 5 are shared across all algorithm types; Step 4 is algorithm-specific.
Step 1: Overview
Configure the plan metadata and select the optimization algorithm.
| Field | Description | Constraints |
|---|
| Plan Name | User-defined identifier | Required, max 30 characters |
| Description | Optional notes about the plan | Optional |
| Spacecraft | Target spacecraft for the maintenance plan | Required — must have at least one orbit solution |
| Thruster | Propulsion unit for computing burns | Required — must be configured for the selected spacecraft |
| Maneuver Type | Optimization algorithm to use | Select from supported algorithms |
Step 2: Initial State
Displays the spacecraft’s state that will be used as the starting point for the optimization, which defaults to latest computed state vector. Users can select a different state vector if desired using the ID dropdown, or initialize the process with the latest public TLE.
Step 3: Time Range
Define the time window over which the optimizer should plan maneuvers.
Set the Start Date/Time and End Date/Time in UTC. The end must be after the start. By default, the start is 3 hours from now and the duration is 3 days.
Some algorithms may require a single Target Date/Time.
Step 4: Algorithm Parameters
This step varies by algorithm type. See the algorithm-specific documentation:
Step 5: Review
Review the full plan configuration before submission.
The review shows all configured parameters in editable summary cards. Click Create Plan to submit. For complex plans, the computation may run asynchronously — a progress dialog tracks the job until completion. On success, the new plan appears in the plan list.
Plan Details
Select a plan from the list to view its details in the left panel (visible in the page screenshot above).
The header shows the plan name, plan type icon, and a more menu with actions:
| Action | Description |
|---|
| Export | Download the plan as an OCM file |
| Delete | Delete the plan with confirmation |
| Field | Description |
|---|
| Spacecraft | Target spacecraft (with colored icon) |
| Delta-V | Total velocity change across all maneuvers (m/s) |
| Delta-Mass | Total propellant consumed (auto-converts kg/g) |
| Duration | Total burn time |
| Creation Date | When the plan was created (UTC) |
| Execution Date | Planned start time for the first maneuver (UTC) |
| Status | Evaluation, Approved, or Rejected |
Status Actions
Plans in Evaluation status can be approved or rejected using the action buttons in the header:
- Evaluation → Approved (plan is ready for execution)
- Evaluation → Rejected (plan is discarded)
Tabs
Analysis — Algorithm-specific visualization showing how the computed maneuvers maintain the target orbital parameter. See SMA Maintenance Analysis for details.
Burns — Lists each individual maneuver in the plan:
| Field | Description |
|---|
| Epoch | Maneuver start time (UTC) |
| Duration | Burn length |
| Delta-V | Velocity change components and magnitude (m/s) |
| Delta-Mass | Propellant consumed |
Related Pages
