Dashboard Workflow

After runs are available, use kub-dashboard to index and browse results from the CEMDB tree.

--cemdb-root can be omitted in many cases:

  • If the current directory contains ./cemdb, kub-dataset and kub-simulate use the default cemdb/locations.

  • kub-dashboard auto-detects ./cemdb.

CEMDB_ROOT environment variable:

  • kub-dashboard uses CEMDB_ROOT as its default CEMDB path.

  • For kub-dataset and kub-simulate, use --cemdb-root when your data is not under ./cemdb/locations.

1. 1. Build or Refresh Index

kub-dashboard index --cemdb-root cemdb --refresh

For debugging output:

kub-dashboard print-index --cemdb-root cemdb

2. 2. Start Dashboard UI

kub-dashboard serve --cemdb-root cemdb --host 127.0.0.1 --port 8050

3. 3. Optional API-Only Mode

kub-dashboard api --cemdb-root cemdb --host 127.0.0.1 --port 8050

4. 4. Explore Core Pages

Page What to check

Run Catalog

Run IDs, location names, run type, status

Run Detail

Summary, artifacts, plots, map, samples (ensemble)

Locations

Inventory, weather availability, preprocessing assets

Location Detail

Building distributions, weather analysis, map

If the UI starts but shows no runs, rebuild the index with --refresh and verify manifests exist under simulations/single/run_*/manifest.json.

5. Next Step