Export results and troubleshoot visualizations

Export a result you can still explain later

A useful export needs enough context to remain understandable after it leaves Vega. Before downloading a CSV, make sure the chart has been refreshed and that its period, metric, unit, components, breakdown, and filters describe the analysis you intend to share.

When a visualization is empty or surprising, work back through those same settings and then check source coverage. This guide shows both paths: exporting a known result and finding the reason an expected result is missing or looks wrong.

Create a supported breakdown result with Create charts and tables from a conversation.

Export from Chat

1. Find the assistant message containing the chart or table.
2. Confirm its period, metric, unit, and component scope.
3. Select Export CSV in the message actions.
4. Open the downloaded file and check its headers and first and last rows.

The export action is available for structured breakdown visualizations. If it is absent, ask Vega to recreate the result as a table, then use its Open action to check whether structured rows are available.

Export from the detailed chart window

1. In Chat, locate Vega’s response containing the chart or table.
2. Select Open, identified by the external-link icon in the response actions. Vega opens the detailed chart window with the visualization on the left and controls on the right.
3. Choose Chart or Table at the top of the right-hand control panel.
4. Apply the required settings and select Refresh at the bottom of that panel.
5. Wait until the refresh notice disappears.
6. Select Export CSV using the download button beside Refresh.

See Open and adjust the detailed chart window if the Open action is missing or the chart window controls are unavailable.

The active view affects the CSV layout:

• Chart exports the time key, formatted time, and one column per rendered dataset.
• Table exports the structured breakdown matrix, including its metric and category columns.

The first columns are Time (ISO‑8601) and Time. Use the ISO value for reproducible processing and the formatted value for human review. The filename contains the download timestamp and chart title.

CSV values follow the configured display precision for the measurement kind. Do not use a rounded export when a calculation requires more precision than Vega displays; retrieve the governed source data instead.

Resolve a refresh notice

Changing dates, interval, data type, metrics, components, breakdown, filters, statistics, or overlays makes the displayed data stale. Vega dims it and shows Please refresh the chart or Please refresh the table.

Select Refresh and wait for the result. The refresh reruns the visualization query with its current controls. It does not synchronize a connector. If new source measurements are expected, check the component’s Measurements calendar and synchronization job first.

Use Reset breakdown to restore the parameters from the original visualization and refresh them. Changing only the chart type redraws the existing rows and normally does not require a refresh.

Resolve an empty visualization

If Vega reports No measurements exist for the selected time period:

1. Confirm the active account.
2. Check the From and To dates.
3. Select one known component instead of All sites, all components.
4. Choose one metric that the component actually supplies.
5. Remove filters and set Breakdown to None.
6. Use a known complete interval and select Refresh.
7. Check the component’s Measurements calendar for failed, partial, or outside-window days.

If data exists only after a connector was installed, move the period inside its synchronization window. Do not treat missing days as zero.

Resolve missing controls or table view

An older or static chart can have a visible image but no stored breakdown parameters. In that case:

• Table can be disabled,
• chart-window data controls can be disabled,
• refresh may be unavailable, and
• CSV export may reflect only the available chart structure.

Ask Vega to recreate the result with an explicit metric, component, period, interval, and “show as a table” instruction. This produces a new structured result when the underlying tool supports it.

Resolve unexpected values

Check the following in order:

1. Metric and unit — kW and kWh answer different questions.
2. Component boundary — parent and child selections can overlap.
3. Breakdown — None combines values; Component separates them.
4. Filters — every active filter changes which measurements contribute.
5. Interval — coarse buckets can hide brief behavior.
6. Statistics — a Top N result is not the complete time series.
7. Coverage — incomplete buckets can distort totals and averages.
8. Time zone — local dates and daylight-saving changes affect bucket boundaries.

Use Review measurements, asset health, and events to trace the result to its source. If the CSV and on-screen table disagree, record the chat, chart title, result period, active controls, and downloaded file, then contact support without altering the source data.

Final export checklist

Before sharing a file, confirm that:

• the refreshed result is visible,
• the intended view was active during export,
• the title and filename identify the analysis,
• the date range and time zone are documented,
• units and filters are recorded,
• the first and last rows are complete, and
• totals or extremes have been verified before action.