Get your data · Data quality

What good data looks like

The checks Energy Agent runs before any rule, in plain words, and the minimum lengths each analysis needs. You do not fix these; they are flagged.

The gate runs first

Before a single rule runs, Energy Agent checks the supplied data and decides which analyses it can support. Anything that fails is reported, not silently worked around. A rule that cannot be trusted on your data is not run.

  • Timezone: is the file in local time, and does it line up with weather and the schedule?
  • Coverage: how long is the record? Under 60 days is flagged; 365 days is the target.
  • Cadence: are the intervals consistent, or does the file switch between 15-minute and hourly?
  • Gaps: any missing stretch longer than one and a half intervals; more than a day missing in total is flagged.
  • Duplicates: repeated timestamps from a double export or a daylight-saving fold.
  • Negative or blank values, and runs of zeros longer than six hours (meter offline).
  • Flatlines longer than a day (stuck sensor or frozen history).
  • Scale: a channel whose magnitude changes by a decimal place mid-file (unit mix-up).
  • Alignment: submeters, weather and schedule sharing the same period as the main meter.
  • Plausibility: outdoor temperature within a sane range for the location.

How much data each analysis needs

Rules of thumb from the product’s own gate. Send what you have; the gate says what is missing.

  • Whole-building meter rules: 7 to 30 days each; 60 days for confidence.
  • Occupancy inference: hourly-or-finer data.
  • Weather-normalised baseline (TOWT, Guideline 14 grade): 21 days with weather.
  • Change-point detection: 42 days.
  • Verified savings around a change (IPMVP Option C): 60 baseline days plus 14 after.
  • Baseload drift and 12-month forecast: 6 months.
  • Year-over-year comparison: two full calendar years.
  • Equipment rules from BAS trends: 7 to 30 days at 5- to 15-minute intervals.

What you do not need to do

Do not clean, resample, fill gaps or convert units before sending. Do not merge files by hand. Do not remove weekends or holidays. Every one of those steps destroys evidence the rules use. Send the raw export and the gate does the rest.

Common questions

Our data has a two-week gap when the meter was replaced.

Send it. The gap is flagged and the rules run on the periods either side.

The BAS export is at one-minute resolution and huge.

Send it as is or ask the export tool for 5- or 15-minute rollups. Either is read.

Written by Pelorus Engineering · Brent Waluzak, P.E. (FL)Last updated

Menu names differ by software version. Your integrator’s documentation is authoritative. Pelorus Engineering is not affiliated with the vendors named.

See these rules run on your building.

Send twelve months of interval data and a BAS trend export. Energy Agent returns a ranked list of what is wasting money, what each item is worth per year at your tariff, and what to do about it.