Skip to main content
For the complete documentation index, see llms.txt.
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

Public orbit history

Choose Public Orbits in the State Vectors header to browse the public orbits VALAR has collected for your spacecraft. Use the spacecraft and time-range filters, group by spacecraft or show a flat list, and sort by source epoch. The selected record and filters are retained in the page URL. Select a record to inspect its source epoch, originator and available SGP4/SDP4 mean elements. Activity shows provider retrieval times; Load more activity opens older retrievals. The source epoch describes the orbit, while a retrieval time records when VALAR collected it. Stored TLE representation appears only when the record contains both TLE lines. Missing values remain Unknown. History starts with collected records; earlier provider history is not imported. If the list is empty, try another spacecraft or All Time. A failed read offers Retry and is not evidence that no public orbit exists. Public orbital data is shared reference data; viewing it does not replace your saved precise state vectors.

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

Group By

Sort by Epoch

Click the Epoch Newest first button to toggle sort order:

State Vector List

Row Information

Each row displays:

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:

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

Metadata Section

Coordinates Section

Toggle between Keplerian and Cartesian tabs. Keplerian Tab: Cartesian Tab:

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. 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

Format Selection: Spacecraft Selection: Shown only for SpaceX OPM — choose which spacecraft the state vector belongs to. For OPM (CCSDS Standard), VALAR resolves the spacecraft from the file, so no selector appears.

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 the error code and message. See OPM Import Error Modes for the common errors and how to resolve them.

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

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.

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.

Unresolved spacecraft references

When you request state vectors through the VALAR API and name spacecraft by reference — for example by NORAD id, COSPAR id, name, or external key — the response includes an unresolvedSpacecraftReferences field alongside the results. This field is always present. When every reference you supplied resolved, it is an empty array. When one or more references could not be resolved, it lists them — and the results you received cover only the references that did resolve.
A 200 response does not imply a complete result set. If you request data for five spacecraft and one reference is a typo, you receive state vectors for the other four, and the fifth is named in unresolvedSpacecraftReferences. Always check this field rather than assuming the results cover every spacecraft you asked for.
The list follows three rules:
  • Duplicates are collapsed — a reference you supplied more than once appears at most once.
  • Your order is preserved — the references appear in the order you supplied them.
  • There is no positional correspondence between this list and the content array — an entry’s position here does not line up with any row in the results.
For how a single-spacecraft operation reports the same unresolvable reference — a 404 rather than a 200 — see Spacecraft Lookup.