BEDES V2.2 - Marked Changes - Introduction Introduction BEDES, the Building Energy Data Exchange Specification, has been created by Lawrence Berkeley National Laboratory (LBNL), with the help of the many stakeholders of the BEDES Working Group, and funded by the U.S. Department of Energy (DOE), to help standardize and facilitate the exchange of information on building characteristics and energy use. It is intended to be used in tools and activities that help stakeholders make energy efficiency investment decisions, track building performance, and implement energy efficiency policies and programs. This spreadsheet represents the BEDES Dictionary Version 2.2 which will be used to support the analysis of the performance of buildings by providing a common set of terms and definitions for building characteristics, efficiency measures, and energy use. The terms and definitions in this BEDES Dictionary were taken from a variety of sources in order to be as complete as possible as well as being inclusive of the existing implementations that characterize the energy use in buildings. In order for the standardized terms and definitions of the BEDES Dictionary to be incorporated into different implementations, schemas and import/export formats will need to be developed for specific use cases by the appropriate stakeholders. This will allow compliance with BEDES, as described on the BEDES technical website (bedes.lbl.gov). After the release of version 2.0 in 2016, LBNL and DOE continued to work with numerous adopters of BEDES. Version 2.2 is based on feedback from this process, as well as from stakeholders in general. We have also updated the online interactive website that contains the BEDES Dictionary in a searchable format. The BEDES Community is a diverse group of stakeholders, including software developers, government entities (such as cities and states), energy consultants, and energy providers (such as utilities). A strong BEDES Community will be crucial to the success of BEDES for standardizing data exchange, both from a technical and implementation standpoint. We encourage all stakeholders to participate in the BEDES process, and to provide feedback to LBNL as BEDES continues to evolve. We also encourage all stakeholders to become members of the BEDES Working Group. You can request to become a member, or send general feedback about BEDES, by emailing [email protected]. Useful Links: BEDES main website http://energy.gov/eere/buildings/building-energy-data-exchange-specification-bedes BEDES technical website http://bedes.lbl.gov/ 1 - BEDES V2.2 - Marked Changes - Guidelines General Guidelines Composing Terms Global Terms Constrained Lists According to your particular use case or software data model, BEDES terms can map Global terms can be used in many different contexts, and For terms whose value is a choice from a list, the Data Type is directly to single fields or can be combined to form composite terms using a variety of combined with other terms in BEDES to create a field in a specific List Definition qualifiers. Below are some examples of the different ways in which BEDES terms can implementation of BEDES. Other The term applies but none of the Examplebe used to match field names in your data model. constrained list options are appropriate. Note that a full list of Global Terms can be found on the "Global Unknown The term applies, there is such a thing Terms as Separate Fields related in data records Terms" worksheet. implemented, but which constrained list option is implemented is unknown. Interval Frequency Resource Boundary Resource Resource Value Unit of Measure None The term applies but there is no such thing Annual Site Energy 254 kBtu implemented. Month Source Electricity 24 kWh Not applicable The term does not apply. Hour Site Potable water 4 gallons Custom The term applies, there is such a thing implemented, but none of the constrained Composite Terms list options are appropriate, so a custom Annual Site Energy Resource Value = 254 kBtu option is designated. Month Source Electricity Resource Value = 24 kWh Note: Hour Site Potable Water Resource Value = 4 gallons "Custom" is an optional addition to any constrained list as needed, and must then include another accompanying field Individual Terms Listed as BEDES Mapping that is free text (or part of the implementation's own enumeration) to characterize the custom field. Interval Frequency = "Annual", Resource Boundary = "Site", Resource = "Energy", Resource Value = [value], Unit of Measure = "kBtu" An example might be a custom verification program, where "Custom" is added to the existing constrained List for Interval Frequency = "Month", Resource Boundary = "Source", Resource = "Electricity", Resource Value = [value], "Verification", and then a second field called "Custom Unit of Measure = "kWh" Verification " Interval Frequency = "Hour", Resource Boundary = "Site", Resource = "Potable water", Resource Value = [value], Unit of Measure = "gallons" 2 - BEDES V2.2 - Marked Changes - Sample Mapping Sample Mapping Adoptors who wish to map to BEDES should follow this mapping template. Below is an example of an adoption mapping. The table should be read left to right for each implementation field. See the BEDES Mapping Procedure document under bedes.lbl.gov/technical-documentation for more information on mapping. ExampleImplementation Implementation Implementation BEDES Table Name Implementation Field Value Units BEDES Term BEDES Mapping Unit Floor Area Qualifier = "Gross" Gross Floor Area (ft2) [value] ft2 Gross Area Area = [value] ft2 Hopital Occupancy Classification = "Inpatient hospital" Office Occupancy Classification = "Office" Building Type School n/a Occupancy Classification Occupancy Classification = "Education" Supermarket Occupancy Classification = "Grocery store" Restaurant Occupancy Classification = "Food Service" Building Info Occupant Quantity Type = "Workers on main shift" Number of Employees [value] people Workers On Main Shift Quantity Quantity = [value] people Location ="Above grade" Number of Floors Above Grade [value] floors Above Grade Floors Quantity Spatial Unit Type = "Floors" Quantity = [value] floors Contact Label = "Owner" Owner [value] n/a Owner Full Name Full Name = [value] n/a Interval Frequency = "Annual" Resource Boundary = "Site" Site EUI (MJ/ft2) [value] MJ/ft2 Annual Site Energy Resource Intensity Resource = "Energy" Resource Intensity = [value] kBtu/ft2 Energy Use Interval Frequency = "Annual" Resource Generation = "Renewable" Annual Electricity (renewable) [value] kWh Annual Renewable Electricty Resource Value Resource = "Electricity" Resource Value = [value] kWh 3 - BEDES V2.2 - Marked Changes - Global Terms Term Definition Data Type Unit of Measure Definition Source Conditioning Status A description of the state of "conditioning" of a premises or space, where Constrained List n/a LBNL Premisesconditioning are is mechanically primarily concerned heated. with heating, cooling and ventilation. Heated n/a LBNL Premises are not mechanically heated. Unheated n/a LBNL Premises are mechanically cooled. Cooled n/a LBNL Premises are not mechanically cooled. Uncooled n/a LBNL Premises are conditioned if mechanically cooled, heated, ventilated, and/or Conditioned n/a LBNL Premisescontrolled arefor humidity.partially conditioned by mechanical heating, cooling, ventilation, or Semi conditioned n/a LBNL Premiseshumidity control. are not conditioned by any mechanical cooling, heating, ventilation, Unconditioned n/a LBNL Premisesand/or humidity are ventilated control. mechanically. Ventilated n/a LBNL Premises are not ventilated by any means Unventilated n/a LBNL Building Energy Code Or Standard The name of an energy efficiency code or standard that is applied to building Constrained List n/a LBNL Americanconstruction Society requirements. of Heating, Refrigeration and Air Conditioning Engineers. ASHRAE The "International Energy Conservation Code IECC" published by the International IECC n/a LBNL TheCode "Building Council. Energy This is Efficientused by Standardsmany jurisdictions for Residential in the United and Nonresidential States for building California Title 24 n/a LBNL TheBuildings", "Standard part for of the CaliforniaDesign of TitleHigh-Performance 24, Part 6. This Green standard Buildings, is used Except in California Low- 189.1 n/a LBNL TheRise "International Residential Buildings" Green Construct published Code by the (IgCC)" American published Society by ofthe Heating, International IgCC n/a LBNL Building Energy Code Or Standard TheCode version Council number, (ICC), whichsuch asapplies "90.1" to for new ASHRAE and existing Standard. building. String n/a BuildingVersion Energy Code Year Year for the Energy Code or Standard used with the Energy Code term. As the Year Format from Metadata n/a LBNL Energy Software Tool Aenergy software codes program and standards that is used are inupdated, some fashion dates areto calculate assigned the for energy version control. String n/a LBNL Energy Software Tool Version Theconsumption release version of a building of the software tool used to calculate energy performance of a String n/a Sector Classification Thebuilding. sector classification appropriate for the premises. Also, the sector-appropriate Constrained List n/a LBNL Residentialsizing for equipment. designs are meant to accommodate the needs of people residing on Residential n/a LBNL Commercialthe premises. designs are meant to accommodate the making of a profit, either Commercial n/a LBNL Industrialdirectly or designsindirectly, are