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.
Toolbar
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.
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.
When the Orbit Is Stale
Maneuver optimization needs a fresh orbit to plan from. When the selected spacecraft’s orbit age passes the workspace stale level, the orbit is stale and the plan cannot be created. Submitting the wizard surfaces an Orbit is stale precondition with a panel reading This spacecraft’s orbit is stale, the orbit’s age (last determined N days ago), the stale level it crossed (exceeds your N-day threshold), and the remedy (Update tracking data, or change the threshold in Settings). The Create Plan button stays disabled until the orbit is fresh again.
To clear the block, provide a newer state vector for the spacecraft, or raise the stale level in Settings → Orbits → Orbit age. See Orbit age for the workspace-wide policy and the enforcement switch that governs this block.
Plan Details
Select a plan from the list to view its details in the left panel (visible in the page screenshot above).Header
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 |
Plan Information
| 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
- SMA Maintenance — SMA maintenance algorithm details
- Burn Plan — View and manage individual spacecraft maneuvers
- Orbit age — The stale level and enforcement switch that block planning on a stale orbit
- Core Concepts — Foundational orbital mechanics concepts