> For the complete documentation index, see [llms.txt](https://docs.giraffecctv.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giraffecctv.com/cloud/system-monitoring/energy-metrics/understanding-energy-forecasts.md).

# Understanding energy forecasts

Energy forecasts help you spot declining reserves and plan charging or refuelling. They use recent measurements to estimate how long the system can keep running, shown as **days remaining**. Actual runtime can change with weather, equipment use, mains availability and EFOY operation.

## Read the current state

**Days remaining** estimates how long the energy in the battery and, where available, remaining EFOY fuel would last. The calculation assumes the recent balance between consumption and solar production continues.

| State        | Estimated days remaining                 |
| ------------ | ---------------------------------------- |
| **Critical** | Less than 5 days.                        |
| **Caution**  | 5 to 21 days, inclusive.                 |
| **OK**       | More than 21 days, or **Not depleting**. |

**Not depleting** means solar has matched or exceeded consumption over the calculation period. It describes the recent balance, not a guarantee that the system will never run out of energy. These status bands are separate from the battery percentage colours on **Solar output**.

Forecasts are calculated daily using recent completed days. Check **Last calculated** and **Based on …-day trajectory** below the charts to see the calculation time and history used.

## Follow changes in estimated running time

**Improving**, **Stable** and **Degrading** compare the latest two forecasts. On **Autonomy over time**, solid points represent calculated forecasts; the infinity symbol represents **Not depleting**. When the selected period ends today, a dashed line projects how the estimate would change if the recent pattern continued. It does not show measured values or use weather forecasts.

The chart uses a **0–30 day scale** to make low reserves easier to compare. Estimates above 30 days appear at **30+**; hover over a point to see its date and actual estimate. **∞ — Not depleting** appears in a separate band above the scale, with an explanation on hover. Missing readings leave a gap in the line.

<figure><img src="https://2701567920-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZS3YRsoEs7DBwWBJpaD%2Fuploads%2Fgit-blob-275a03d74b27a3443584594e6cb7482a21d31cfa%2Fenergy-autonomy-recovery.jpg?alt=media" alt="Estimated days remaining falling from Not depleting to 0.5 days, with a dashed projection, daily net-consumption bars and calculation timestamp" width="1169"><figcaption><p>The estimate falls after days when use exceeded supply. The negative bar on 8 October shows supply exceeding use; that day was incomplete at capture.</p></figcaption></figure>

## Why the cards and charts can differ

The cards always show the latest forecast. Date controls filter the **Energy summary** and charts, including historical forecasts. Selecting last month's dates does not turn the cards into last month's estimates.

Chart measurements can also be newer than the daily forecast. A system may start recovering during the day while the cards still reflect the previous energy shortfall. Check the latest battery and production readings alongside the calculation time.

**Net daily consumption** and **Net consumption** use different inputs. The forecast rate averages consumption minus solar production. The selected-period total subtracts solar, EFOY and mains energy from consumption. Different values, including different signs, are possible.

## Use forecasts with error states

Configured energy thresholds can raise [error states](/cloud/system-monitoring/error-states.md), for example when estimated days remaining or estimated days until EFOY fuel runs out fall below a set limit. The **Critical** forecast badge alone does not mean an alert has been configured or sent.

Check the system's **Errors** tab and your [notification preferences](/cloud/notification-system/manage-notification-preferences.md). Notification delivery also depends on the system's notification settings. Ask Giraffe Support to confirm the energy thresholds configured for your system.

For charging estimates, fuel estimates and all label definitions, see [Energy metrics reference](/cloud/system-monitoring/energy-metrics/energy-metrics-reference.md). To investigate a period, follow [Review a system's energy](/cloud/system-monitoring/energy-metrics/energy-metrics.md).
