Panels¶
Panels turn workspace data into plots, tables, logs, state timelines, focused readouts, and controls. Add them from the timeline toolbar, populate them from the Explorer, and arrange them into reusable layouts.
Panel types¶
| Type | Best for |
|---|---|
| Plot | Signals over time, including measurements and cursor values |
| Log | Structured zelos.log.* events |
| Raw | Raw event records in time order |
| Table | Dense, cursor-aware signal values |
| Value | Large latest or cursor-time readouts |
| State | Discrete state changes as labeled spans |
| Action | Running agent actions and viewing their results |
Action panels are available only in live workspaces. Older layouts can also contain Gauge panels. They are kept in the layout but show the placeholder Gauge panels are not supported in this view. You cannot add new ones.
Add and arrange panels¶
Click Add panel in the timeline toolbar and choose a panel type: Plot Panel, Log Panel, Raw Panel, Table Panel, Value Panel, State Panel, or Action Panel.
You can also create panels directly from the Explorer:
- Double-clicking a field creates a Plot at the bottom of the current layout.
- Dropping a field, or a multi-selection, into empty layout space, between rows, or on a panel's top or bottom insertion band creates one Plot.
- Dropping a folder (a whole event, a source, or an agent) opens a Log panel for its
zelos.log.*events and a Plot for most other signals. - Raw, Table, Value, and State panels are never created by a drop. Add one from Add panel, then drop data onto it.
- Dropping signals in the center of an existing panel adds them to that panel. A Log panel takes only
zelos.log.*events; the rest of the drag stays where it was. Action panels reject signal drops.
Finding a panel you just created
If a new panel lands below the visible part of the current layout, Zelos scrolls it into view and briefly outlines it. If the creation targets a layout tab that is not currently visible, the reveal runs when you open that tab.
Drag a panel header to reorder it or move it to another tab. Resize the panel from its lower-right handle; while you drag, the panel outline and resize grip highlight so it is clear which panel is changing.
Panel header¶
Each panel header provides:
- A drag handle and title
- A Measurement Tool ruler on Plot panels, active while the timeline is paused
- A Download button for export, shown once the panel has data bound to it (never on Action panels)
- An Edit pencil that opens Edit Panel
- A More Options menu containing Remove
Right-click anywhere on the header for the same Remove item. Descriptions configured in Edit Panel appear from the information icon beside the title.
Edit Panel¶
Click the pencil in a panel header to open Edit Panel. The editor has two tabs:
- Config contains the title, description, and controls specific to that panel type.
- Data manages the signals or action bound to the panel.
Data tab¶
Each signal row represents one logical signal definition and includes:
- A base color
- The signal path, which you can click to edit
- Type, unit, enum, dictionary, availability, and base-format metadata when known
- A compact Any or N sources coverage pill
- A row menu for removal and, on Plot, Table, Value, and State panels, the base display format
The Add signal form stays pinned to the bottom of the Data tab while the configured rows scroll.
Source coverage¶
Coverage controls where a signal definition may resolve:
- Any is portable: it matches the signal wherever it is available.
- N sources limits the definition to the selected agents or trace producers.
Open the inline coverage pill to select connected sources or enter a source that is currently offline. Changes are staged until you click Done.
Base and resolved appearance¶
The Data row stores the definition's base color and, for supported panel kinds, its base display format. A portable definition can resolve into multiple source-specific chips. Color and format changes made from a resolved chip target that resolved source rather than changing the base definition.
Reset color appears in a chip's right-click menu only when that exact resolved chip has an authored scoped color override; inherited and automatically assigned colors do not show it.
Display format and copy actions¶
Choose how each signal's value is displayed, per panel, without changing the data. The same signal can use different formats in different panels.
The formats are Default, Hex, Binary, Octal, and Scientific. Hex, Binary, Octal, and Scientific apply to numeric signals only; the menu disables a format the signal's data type cannot use. A floating-point value shown in Hex, Binary, or Octal shows its IEEE-754 bit pattern unless it is a whole number.
State labels from your system stay in place:
- A numeric signal with a value table (for example, enumerated gear or mode values) shows the label with the formatted number beside it, such as
DRIVE (0x3). - A dictionary-encoded signal shows its label only, so it offers Default alone.
Set a format in either of these places:
- Edit Panel → Data: the row menu sets the base format on Plot, Table, Value, and State panels.
- The right-click menu on a signal chip (Plot, Value, and State), a Table row, or a Raw value cell: Display format sets the format for that resolved source.
Log and Action panels do not offer per-signal value formatting.
The same right-click menus carry the copy actions, in this order:
- Display format: the format submenu.
- Copy value: copies exactly the text shown, unit and label included. It appears only when a value is visible.
- Copy path: copies the signal's full path.
Grid panels add rows around these. Raw adds Set cursor here first, then Copy row as JSON and Remove signal after. Table adds Remove signal.
Signal chips¶
Resolved chips provide quick signal controls:
- Drag a chip to another compatible panel or tab.
- Click a Plot chip to show or hide its series.
- Click its color swatch to set a source-specific color where the panel supports colored series.
- Right-click for display format and copy actions.
- Use the X button to remove the signal.
Scope and segment labels appear when needed to distinguish matching sources or overlapping data.
Export panel data¶
Click the Download button in the panel header, then choose:
- Export as CSV
- Export as JSON
- Export as TXT for Log panels
Exports include the panel's configured signals. While the timeline is paused, the export covers the visible time range. Otherwise it covers the live window in a live workspace, or the whole trace in a trace workspace. A trace workspace shown in relative time always exports the whole trace. CSV is convenient for spreadsheets and data frames; JSON also preserves panel and range metadata. Action panels do not use the panel-data export menu.