Overview
The left panel of the Apollo Viewer has two tabs: Scenarios and Objects. Clicking the tab that is already active collapses the left panel rather than re-selecting it; clicking it again re-opens the panel.
Scenarios Tab
The Scenarios tab lets you browse and load scenario data files.
Loading a Scenario
| Action | Result |
|---|---|
| Left-click a scenario row | Full load of that scenario's data |
| Click the ≡ button on a row | Load summary only (lightweight; no full data load) |
| Right-click a scenario row | Opens a context menu |
Context Menu Items
Right-clicking a scenario row shows a context menu with the following items, in order:
| # | Item | Notes |
|---|---|---|
| 1 | Load Site Data | |
| 2 | Load Unit Data | |
| 3 | Load Summary | |
| 4 | Load Historical DB Report | Shown only when the scenario has a HistDB file |
Searching
The search box performs a case-insensitive substring search. It matches against both scenario names and folder names.
Toolbar Controls
The Scenarios tab toolbar provides: Expand All · Collapse All · Refresh · Search input
Scenario Badges
Each scenario row displays exactly one badge. Badge precedence: HIST takes priority over BCAH, which takes priority over SIMU.
| Badge | Colour | Condition |
|---|---|---|
| HIST | Amber | HistDBErr.csv is present in the scenario folder |
| BCAH | Teal | Scenario is a backcast (apollo-params.json has backcast: true) |
| SIMU | Blue | All other scenarios |
The badge colours above (amber, teal, blue) are the scenario badge colours only. Purple is the swatch colour used for folder nodes — it is not a badge colour. There is no green badge.
Folder Nodes vs Scenario Nodes
Each row in the Scenarios tree includes a small 8×8 px coloured swatch:
| Row type | Swatch colour |
|---|---|
| Scenario row | Teal |
| Folder row | Purple |
Border Rail
Each scenario row also has a coloured left-border rail that indicates the scenario type at a glance:
| Type | Rail colour | Rail width |
|---|---|---|
| HIST | Amber | 6 px |
| BCAH | Teal | 4 px |
| SIMU | Blue | 4 px |
Objects Tab
The Objects tab lets you browse the data object hierarchy for the currently loaded scenario.
The Objects tab is disabled until a scenario is fully loaded via the Scenarios tab. The tab becomes active once a scenario has completed its full data load.
Object Hierarchy Branches
The Object Tree always renders up to five top-level branches in this exact order:
| # | Branch | Visible when |
|---|---|---|
| 1 | Pool | Hierarchy has a pool |
| 2 | Links | Has child links |
| 3 | Groups | Has child groups |
| 4 | Portfolios | Has child portfolios |
| 5 | Storages | Has child storages |
Default expand state: Pool and Links start expanded; Groups, Portfolios, and Storages start collapsed.
Interactions
| Action | Result |
|---|---|
| Click a node | Select node (loads the default view for that object type) |
| Double-click a node | Toggle expand / collapse |
| Click caret (▶/▼) button | Toggle expand / collapse |
| Search input | Debounced substring filter (300 ms delay) |
| Expand All | Expand all nodes |
| Collapse All | Collapse all nodes |
| Filter button | Open the filter popover |
| Reset Filters | Clear all active filters |
Filtering
The filter popover provides three filter categories:
| Category | Options |
|---|---|
| Object type | Zone (shown only for zonal hierarchies), Region, Site, Unit |
| Fuel type | Dynamically populated from the scenario's hierarchy metadata |
| Unit property | Supply Units, VRE Units |
Filter state is persisted via localStorage and survives panel close and reopen.