Skip to main content
Import measurement and ephemeris files into VALAR using the Import dialog. Supported formats include TDM, OEM, and SP3. Route: /orbits/measurements/data

Import Dialog

On the measurements page, click the Import button in the top-right corner of the toolbar: Import Measurements The import dialog has three sections:

1. Configuration

Spacecraft Selection
  • Select which spacecraft the measurements belong to
  • If you had a spacecraft selected on the page, it will be pre-selected
Format Selection
FormatDescriptionFile Extensions
TDMCCSDS Tracking Data Message.tdm, .txt
OEMCCSDS Orbit Ephemeris Messages.oem, .txt
SP3Precise Ephemeris.sp3, .txt
Files must conform to CCSDS standards. See the TDM, OEM, and SP3 format specifications for details.

2. File Upload

A drag-and-drop zone where you can:
  • Drag and drop files directly onto the zone
  • Click to browse and select files from your file system
  • Upload multiple files at once
The file picker automatically filters by the selected format’s extensions. Upload Behavior:
  • All selected files are uploaded in a single batch request
  • Files are processed concurrently on the server
  • Each file receives individual success/failure status
  • No explicit file size limit is enforced by the frontend

3. File Queue

After adding files, they appear in a list showing:
  • File name
  • Status icon (idle, uploading, success, or error)
  • Progress bar during upload
  • Remove button to remove files before upload

Validation

Frontend Validation

Before upload, the system checks:
  • File extension: Must match the selected format
  • Queue not empty: At least one file must be selected
  • Upload state: Cannot upload while another upload is in progress

Backend Validation

When you click Import, files are validated on the server:
  • CCSDS format validation: Files must conform to CCSDS standard formats
  • Data structure validation: Required fields and proper data types
  • Timestamp validation: Valid ISO-8601 date formats
  • Spacecraft association: Data must be associable with a valid spacecraft

Upload Outcomes

Full Success

  • Toast notification: “Successfully imported X tracking files”
  • Dialog auto-closes after 500ms
  • Data automatically refreshes

Partial Success

  • Toast warning: “X of Y files imported successfully. Z failed.”
  • Dialog stays open showing failed files
  • Alert displays failed files with error codes and messages
  • Successfully imported files are removed from queue
  • Data refreshes for the successful imports

Full Failure

  • Toast error with first file’s error details
  • Dialog stays open
  • Alert displays all failed files with error codes and messages

Network/Server Error

  • All files marked as failed
  • Error message displayed in toast and dialog

Error Display

Failed files show detailed error information: Import Measurement Error Common error codes:
  • PARSE_ERROR: File could not be parsed (syntax error)
  • INVALID_FORMAT: Missing required fields or invalid structure

After Upload

After successful upload:
  1. The dialog closes automatically
  2. The measurements data table and plot refresh
  3. New measurements appear with their source file name preserved
  4. You can filter by the uploaded file using the More Filters option

Next Steps

After uploading measurements, you can: