Skip to main content
The State Vectors page displays orbit solutions for your spacecraft, including position, velocity, and covariance data. Import state vectors from OPM files, view orbital elements, and export data for external use. Route: /state-vectors/data

Page Layout

The page uses a split-view design with a state vector list on the left and a details panel on the right: State Vectors When state vectors are selected, a floating action bar appears at the bottom.

Filtering

Spacecraft Filter

Filter state vectors by spacecraft. Click to open a multi-select dropdown, check/uncheck spacecraft, and click Apply to confirm. Default: Shows all spacecraft when none selected.

Time Range Filter

OptionDescription
TodayLast 24 hours
Last WeekLast 7 days (default)
Last MonthLast 30 days

Group By

OptionEffect
SpacecraftGroups state vectors by spacecraft with collapsible headers and per-group pagination (default)
NoneFlat list with infinite scroll

Sort by Epoch

Click the ↓ Epoch / ↑ Epoch button to toggle sort order:
StateDescription
↓ Newest FirstMost recent epoch at top (default)
↑ Oldest FirstOldest epoch at top

State Vector List

Row Information

Each row displays:
ElementDescriptionFormat
CheckboxSelection for bulk actionsHover-reveal
IDState vector identifierTruncated (full ID on hover)
aSemi-major axisXXXX.X km
eEccentricity0.XXXX
iInclinationXX.XX°
ΩRAANXX.XX°
ωArg. of periapsisXX.XX°
νTrue anomalyXX.XX°
MassSpacecraft massXXXX kg
Position σPosition uncertainty (3D norm)XX.XX m
SpacecraftSpacecraft nameColored badge
EpochState vector epochMon DD format

Row Selection

  • Click row: Selects state vector for details panel
  • Click checkbox: Adds to bulk selection for bulk actions

Grouped View

When grouped by spacecraft, each group has a collapsible header:
ElementAction
Chevron (▼/▶)Collapse/expand group
Group NameSpacecraft name
CountTotal state vectors in group
◀ / ▶Navigate pages within group

Group Selection

When items are selected within a group:
  • Select All: Select all items in current page of this group
  • Clear: Deselect all items in this group

Details Panel

Click a state vector row to view its details in the right panel. Shows the full state vector ID with a menu button.

More Menu Actions

ActionDescription
Download OPMExport single state vector as OPM file
Delete State VectorDelete this state vector (opens confirmation)

Metadata Section

FieldDescription
SpacecraftName with colored satellite icon
MassIn kilograms (kg)
OriginatorOrganization that created the solution (from imported OPM file, not editable)
Creation DateWhen imported/created (UTC)
EpochState vector reference time (UTC)

Coordinates Section

Toggle between Keplerian and Cartesian tabs. Keplerian Tab:
ElementSymbolUnit
Semi-major axisakm
Eccentricitye
Inclinationideg
RAANΩdeg
Arg. of periapsisωdeg
True anomalyνdeg
Reference Framee.g., GCRF
Cartesian Tab:
ElementUnit
Position X, Y, Zkm
Velocity X, Y, Zkm/s
Reference Framee.g., GCRF

Covariance Section

Only shown if covariance data exists in the state vector. The Position σ column in the list view also only appears for state vectors with covariance data.
FieldUnit
Position X, Y, Z σm (scientific notation)
Velocity X, Y, Z σm/s
Covariance Reference FrameRTN or XYZ
Click View Full Matrix to open a modal with the complete 6×6 covariance matrix.

Importing State Vectors

Click Import in the toolbar to open the import dialog. State Vector Import

Configuration

Spacecraft Selection: Choose which spacecraft the state vector belongs to. Format Selection:
FormatDescription
OPM (CCSDS Standard)Standard CCSDS Orbit Parameter Message format
SpaceX OPMSpaceX-specific OPM format

File Upload

Drag and drop files onto the upload zone, or click to browse. Accepted files: .txt, .opm

Upload Outcomes

  • Success: Toast notification, dialog closes, data refreshes
  • Partial Success: Warning toast with count (e.g., “Imported 1 of 2 orbit solutions”)
  • Error: Red alert with detailed error message

Generating Ephemerides

Click Generate Ephemerides in the toolbar to open the OEM Export wizard. This multi-step wizard creates ephemeris files from your state vectors.

Wizard Steps

StepNameDescription
1State VectorSelect which state vector to use as the initial condition
2Time RangeConfigure propagation start/end times and step size
3Reference FramesSelect output reference frame(s)
4Review & GenerateReview settings and generate the OEM file
For detailed documentation of each step, see Ephemeris Generation.

Exporting State Vectors

Single Export

From the details panel, click Download OPM to download a single state vector as an OPM file.

Bulk Export

Select multiple state vectors using checkboxes, then click Export as OPM in the floating toolbar.
SelectionOutput
Single state vectorDownloads single .opm file
Multiple (same spacecraft)Downloads single .opm file
Multiple spacecraftDownloads .zip with separate OPM files

Deleting State Vectors

Single Delete

From the details panel, click Delete State Vector. Confirmation dialog: Delete State Vector

Bulk Delete

Select multiple state vectors, then click Delete in the floating toolbar. Outcomes:
  • Full success: “Successfully deleted X orbit solution(s)”
  • Partial success: “Partially successful: X deleted, Y failed”
  • Full failure: “Failed to delete any orbit solutions”

Bulk Actions Toolbar

Appears when one or more state vectors are selected via checkboxes.
ButtonAction
X selectedShows selection count
Select AllSelects all visible state vectors
Export as OPMExports selected as OPM file(s) or ZIP
DeleteOpens bulk delete confirmation
ClearDeselects all rows