Skip to main content

Onboard File Storage

This page helps you understand where onboard files are shown in the UI and what the different views mean.

If you are new, think of this page as a file explorer for files that exist onboard the satellite.

What You See On This Page​

You will see two tabs:

  • Merged view: one combined tree that merges results from all files.list runs.
  • Per execution view: separate trees, one for each files.list run.

Simple explanation:

  • Merged view answers: "What files do we think are onboard overall?"
  • Per execution view answers: "What exactly did this specific run report?"

Why There Are Two Views​

Each time an execution runs the files.list task, it will get a snapshot of files at that moment.

Over time, files can be added, moved, or deleted. That means older snapshots may not match the newest one.

The UI gives you both views so you can:

  • get a quick high-level picture (Merged view)
  • inspect exact historical results (Per execution view)

How The Merged View Is Built​

The system takes every files.list result and combines them into one tree.

warning

This merged tree is useful, but it is not always perfect "ground truth" for every entry.

The latest execution is treated as the strongest signal for what is currently onboard.

Color Meaning​

Inside Merged view, names use colors to show confidence:

  • Green file/folder name: This item exists in the latest files.list result. You can treat this as "confirmed now" with high confidence.
  • Light gray file/folder name: This item appeared in older results, but was not seen in the latest one. It might still exist, or it might have been removed/changed.

Quick rule of thumb:

  • Green = confirmed by latest snapshot
  • Gray = historical, needs confirmation

How To Use This In Practice​

  1. Start in Merged view for a fast overview.
  2. Trust green entries first when you need current state.
  3. Treat gray entries as "maybe" until confirmed.
  4. Open Per execution view to investigate differences between runs.
  5. If unsure, run a new files.list to refresh the latest snapshot.

Examples​

No files.list executions available yet: No executions

Single files.list execution in Merged view: Single execution

Multiple files.list executions in Merged view: Multiple executions

Single files.list execution in Per execution view: Single execution

Common Beginner Confusion​

  • "I see a gray file. Is it onboard right now?" Not necessarily. Gray means it was seen before, but not confirmed in the latest run.
  • "Why is a file in old execution but not in new one?" The file may have been deleted, moved, renamed, or inaccessible during the latest run.
  • "What should I do when I need certainty?" Run a fresh files.list and check whether the entry appears in green.