Building Optimization Technologies · BOT — BEDES Dictionary

BOT Data Standard

The canonical vocabulary for building energy data across BOT's platforms — 87 field definitions covering premises, energy, metering, HVAC, controls, efficiency measures, measurement & verification, benchmarking, emissions, and findings.

Alignment basis: 52 of the 55 BEDES-status terms are verified against the LBNL Building Energy Data Exchange Specification (BEDES) V2.5 with a documented correspondence — 14 exact-name matches and 38 mapped to BEDES term/option composites. BOT-EXT terms are BOT extensions for BAS operations and Guideline-14 M&V.

87Terms
55BEDES-status
32BOT extensions
10Categories
v1.1Standard version
TermStatusDefinitionUnitsOptionsBOT field
01 · Premises
Premises NameBEDESCommon name used to identify the building or site.——property_name
Premises IdentifierBEDESUnique ID assigned to the premises; BEDES supports multiple ID types.—Assessor Parcel Number; Portfolio Manager ID; Custom IDproperty_id
Occupancy ClassificationBEDESPrimary use type of the premises.—Office; Education; Retail; Health Care; Laboratory; Warehouseuse_type
Address Line 1BEDESStreet address of the premises.——address_1
CityBEDESCity in which the premises is located.——city
StateBEDESState or province of the premises.—TX; ...state
Postal CodeBEDESZIP or postal code of the premises.——zip
Climate ZoneBEDESASHRAE/IECC climate zone designation.—2A (Houston); 1A–8climate_zone
Gross Floor AreaBEDESTotal floor area measured between exterior wall surfaces, all floors.ft2—gross_sf
Conditioned Floor AreaBEDESFloor area served by heating and/or cooling.ft2—conditioned_sf
Year of ConstructionBEDESCalendar year the building was originally built.yyyy—year_built
Number of Floors Above GradeBEDESCount of stories above ground level.——floors
Number of OccupantsBEDESTypical count of people occupying the premises.——occupants
Weekly Operating HoursBEDESTypical hours per week the premises operates.hrs/wk—op_hours_wk
OwnerBEDESLegal owner of the premises.——owner_entity
02 · Resource / Energy
ResourceBEDESThe type of energy or water resource consumed or produced.—Electricity; Natural Gas; Water; District Chilled Waterresource_type
Site Energy UseBEDESAnnual energy consumed at the site, all fuels, site basis.kBtu/yr—site_energy
Site Energy Use IntensityBEDESSite energy use divided by gross floor area (Site EUI).kBtu/ft2-yr—site_eui
Source Energy Use IntensityBEDESSource (primary) energy per floor area, incl. generation and delivery losses.kBtu/ft2-yr—source_eui
Electricity UseBEDESElectric energy consumed over the reporting interval.kWh—kwh
Peak DemandBEDESMaximum rate of electricity use in the period.kW—kw_peak
Real PowerBOT-EXTInstantaneous active power measured at the meter.kW—kw
Reactive PowerBOT-EXTInstantaneous reactive power measured at the meter.kVAR—kvar
Apparent PowerBOT-EXTInstantaneous apparent power measured at the meter.kVA—kva
Power FactorBOT-EXTRatio of real to apparent power at the meter.0–1—pf
Energy CostBEDESCost of energy consumed in the period.USD—energy_cost
Utility NameBEDESUtility or retail provider serving the account.——utility
Rate Schedule / TariffBEDESUtility tariff under which the account is billed.——tariff_id
4CP Coincident DemandBOT-EXTDemand coincident with ERCOT four summer coincident peaks (TX transmission cost allocation).kW—kw_4cp
03 · Metering
Meter IdentifierBEDESUnique ID of the physical or virtual meter.——meter_id
Meter TypeBEDESResource measured by the meter.—Electricity; Natural Gas; Watermeter_type
Metering ConfigurationBEDESHow the meter is connected relative to the load.—Whole Building; Submeter; Tenantmeter_config
Interval ReadingBEDESConsumption or demand value recorded for one interval.kWh / kW—interval_value
Interval FrequencyBEDESLength of the recording interval.—15-minute; Hourly; Daily; Monthlyinterval_freq
Reading TimestampBOT-EXTUTC timestamp of the interval reading (end-of-interval convention).ISO 8601—ts_utc
Current Transformer RatioBOT-EXTCT ratio applied to the metering circuit (primary:secondary).—800:5; 2000:5ct_ratio
Potential Transformer RatioBOT-EXTPT ratio applied to voltage inputs (e.g., 2.4:1 ITI at Richmond SB3; 2.06:1 secondaries).—2.4:1; 4:1pt_ratio
Meter Accuracy ClassBOT-EXTRated accuracy of the metering chain, incl. CT/PT error stack (drives CMV2.0 baseline uncertainty).%Class 0.5; Class 1accuracy_class
Correction EpochBOT-EXTDated correction record when metering defects are fixed (e.g., R-3S-AHU L2 jumper + CT type) so baselines split cleanly.——correction_epoch
04 · HVAC Systems
HVAC System TypeBEDESClassification of the heating/cooling system serving the premises.—Packaged Rooftop; Self-Contained; Chiller + Cooling Tower; Split DXhvac_type
Cooling System TypeBEDESPrimary cooling plant classification.—DX; Water-Cooled Chiller; Air-Cooled Chillercooling_type
Heating System TypeBEDESPrimary heating classification.—Electric Resistance; Gas Furnace; Heat Pump; Hydronicheating_type
Air Distribution TypeBEDESHow conditioned air is delivered.—VAV; CAV; FPTU; Dedicated OAair_dist_type
Terminal Unit TypeBEDESZone-level device conditioning the space.—VAV Box; Fan-Powered Terminal Unit; Baseboardterminal_type
Cooling TowerBEDESHeat-rejection equipment for water-cooled plants.—Open; Closed-Circuitcooling_tower
EconomizerBEDESPresence/type of air- or water-side economizer.—Air-Side; Water-Side; Noneeconomizer
Motor Controller TypeBEDESMotor speed/starter control on fans and pumps.—VFD; Soft Start; Across-the-Line; E-Clipse Bypassmotor_ctrl
Zone Air TemperatureBOT-EXTMeasured space temperature per zone.F—zone_temp
Zone Temperature SetpointBOT-EXTActive heating/cooling setpoint per zone with schedule window.F—zone_sp
Supply Air TemperatureBOT-EXTAHU discharge air temperature.F—sat
Actuator TypeBOT-EXTDamper/valve actuation method incl. floating (Rtime) types like Honeywell ML6161B.—Floating; Modulating 0–10V; Two-Positionactuator_type
HVAC Service WingBOT-EXTWhich air-handling wing/controller serves a space. A SERVICE attribute, not a location: a space near a wing boundary may be fed from the other wing. Never use it to infer position.textEast|Westhvac_wing
05 · Controls / BAS
Building Automation SystemBEDESWhether the premises has a BAS/EMS, and its identity.—Atenea BASbas_present
Control StrategyBEDESOperating strategy applied by the control system.—Scheduling; Optimal Start; Demand Limiting; Resetcontrol_strategy
Operating ScheduleBEDESTime-of-day/week schedule governing equipment operation.—Multi-window zone schedules w/ auto-mergeschedule_id
Controller Node IDBOT-EXTPi 5 node identity on the Atenea BAS fleet (~55 nodes, Debian Trixie/ARM64).——node_id
Modbus Register MapBOT-EXTSID/register allocation: meters 50–59, VFDs 100–119, AO 10–19, AI 20–29, relay 30–39, DI 40–49; RTU 9600 8E1 /dev/ttySC0.——modbus_map
06 · Measures (ECM)
Measure NameBEDESDescriptive name of the efficiency measure.——ecm_name
Measure CategoryBEDESSystem category the measure addresses.—HVAC; Lighting; Envelope; Controls; Plug Loadsecm_category
Implementation StatusBEDESLifecycle status of the measure.—Proposed; Approved; Implemented; Verifiedecm_status
Measure Installed CostBEDESTotal installed cost of the measure.USD—ecm_cost
Annual Savings Site EnergyBEDESEstimated or verified annual site energy savings.kWh/yr; kBtu/yr—ecm_kwh_savings
Annual Cost SavingsBEDESEstimated or verified annual dollar savings.USD/yr—ecm_usd_savings
Simple PaybackBEDESInstalled cost divided by annual cost savings.yrs—ecm_payback
07 · M&V
Baseline PeriodBEDESPeriod of measured data used to build the pre-implementation model.——baseline_start_end
Reporting PeriodBEDESPost-implementation period over which savings are determined.——report_start_end
Savings Determination MethodBEDESM&V approach used to quantify savings.—IPMVP Option A; B; C; Dmv_method
Weather Normalization MethodBEDESHow weather is adjusted between periods.—Regression (ML); Degree-Day; Nonewx_norm
CV(RMSE)BOT-EXTCoefficient of variation of RMSE of the baseline model (ASHRAE GL14 fitness metric; BOT fleet ~9.9%).%—cvrmse
NMBEBOT-EXTNet mean bias error of the baseline model (ASHRAE GL14).%—nmbe
Savings UncertaintyBOT-EXTStated uncertainty of reported savings incl. metering accuracy stack.%—savings_unc
Anomaly FlagBOT-EXTInterval-level anomaly detection output (LBNL-benchmarked engine; VAE F1 0.6454).—Normal; Anomaly; Reviewedanomaly_flag
08 · Benchmarking
ENERGY STAR ScoreBEDESEPA Portfolio Manager 1–100 percentile score.1–100—estar_score
Benchmark TypeBEDESBasis of the comparison used to rate the premises.—Portfolio Manager; Peer Group (BPD); Code; Prior Yearbenchmark_type
Peer Group DefinitionBOT-EXTBPD API filter set used for the peer comparison (use type, climate zone, size band, vintage).JSON—peer_group_json
Peer Median Site EUIBOT-EXTMedian site EUI returned by BPD for the peer group.kBtu/ft2-yr—peer_eui_p50
09 · Emissions
GHG EmissionsBEDESGreenhouse gas emissions associated with energy use.MtCO2e/yr—ghg
Emissions FactorBEDESConversion factor from energy to emissions for the fuel/grid region (ERCOT).kgCO2e/kWh—ef_ercot
10 · Findings
Finding TypeBOT-EXTCanonical classification of a detected condition, independent of the detecting engine.—Weekend Exception; Holiday Exception; Consensus Anomaly; Equal-Weather Drift; Non-Routine Event; Load-Shape Change; Night Base Load Excess; Peak Demand Excess; Power Factor Deficiency; Schedule Drift; Morning Recovery Overshoot; Meter Silence; Telemetry Staleness; Electric-Heat Signature; Peer Divergence; Manual Observationfinding_type
Finding SourceBOT-EXTEngine or person that produced the detection.—CMV2.0 M&V; BAS FDD; RMS Graph (manual); Bill Utilityfinding_source
Detection RunBOT-EXTIdentifier of the run that produced or re-confirmed the finding.——detection_run
Event DateBOT-EXTDate the condition occurred (not detected). NULL for standing conditions.ISO 8601—event_date
SightingBOT-EXTOne detection of one finding by one source in one run. Multiple sources on one finding are corroboration, not duplication.——sighting
Finding StatusBOT-EXTWorkflow state of a finding, from first detection to closure.—New; Acknowledged; In Progress; Resolved; Verified; Closed; No Actionfinding_status
Still OccurringBOT-EXTWhether the latest run still observes the condition. Derived.—Yes; No; Not machine-detectedstill_occurring
Estimated Monthly Cost ImpactBOT-EXTAvoidable cost attributable to the finding.USD/mo—impact_usd_mo
Estimated Monthly Energy ImpactBOT-EXTEstimated avoidable energy attributable to the finding, per month.kWh/mo—impact_kwh

Versioning

This is version 1.1 of the BOT Data Standard, published September 2026. New terms are added by revision; a canonical field name is never renamed without a documented correction record.

BEDES attribution

BEDES — the Building Energy Data Exchange Specification — is developed by Lawrence Berkeley National Laboratory. BEDES-status terms in this standard were verified against LBNL's published V2.5 machine-readable term and list-option exports. Three terms with no BEDES counterpart and three whose option lists differ from BEDES's are documented in the verification record. This page asserts documented correspondence, not formal BEDES-compliance certification.

Use with care

Definitions describe BOT's canonical vocabulary and are not a guarantee of data availability for any specific building. Referenced specifications and guidelines (BEDES, ASHRAE Guideline 14, IPMVP) remain the property of their respective publishers and are cited, not reproduced.