diff --git a/docs/notebooks/README.md b/docs/notebooks/README.md index 9a5e7b12..2075c889 100644 --- a/docs/notebooks/README.md +++ b/docs/notebooks/README.md @@ -1,4 +1,4 @@ -Here you can find Jupyter Notebooks which serve as guides for using BuildingSync. Currently there is only one notebook for a small office building with a Level 1 energy audit. +Here you can find Jupyter Notebooks which serve as guides for using BuildingSync. Currently there are several notebooks for prototype small office and primary school buildings with ASHRAE Level 1 and 2 energy audit. # Setup @@ -6,4 +6,4 @@ Here you can find Jupyter Notebooks which serve as guides for using BuildingSync - `poetry install` - `poetry run jupyter lab` -Navigate to the `bsync_examples/Small-Office-Level-1.md`, right click on the file and select `Open With -> Jupytext Notebook`, then walk through the example. +Navigate to the notebook examples (e.g. `bsync_examples/Small-Office-Level-1.md`), right click on the file and select `Open With -> Jupytext Notebook`, then walk through the example. diff --git a/docs/notebooks/bsync_examples/Small-Office-Level-1.md b/docs/notebooks/bsync_examples/Small-Office-Level-1.md index 05fad67b..b8b65365 100644 --- a/docs/notebooks/bsync_examples/Small-Office-Level-1.md +++ b/docs/notebooks/bsync_examples/Small-Office-Level-1.md @@ -16,7 +16,7 @@ By the end of this notebook, you should: - Create a minimum viable Level 1 BuildingSync document and verify it validates using the [BuildingSync Use Case Validator](https://buildingsync.net/validator) ## For Reference: Core Concepts and Notation Used -- We will be using BuildingSync version 2.3.0. [Documentation](https://buildingsync.net/documentation/2.3.0). [Github release](https://github.com/BuildingSync/schema/releases/tag/v2.3.0). +- We will be using BuildingSync version 2.4.0. [Documentation](https://buildingsync.net/documentation/2.4.0). [Github release](https://github.com/BuildingSync/schema/releases/tag/v2.4.0). - BuildingSync is an XML Schema Document (XSD). It defines intended structure. Referring to something as a BuildingSync document typically means the document is intended to conform to the BuildingSync schema. - An XSD defines a hierarchical or tree-based schema, where elements are 'nested' within other elements. An XML document then looks like nested elements within one another. Similar to HTML, it uses angle brackets `<` and `>` to open and close an element tag. The example below provides a very simple example of an XML document: ```xml @@ -1452,7 +1452,7 @@ Use the line below to write the file to disk ```python -bsync_dump(root) +bsync_dump(root, file='example-smalloffice-level1.xml') ``` diff --git a/docs/notebooks/bsync_examples/Small-Office-Level-2.md b/docs/notebooks/bsync_examples/Small-Office-Level-2.md new file mode 100644 index 00000000..fe4cb708 --- /dev/null +++ b/docs/notebooks/bsync_examples/Small-Office-Level-2.md @@ -0,0 +1,2226 @@ +# Energy Auditing with BuildingSync + +Follow the instructions in the [README.md](../README.md) file to run in Jupyter Lab/Notebook. + +## Introduction +So you've been tasked with performing an energy audit that requires submission of a BuildingSync document? What does that even mean? This notebook is intended to provide an interactive and informational introduction to what BuildingSync is and how it relates to buildings, building systems, and energy audit reporting. This will be done by performing an example energy audit on the DOE Small Office Prototype building. + +## Who This is For +While this notebook is setup in Python, this introduction is not reserved only for software developers. The code is more of a supplement, but doesn't need to be run. Energy auditors, mechanical engineers, AHJ's procuring audits, and software developers all have something to gain from walking through this notebook. + +## Learning Objectives +By the end of this notebook, you should: +- Have a practical understanding of some XML features, namely: elements, attributes, and xpaths +- Know the main elements of the BuildingSync schema: Buildings, Systems, Reports, Scenarios, TimeSeriesData, Measures +- Be able to relate these concepts back to an ASHRAE Standard 211 energy audit, and have an understanding of the additional detail needed in a Level 2 audit (compared to a Level 1 audit) +- Create a minimum viable Level 2 BuildingSync document and verify it validates using the [BuildingSync Use Case Validator](https://buildingsync.net/validator) + +## For Reference: Core Concepts and Notation Used +- We will be using BuildingSync version 2.4.0. [Documentation](https://buildingsync.net/documentation/2.4.0). [Github release](https://github.com/BuildingSync/schema/releases/tag/v2.4.0). +- BuildingSync is an XML Schema Document (XSD). It defines intended structure. Referring to something as a BuildingSync document typically means the document is intended to conform to the BuildingSync schema. +- An XSD defines a hierarchical or tree-based schema, where elements are 'nested' within other elements. An XML document then looks like nested elements within one another. Similar to HTML, it uses angle brackets `<` and `>` to open and close an element tag. The example below provides a very simple example of an XML document: +```xml + + This child element captures information in a string (text), whereas the second-child captures a numeric datatype. + 2 + +``` +- `auc:` is often used as the namespace prefix for elements in a BuildingSync document. If a document declares the BuildingSync namespace prefix to be `auc:`, an element would look like `auc:Facility`. The same element in a BuildingSync document without a namespace prefix would look like `Facility`. Going forward, we will not prefix elements with `auc` - the remaining XML content should only refer to things defined by the BuildingSync schema. +- XPath: xpath is basically a syntax for 'walking' an xml tree, mainly used for 'querying' information out of an XML document. In the simple example xml document above, to get the `` element, we would notate this in XPath as `/a-root-node/first-child`. XPath will be used throughout this document to concisely convey where elements can be found in a BuildingSync document. +- We use OpenStudio model to represent the prototype building. By performing simulation on the OS model, we obtain devices sizing properties, energy usage and bills, as well as measure analysis, etc.. +- Referenced prototype building info from [DOE Prototype Building Models](https://www.energycodes.gov/prototype-building-models). + +## Caveats +- These cells are meant to be run 1x through sequentially. Running a single cell multiple times may give you bad results + + +```python +# Import the main bsync module +from bsyncpy import bsync +from lxml import etree +from datetime import datetime, date +import eeweather + +def pretty_print(element): + """Simple printing of an xml element from the bsync library""" + print(etree.tostring(element.toxml(), pretty_print=True).decode('utf-8')) + +def bsync_dump(root_element, file='example1.xml'): + """Write the element to the specified file""" + doctype = '' + as_etree = root_element.toxml() + as_etree.set('xmlns', 'http://buildingsync.net/schemas/bedes-auc/2019') + #as_etree.set('xmlns:xsi', 'http://www.w3.org/2001/XMLSchema-instance') + #as_etree.set('xsi:schemaLocation', 'http://buildingsync.net/schemas/bedes-auc/2019 https://raw.githubusercontent.com/BuildingSync/schema/v2.4.0/BuildingSync.xsd') + # Have to manually set the version right now. Align release of bsyncpy to this version. + as_etree.set('version', '2.4.0') + output = etree.tostring(as_etree, doctype=doctype, pretty_print=True) + with open(file, 'wb+') as f: + f.write(output) + return True +``` + +# Starting the Audit + +## Small Office Prototype Building +The small office prototype is a single story rectangular building. We will use Denver as the location. + +We can summarize the high level features as: +- Total Floor Area: 5500sf +- WWR: Southern Wall ~25%, Other Walls ~20% +- ASHRAE Climate Zone 5B +- Assume built year: 2000 +- Let's assume this is on the 90.1-2004 code cycle +- Audit year: 2020 + +## "I have a building...where do I start" +Relevant Standard 211 Sections: +- 6.1.1 Facility Description + +Let's start by defining a building. In this exercise, we will learn about some BuildingSync design patterns that will continue to propagate. In xpath terms, buildings live here: `/BuildingSync/Facilities/Facility/Sites/Site/Buildings/Building`. A few things to notice: +- The root node of a BuildingSync document is the `BuildingSync` element +- Plurals (Facilities, Sites, Buildings) are often used to indicate parents that can contain 1 <= n < infinite child elements having a non-pluralized name (Facility, Site, Building). For example: +```xml + + + + ...children stuff here... + + + ...children stuff here... + + + +``` +- While the above can be done, it is __most common__ to find a single Facility, Site, and Building in a BuildingSync document. In general: + - Facility refers to a grouping of Sites, but a Facility is still geographically proximate. Its boundary might include not building specific things (streets, sidewalks, etc.) + - A Site is everything in and around a group of Buildings. This might be two Buildings that are connected via a tunnel, etc. + - ** Most common is just to have a single Building + +### Primary BuildingSync Structural Elements +We start by creating the primary structure of a BuildingSync document. We introduced `Facilities`, `Sites`, and `Buildings`, but there are a few additional: +- `Sections` are subportions of a `Building`. Think of a mixed-use commercial building with retail and office space, each of these would become a section. For those familiar with the ASHRAE 211 Normative Spreadsheet, a `Section` is analagous to a column in the `All - Space Functions` sheet. +- `Systems` are defined under a `Facility` and capture the energy consuming / producing assets. Each can be linked back to an individual `Facility`, `Site`, `Building`, or `Section`. +- `Reports` are defined under a `Facility` and each `Report` would contain information about reporting type requirements. Most importantly, a `Report` contains a set of `Scenario` elements, where each `Scenario` would convey building performance for one of: current / historical data, target performance, benchmark performance, baseline modeled performance, or expected performance with measure(s) implemented. + + +```python +# just take this for what it is at the moment. the bsync package makes +# it easier to work with xml content. All of this is mainly syntactic +# sugar around the lxml package, with some type checking, attribute +# assignment, etc. +root = bsync.BuildingSync() +facs = bsync.Facilities() +f1 = bsync.Facilities.Facility(ID='Facility-1') +sites = bsync.Sites() +s1 = bsync.Sites.Site(ID='Site-1') +bldgs = bsync.Buildings() +b1 = bsync.Buildings.Building(ID='Building-Small-Office-Prototype') +sections = bsync.Sections() +systems = bsync.Systems() +contacts = bsync.Contacts() +reports = bsync.Reports() +measures = bsync.Measures() +schedules = bsync.Schedules() +utilities = bsync.Utilities() + +# We link the entire report to the building +r1 = bsync.Report( + bsync.ASHRAEAuditLevel('Level 2: Energy Survey and Analysis'), + bsync.LinkedPremisesOrSystem( + bsync.LinkedPremisesOrSystem.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) + ), + ID='Report-L2-Audit') +scenarios = bsync.Scenarios() + +# We now combine these and pretty print the result for easy viewing of what we just made +root += facs +facs += f1 + +# Direct children of a facility +f1 += sites +f1 += systems +f1 += schedules +f1 += measures +f1 += reports +f1 += contacts + +# Specific to a site +sites += s1 +s1 += bldgs +bldgs += b1 + +# Direct children of a building +b1 += sections + +# Specific to a report +reports += r1 +r1 += scenarios +r1 += utilities + +pretty_print(root) +``` + + + + + + + + + + + + + + + + + + + + Level 2: Energy Survey and Analysis + + + + + + + + + + + + + + + +#### 6.2.1.1 Building information + +This section of Standard 211 asks for lots of detail. We walk through the components of this that get added _as child elements of the building_, and then discuss other information. + + +```python +# 6.2.1.1.a - name +b1 += bsync.PremisesName('Small Office Prototype in Denver') + +# 6.1.1.1.m +b1 += bsync.PremisesNotes('Here we record general problems / issues identified in a walkthrough survey.') + +# 6.1.1.1.d - address +b1 += bsync.Address( + bsync.StreetAddressDetail( + bsync.Simplified( + bsync.StreetAddress('Some address') + ) + ), + bsync.Address.State('CO'), + bsync.City('Denver'), + bsync.PostalCode('80014') +) + +# 6.2.1.1.b - gross and conditioned floor area +b1 += bsync.FloorAreas( + bsync.FloorArea( + bsync.FloorAreaType('Gross'), + bsync.FloorAreaValue(5500.0), + bsync.ExcludedSectionIDs( + bsync.ExcludedSectionID(IDref='Section-excluded') + ) + ), + bsync.FloorArea( + bsync.FloorAreaType('Conditioned'), + bsync.FloorAreaValue(5500.0), + bsync.ExcludedSectionIDs( + bsync.ExcludedSectionID(IDref='Section-excluded') + ) + ) +) + +# 6.2.1.2.b - gross wall area +b1 += bsync.TotalExteriorAboveGradeWallArea(6500.) +b1 += bsync.TotalExteriorBelowGradeWallArea(0.) + +# 6.2.1.2.c - fenestration-wall ratio +b1 += bsync.OverallWindowToWallRatio(0.2133) +b1 += bsync.OverallDoorToWallRatio(0.05) + +# 6.1.1.1.f - classification of the uses +b1 += bsync.BuildingClassification('Commercial') +b1 += bsync.OccupancyClassification('Office') +b1 += bsync.BuildingAutomationSystem(True) +b1 += bsync.HistoricalLandmark(False) + +# 6.1.1.1.h - for completeness, we spell this out explicitly +b1 += bsync.FloorsAboveGrade(1) +b1 += bsync.FloorsBelowGrade(0) +b1 += bsync.ConditionedFloorsAboveGrade(1) +b1 += bsync.ConditionedFloorsBelowGrade(0) + +# 6.1.1.1.i - again, to be explicit, we define the latest remodel / retrofit year +# to be the same as the original build year to indicate nothing has happened since original construction +b1 += bsync.YearOfConstruction(2000) +b1 += bsync.YearOccupied(2000) +b1 += bsync.RetrocommissioningDate(date(2020,3,1)) +b1 += bsync.YearOfLastMajorRemodel(2000) +b1 += bsync.YearOfLastEnergyAudit(2010) + +#pretty_print(root) +``` + +Continuing with the information required by 6.1.1.1, we define additional content that doesn't sit as direct child elements of the Building. This includes: +- Contacts. Key contacts (1 auditor and 1 owner) __must be linked__ back to the building, even though they are not in the Building subtree: + - Contacts live: /BuildingSync/Facilities/Facility/Contacts/Contact + - An auditor is linked to a building at a Report level (i.e. who performed the audit) + - Reports live: /BuildingSync/Facilities/Facility/Reports/Report + - An audit report, with the correct links to a Building, Measures, etc. should be sufficient to meet the Standard 211 requirements spelled out in Section 6. More on this later. +- Space function breakdown by space type +- Occupied hours and number of occupants + +#### Contacts + + +```python +# 6.1.1.1.b - Owner and auditor contact info +c1 = bsync.Contact( + bsync.ContactName('The dude'), + bsync.ContactCompany('Some big company'), + bsync.ContactRoles( + bsync.ContactRole('Owner') + ), + bsync.ContactTelephoneNumbers( + bsync.ContactTelephoneNumber( + bsync.TelephoneNumber('123-456-7890') + ) + ), + bsync.ContactEmailAddresses( + bsync.ContactEmailAddress( + bsync.EmailAddress('the.dude@somebigco.net') + ) + ), + ID='Contact-Owner' +) +c2 = bsync.Contact( + bsync.ContactName('The lady'), + bsync.ContactCompany('Auditeers'), + bsync.ContactRoles( + bsync.ContactRole('Energy Auditor') + ), + bsync.ContactTelephoneNumbers( + bsync.ContactTelephoneNumber( + bsync.TelephoneNumber('123-456-7890') + ) + ), + bsync.ContactEmailAddresses( + bsync.ContactEmailAddress( + bsync.EmailAddress('the.lady@the-three-auditeers.com') + ) + ), + ID='Contact-Auditor' +) +# We add the two contacts to the correct parent +contacts += c1 +contacts += c2 + +# We 'assign' (link) the owner as the primary contact for the building, though this +# could be an owners rep or some other contact type. +b1 += bsync.PrimaryContactID(IDref=c1['ID']) + +# We link the auditor contact to the report +r1 += bsync.AuditorContactID(IDref=c2['ID']) +``` + +### Space Function Analysis +Relevant Standard 211 Sections: +- 5.3.4 Space Function Analysis + +Space functions are used to define sections of a building used for different purposes. The classic example of this is a mixed use commercial real estate, with retail space on the bottom floor and offices in the remainder of the building. We do this in BuildingSync via the following: +- Each space functions gets its own `Section` element +- Each `Section` element should specify the `Section/SectionType` as 'Space function" + +The Small Office, as its name suggests, is just an office space, and therefore we will only create one section for it. + + +```python +# create a new section +section = bsync.Sections.Section( + bsync.SectionType('Space function'), + bsync.OccupancyClassification('Office'), + bsync.OriginalOccupancyClassification('Office'), + bsync.ThermalZoneLayout('Single zone'), + ID=f'Section-office' +) +section_wb = bsync.Sections.Section(ID='Section-Whole-building') +section_wb += bsync.SectionType('Whole building') +section_ex = bsync.Sections.Section(ID='Section-excluded') +sections += section +sections += section_wb +sections += section_ex +``` + +Section 5.3.4 lays out specific requirements to convey for each space function. These include: +- floor area requirements +- typical occupant usages +- systems information (plugs, lighting, hvac) + + +```python +# 5.3.4.a Gross floor area for the section (we also add conditioned for 5.3.4.f) +section_fa = bsync.FloorAreas( + bsync.FloorArea( + bsync.FloorAreaType('Gross'), + bsync.FloorAreaValue(5500.0) + ), + bsync.FloorArea( + bsync.FloorAreaType('Conditioned'), + bsync.FloorAreaValue(5500.0) + ) +) + +# 5.3.4.b and 5.3.4.c are asking for typical operating hours for the section +tous = bsync.TypicalOccupantUsages() +tou_hpw = bsync.TypicalOccupantUsage( + bsync.TypicalOccupantUsageUnits('Hours per week'), + bsync.TypicalOccupantUsageValue(40.0) +) +tou_wpy = bsync.TypicalOccupantUsage( + bsync.TypicalOccupantUsageUnits('Weeks per year'), + bsync.TypicalOccupantUsageValue(50.) +) +tous += tou_hpw +tous += tou_wpy + +# 5.3.4.d looks for normal / design or peak occupancy. +occ_levels = bsync.OccupancyLevels() +occ_design = bsync.OccupancyLevel( + bsync.OccupantQuantityType('Peak total occupants'), + bsync.OccupantQuantity(31.) +) +occ_levels += occ_design + +``` + + +```python +# finally, we add these to the actual section element +section += section_fa +section += tous +section += occ_levels +#pretty_print(sections) +``` + +### 6.2.1.1.e Schedules +Schedules of occupancy, lighting, process and plug loads, and HVAC shall be provided for typical days (weekdays, weekends, holidays). +In BuildingSync, schedules are defined individually and referred (linked) in different sections. For example, lighting schedule is linked when lighting system is defined. + + +```python +schedule_occ = bsync.Schedule(ID='Schedule-Occupancy') +schedule_light = bsync.Schedule(ID='Schedule-Lighting') +schedule_pl = bsync.Schedule(ID='Schedule-PlugLoad') +schedule_hvac = bsync.Schedule(ID='Schedule-HVAC') +schedule_hvac_new = bsync.Schedule(ID='Schedule-HVAC-new') + +# occupancy schedule +schedule_occ += bsync.ScheduleDetails( + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('06:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('06:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('07:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(11.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('07:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('08:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(21.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('08:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('12:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(100.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('12:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('13:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(53.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('13:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('17:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(100.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('17:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('18:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(32.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('18:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('22:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(11.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('22:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(5.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('23:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekend'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Holiday'), + bsync.ScheduleCategory('Occupied'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ) +) +schedule_occ += bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ), + bsync.LinkedPremises.Section( + bsync.LinkedSectionID(IDref=section['ID']) + ) +) +# lighting schedule +schedule_light += bsync.ScheduleDetails( + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('05:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(18.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('05:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('07:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(23.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('07:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('08:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(42.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('08:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('12:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(90.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('12:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('13:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(80.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('13:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('17:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(90.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('17:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('18:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(61.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('18:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('20:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(42.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('20:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('22:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(32.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('22:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(23.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('23:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(18.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekend'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(18.) + ), + bsync.ScheduleDetail( + bsync.DayType('Holiday'), + bsync.ScheduleCategory('Lighting'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(18.) + ) +) +schedule_light += bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) +) +# plug load schedule +schedule_pl += bsync.ScheduleDetails( + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Miscellaneous equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('08:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(50.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Miscellaneous equipment'), + bsync.DayStartTime(datetime.strptime('08:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('12:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(100.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Miscellaneous equipment'), + bsync.DayStartTime(datetime.strptime('12:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('13:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(94.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Miscellaneous equipment'), + bsync.DayStartTime(datetime.strptime('13:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('17:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(100.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Miscellaneous equipment'), + bsync.DayStartTime(datetime.strptime('17:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('18:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(50.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('Miscellaneous equipment'), + bsync.DayStartTime(datetime.strptime('18:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(20.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekend'), + bsync.ScheduleCategory('Miscellaneous equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(20.) + ), + bsync.ScheduleDetail( + bsync.DayType('Holiday'), + bsync.ScheduleCategory('Miscellaneous equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(20.) + ) +) +schedule_pl += bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) +) +# HVAC schedule +schedule_hvac += bsync.ScheduleDetails( + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('06:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('06:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('19:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(100.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('19:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekend'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Holiday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ) +) +schedule_hvac += bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) +) +# upgraded HVAC schedule (for EEM) +schedule_hvac_new += bsync.ScheduleDetails( + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('06:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('06:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('07:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(60.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('07:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('12:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(100.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('12:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('13:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(80.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('13:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('18:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(100.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('18:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('20:00:00', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(60.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('20:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Weekend'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ), + bsync.ScheduleDetail( + bsync.DayType('Holiday'), + bsync.ScheduleCategory('HVAC equipment'), + bsync.DayStartTime(datetime.strptime('00:00:00', '%H:%M:%S').time()), + bsync.DayEndTime(datetime.strptime('23:59:59', '%H:%M:%S').time()), + bsync.PartialOperationPercentage(0.) + ) +) +schedule_hvac_new += bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) +) + +schedules += schedule_occ +schedules += schedule_light +schedules += schedule_pl +schedules += schedule_hvac +schedules += schedule_hvac_new +``` + +#### 6.2.1.2 Envelope + +Level 2 energy audits require information about the building envelop, including roof, wall, floor and fenestration. BuildingSync defines these components (construction, thermal properties, etc.) under the `Systems` element, and links corresponding elements back to the envelope specified under the `Section` elements. A few other information (e.g. gross areas) are added under the `Building` element above. +In addition, 6.2.1.2.e requires information of the building overall tightness, and this is covered under the `AirInfiltrationSystems` element. + + + +```python +# 6.2.1.2.a roof +roofsys = bsync.RoofSystems() +roof = bsync.RoofSystem( + bsync.RoofConstruction('Wood frame'), + bsync.RoofUFactor(4.706), + ID=f'Roof-1' +) +roofsys += roof + +# 6.2.1.2.b Opaque walls (above ground) +wallsys = bsync.WallSystems() +wall = bsync.WallSystem( + bsync.ExteriorWallConstruction('Wood frame'), + bsync.WallUFactor(0.547), + ID=f'Wall-1' +) +wallsys += wall + +# 6.2.1.2.c fenestration +fenestsys = bsync.FenestrationSystems() +win1_orig = bsync.FenestrationSystem( + bsync.FenestrationType( + bsync.Window() + ), + bsync.FenestrationFrameMaterial('Vinyl'), + bsync.GlassType('Clear uncoated'), + bsync.FenestrationGlassLayers('Single pane'), + bsync.FenestrationUFactor(3.241), + bsync.SolarHeatGainCoefficient(0.391), + bsync.VisibleTransmittance(0.391), + ID=f'Window-1-Original' +) +win1 = bsync.FenestrationSystem( + bsync.FenestrationType( + bsync.Window() + ), + bsync.FenestrationFrameMaterial('Vinyl'), + bsync.GlassType('Low e'), + bsync.FenestrationGlassLayers('Triple pane'), + bsync.FenestrationUFactor(0.3), + bsync.SolarHeatGainCoefficient(0.391), + bsync.VisibleTransmittance(0.391), + ID=f'Window-1' +) +door = bsync.FenestrationSystem( + bsync.FenestrationType( + bsync.Door( + bsync.ExteriorDoorType('Insulated metal'), + bsync.DoorGlazedAreaFraction(0.5) + ) + ), + bsync.FenestrationFrameMaterial('Steel'), + bsync.FenestrationUFactor(2.839), + ID=f'Door-1' +) +fenestsys += win1_orig +fenestsys += win1 +fenestsys += door + +# 6.2.1.2.d floor +foundsys = bsync.FoundationSystems() +found = bsync.FoundationSystem( + bsync.GroundCouplings( + bsync.GroundCoupling( + bsync.SlabOnGrade( + bsync.SlabUFactor(0.345) + ) + ) + ), + bsync.FloorConstructionType('Concrete poured'), + ID=f'Foundation-1' +) +foundsys += found + +# 6.2.1.2.e tightness +infiltsys = bsync.AirInfiltrationSystems() +infilt = bsync.AirInfiltrationSystem( + bsync.AirInfiltrationNotes('Notes on test'), + bsync.AirInfiltrationSystem.Tightness('Tight'), + bsync.AirInfiltrationValue(0.151), + bsync.AirInfiltrationValueUnits('ACHnatural'), + bsync.AirInfiltrationTest('Blower door'), + bsync.LinkedPremises( + bsync.LinkedPremises.Section( + bsync.LinkedSectionID(IDref=section_wb['ID']) + ) + ), + ID=f'Infiltration-1' +) +infiltsys += infilt + +waterinfiltsys = bsync.WaterInfiltrationSystems() +waterinfilt = bsync.WaterInfiltrationSystem( + bsync.WaterInfiltrationNotes('Notes on test'), + bsync.LinkedPremises( + bsync.LinkedPremises.Section( + bsync.LinkedSectionID(IDref=section_wb['ID']) + ) + ) +) +waterinfiltsys += waterinfilt +``` + + +```python +# now we add these components to System element +systems += roofsys +systems += wallsys +systems += fenestsys +systems += foundsys +systems += infiltsys +systems += waterinfiltsys +#pretty_print(systems) +``` + + +```python +# then we link these components to the envelope elements under Section/Sides +section_wb += bsync.FootprintShape('Rectangular') +wallarea = {'A1':909.01223, 'B1':606.0082, 'C1':909.01223, 'D1':606.0082} +windowarea = {'A1':180.18786, 'B1':120.12524, 'C1':180.18786, 'D1':120.12524} +doorarea = {'A1':42.08689, 'B1':0.0, 'C1':0.0, 'D1':0.0} + +section_sides = bsync.Sides() +for sidenumber in ['A1', 'B1', 'C1', 'D1']: + section_sides += bsync.Side( + bsync.SideNumber(sidenumber), + bsync.WallIDs( + bsync.WallID( + bsync.WallArea(wallarea[sidenumber]), + IDref=wall['ID'] + ) + ), + bsync.WindowIDs( + bsync.WindowID( + bsync.FenestrationArea(windowarea[sidenumber]), + IDref=win1_orig['ID'] + ) + ), + bsync.DoorIDs( + bsync.DoorID( + bsync.FenestrationArea(doorarea[sidenumber]), + IDref=door['ID'] + ) + ) + ) + +section_roofs = bsync.Roofs( + bsync.Roof( + bsync.RoofID( + bsync.RoofArea(6444.999), + bsync.RoofCondition('Good'), + IDref=roof['ID'] + ) + ) +) +section_founds = bsync.Foundations( + bsync.Foundation( + bsync.FoundationID( + bsync.FoundationArea(3891.1536), + IDref=found['ID'] + ) + ) +) + +section_wb += section_sides +section_wb += section_roofs +section_wb += section_founds +#pretty_print(sections) +``` + +#### HVAC, SHW/DHW, Lighting, Plugs + +Level 2 energy audits require information about the primary systems serving a specific section, with details such as types, capacities and conditions + + +```python +# 6.2.1.3 HVAC +# Here we specify HVAC system details +# and link them back to the Section of interest. +# According to prototype small office spec in ASHRAE901_OfficeSmall_STD2004 +# the heating source is Air-source heat pump with gas furnace as back up +# and cooling source is Air-source heat pump +# and air distribution unit is Single zone, constant air volume air distribution, one unit per occupied thermal zone + +hvac_systems = bsync.HVACSystems() +hvac_system = bsync.HVACSystem(ID='HVACSystem-1') +hvac_systems += hvac_system +# link hvac to section +hvac_system += bsync.LinkedPremises( + bsync.LinkedPremises.Section( + bsync.LinkedSectionID( + bsync.LinkedScheduleIDs( + bsync.LinkedScheduleID(IDref=schedule_hvac['ID']) + ), + IDref=section['ID'] + ) + ) +) + +# heating and cooling system +hc_systems = bsync.HeatingAndCoolingSystems() +hc_systems += bsync.ZoningSystemType('Single zone') + +# cooling system +css = bsync.CoolingSources() +coolingcapacities = [10198.9, 9847.2, 7737.1, 9143.8, 9847.2] +for index, coolingcapacity in enumerate(coolingcapacities): + cs = bsync.CoolingSource( + bsync.CoolingSourceType( + bsync.DX( + bsync.DXSystemType('Packaged/unitary heat pump'), + bsync.CompressorType('Reciprocating'), + bsync.CompressorStaging('Single stage') + ) + ), + bsync.AnnualCoolingEfficiencyValue(2.61), + bsync.AnnualCoolingEfficiencyUnits('COP'), + bsync.Capacity(coolingcapacity), + bsync.CapacityUnits('W'), + bsync.CoolingSourceCondition('Good'), + bsync.CoolingSource.Controls( + bsync.CoolingSource.Controls.Control( + bsync.CoolingSource.Controls.Control.OtherControlTechnology( + bsync.ControlSystemType( + bsync.Digital() + ) + ) + ) + ), + bsync.YearInstalled(2000), + ID=f'CoolingSource-{index+1}' + ) + css += cs + +hc_systems += css + +# heating system +hss = bsync.HeatingSources() +heatingcapacities = [10311.1, 9801.3, 7858.1, 9067.8, 9855.4] +for index, heatingcapacity in enumerate(heatingcapacities): + hs = bsync.HeatingSource( + bsync.HeatingSourceType( + bsync.HeatingSourceType.HeatPump( + bsync.HeatPumpType('Packaged Unitary'), + bsync.HeatPumpBackupSystemFuel('Natural gas'), + bsync.HeatPumpBackupAFUE(0.0), + bsync.CoolingSourceID(IDref=cs['ID']) + ) + ), + bsync.AnnualHeatingEfficiencyValue(3.01), + bsync.AnnualHeatingEfficiencyUnits('COP'), + bsync.InputCapacity(heatingcapacity), + bsync.HeatingSource.Capacity(heatingcapacity), + bsync.CapacityUnits('W'), + bsync.HeatingSourceCondition('Good'), + bsync.HeatingSource.Controls( + bsync.HeatingSource.Controls.Control( + bsync.HeatingSource.Controls.Control.OtherControlTechnology( + bsync.ControlSystemType( + bsync.Digital() + ) + ) + ) + ), + bsync.YearInstalled(2000), + ID=f'HeatingSource-{index+1}' + ) + hss += hs + +hc_systems += hss + +# delivery system +delivers = bsync.Deliveries() +for each in range(1,6): + deliver = bsync.Delivery( + bsync.DeliveryType( + bsync.CentralAirDistribution( + bsync.AirDeliveryType('Central fan'), + bsync.TerminalUnit('CAV terminal box no reheat'), + bsync.ReheatSource('None'), + bsync.FanBased( + bsync.AirSideEconomizer( + bsync.AirSideEconomizerType('None'), + bsync.EconomizerControl('Fixed'), + ID=f'AirSideEconomizer-{each}' + ) + ) + ) + ), + bsync.HeatingSourceID(IDref=f'HeatingSource-{each}'), + bsync.CoolingSourceID(IDref=f'CoolingSource-{each}'), + bsync.Delivery.Controls( + bsync.Delivery.Controls.Control( + bsync.Delivery.Controls.Control.OtherControlTechnology( + bsync.ControlSystemType( + bsync.Digital() + ) + ) + ) + ), + bsync.YearInstalled(2000), + bsync.Quantity(1), + bsync.DeliveryCondition('Good'), + ID=f'Delivery-{each}' + ) + delivers += deliver + +hc_systems += delivers + +# duct +duct_systems = bsync.DuctSystems() +for each in range(1,6): + duct = bsync.DuctSystem( + bsync.DuctConfiguration('Single'), + bsync.DuctInsulationCondition('Good'), + bsync.HeatingDeliveryID(IDref=f'Delivery-{each}'), + bsync.CoolingDeliveryID(IDref=f'Delivery-{each}'), + ID=f'DuctSystem-{each}' + ) + duct_systems += duct + +# HVAC control +hvacctl = bsync.HVACControlSystemTypes( + bsync.HVACControlSystemType('Digital') +) + +hvac_system += hc_systems +hvac_system += duct_systems +hvac_system += hvacctl + +# fan +fan_systems = bsync.FanSystems() +fanflowrate = [880., 836., 671., 774., 841.] +fanflowrate_new = [872., 830., 664., 766., 833.] +for each in range(1,6): + fan = bsync.FanSystem( + bsync.FanEfficiency(0.536), + bsync.FanSize(fanflowrate[each-1]), + bsync.FanInstalledFlowRate(fanflowrate[each-1]), + bsync.FanControlType('Constant Volume'), + bsync.LinkedSystemIDs( + bsync.LinkedSystemID(IDref=f'Delivery-{each}') + ), + ID=f'FanSystem-{each}' + ) + fan_new = bsync.FanSystem( + bsync.FanEfficiency(0.536), + bsync.FanSize(fanflowrate_new[each-1]), + bsync.InstalledFlowRate(fanflowrate_new[each-1]), + bsync.FanControlType('Variable Volume'), + bsync.LinkedSystemIDs( + bsync.LinkedSystemID(IDref=f'Delivery-{each}') + ), + ID=f'FanSystem-{each}-new' + ) + fan_systems += fan + fan_systems += fan_new +``` + + +```python +# 6.2.1.4 SHW/DHW +# Required information are types, ratings, operating and general conditions, +# According to prototype small office spec in ASHRAE901_OfficeSmall_STD2004 +# SHW type is electric Storage tank + +shw_systems = bsync.DomesticHotWaterSystems() +shw = bsync.DomesticHotWaterSystem( + bsync.DomesticHotWaterType( + bsync.StorageTank( + #bsync.TankHeatingType( + # bsync.Direct( + # bsync.DirectTankHeatingSource( + # bsync.ElectricResistance(123.) + # ) + # ) + #), + bsync.TankHeatingType(bsync.Unknown()), + bsync.TankVolume(40.), + bsync.StorageTankInsulationRValue(123.) # arbitrary value, actually not required + ) + ), + bsync.DomesticHotWaterSystemNotes('Notes'), + bsync.PrimaryFuel('Electricity'), + bsync.Recirculation( + bsync.RecirculationLoopCount(1), + bsync.RecirculationFlowRate(3.6), + bsync.RecirculationControlType('Continuous'), + bsync.PipeInsulationThickness(123.), # arbitrary value, actually not required + bsync.RecirculationEnergyLossRate(1.870180469) + ), + bsync.HotWaterDistributionType('Looped'), + bsync.HotWaterSetpointTemperature(140.), + bsync.WaterHeaterEfficiency(1.), + bsync.WaterHeaterEfficiencyType('Thermal Efficiency'), + bsync.DailyHotWaterDraw(40.), # arbitrary value, actually not required + bsync.ParasiticFuelConsumptionRate(1950.52), # 572 W to Btu/hr + bsync.Capacity(11722.84), + bsync.CapacityUnits('W'), + bsync.YearInstalled(2000), + bsync.DomesticHotWaterSystemCondition('Good'), + bsync.DomesticHotWaterSystem.Controls( + bsync.DomesticHotWaterSystem.Controls.Control( + bsync.DomesticHotWaterSystem.Controls.Control.Manual( + bsync.ControlSystemType( + bsync.ControlSystemType.Other() + ) + ) + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ), + bsync.LinkedPremises.Section( + bsync.LinkedSectionID(IDref=section['ID']) + ) + ), + bsync.Quantity(1), + ID=f'SHW-1' +) +shw_systems += shw +``` + + +```python +# 6.2.1.5 +# For the lighting systems, this is a bit different. When +# performing an audit, it is atypical to know the LPD of a space / zone +# as you would in 'Energy Modeling' world / design world. +# Assuming drawings are unavailable and we go in to check, +# based on the vintage it's likely we will find T8 linear +# fluorescents (thanks Jay Wratten!). So we add that information +light_systems = bsync.LightingSystems() +ls1 = bsync.LightingSystem( + bsync.OutsideLighting(False), + bsync.LampType( + bsync.LinearFluorescent( + bsync.LinearFluorescent.LampLabel('T8') + ) + ), + bsync.BallastType('Standard Electronic'), + bsync.DimmingCapability( + bsync.MinimumDimmingLightFraction(0.2) + ), + bsync.InstalledPower(5.500), + bsync.LampPower(32.0), + bsync.NumberOfLampsPerBallast(4), + bsync.NumberOfBallastsPerLuminaire(1.), + bsync.NumberOfLuminaires(43), + bsync.PercentPremisesServed(100.), + bsync.LightingAutomationSystem(False), + bsync.LightingSystem.Controls( + bsync.LightingSystem.Controls.Control( + bsync.LightingSystem.Controls.Control.OtherControlTechnology( + bsync.ControlSystemType( + bsync.Digital() + ), + bsync.LightingSystem.Controls.Control.OtherControlTechnology.ControlStrategy('Programmable') + ) + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Section( + bsync.LinkedSectionID( + bsync.LinkedScheduleIDs( + bsync.LinkedScheduleID(IDref=schedule_light['ID']) + ), + IDref=section['ID']) + ) + ), + ID='LightingSystem-1' +) +# there is no specific information related to exterior lighting (but it exists) +ls2 = bsync.LightingSystem( + bsync.OutsideLighting(True), + bsync.LampType( + bsync.LinearFluorescent( + bsync.LinearFluorescent.LampLabel('T12') + ) + ), + bsync.BallastType('Standard Electronic'), + bsync.InstalledPower(1.582575), + bsync.LampPower(316.516), + bsync.NumberOfLampsPerBallast(1), + bsync.NumberOfBallastsPerLuminaire(1.), + bsync.NumberOfLuminaires(5), + bsync.PercentPremisesServed(100.), + bsync.LightingAutomationSystem(False), + bsync.LightingSystem.Controls( + bsync.LightingSystem.Controls.Control( + bsync.LightingSystem.Controls.Control.OtherControlTechnology( + bsync.ControlSystemType( + bsync.Digital() + ), + bsync.LightingSystem.Controls.Control.OtherControlTechnology.ControlStrategy('Programmable') + ) + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Section( + bsync.LinkedSectionID( + bsync.LinkedScheduleIDs( + bsync.LinkedScheduleID(IDref=schedule_light['ID']) + ), + IDref=section_wb['ID']) + ) + ), + ID='LightingSystem-2' +) +# new led lighting system for measure +ls_new = bsync.LightingSystem( + bsync.OutsideLighting(False), + bsync.LampType( + bsync.SolidStateLighting( + bsync.SolidStateLighting.LampLabel('LED') + ) + ), + bsync.BallastType('Standard Electronic'), + bsync.DimmingCapability( + bsync.MinimumDimmingLightFraction(0.1) + ), + bsync.InstalledPower(2.752), + bsync.LampPower(16.), + bsync.NumberOfLampsPerBallast(4), + bsync.NumberOfBallastsPerLuminaire(1.), + bsync.NumberOfLuminaires(43), + bsync.PercentPremisesServed(100.), + bsync.LightingAutomationSystem(False), + bsync.LightingSystem.Controls( + bsync.LightingSystem.Controls.Control( + bsync.Daylighting( + bsync.ControlSystemType( + bsync.Digital() + ), + bsync.Daylighting.ControlSensor('Photocell'), + bsync.Daylighting.ControlStrategy('Continuous') + ) + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Section( + bsync.LinkedSectionID( + bsync.LinkedScheduleIDs( + bsync.LinkedScheduleID(IDref=schedule_light['ID']) + ), + IDref=section['ID']) + ) + ), + ID='LightingSystem-new' +) + +light_systems += ls1 +light_systems += ls2 +light_systems += ls_new +``` + + +```python +# 6.2.1.6 Process, plug and conveyance loads +# There are no process and conveyance loads identified for prototype small office +# The plug loads are pretty straightforwad +# Based on the Small Office 90.1-2004 prototype model, +# each zone has an EPD of 0.63 W/ft2 +# Since all zones are part of the same section, we can +# just assign this EPD to the Section as a whole +plug_systems = bsync.PlugLoads() +psys = bsync.PlugLoad( + bsync.PlugLoadType('Miscellaneous Electric Load'), + bsync.WeightedAverageLoad(0.63), + bsync.LinkedPremises( + bsync.LinkedPremises.Section( + bsync.LinkedSectionID( + bsync.LinkedScheduleIDs( + bsync.LinkedScheduleID(IDref=schedule_pl['ID']) + ), + IDref=section['ID']) + ) + ), + ID='PlugLoad-1' +) +plug_systems += psys +``` + + +```python +systems += hvac_systems +systems += fan_systems +systems += shw_systems +systems += light_systems +systems += plug_systems +#pretty_print(systems) +``` + +### Current Building Measured Scenario +Relevant Standard 211 Sections: +- 6.1.2 + +Now that we have a quick sense of the building, let's start off by looking at the requirements for an ASHRAE 211 Level 1 audit. This leads us to the concept of a [Scenario](https://buildingsync.net/schema/v2.3.0/documentation/BuildingSync_xsd.html#ScenarioType). A Scenario in BuildingSync is used to refer to energy and timeseries data associated with a particular, well, scenario. Specifically, there are 5 primary Scenarios used in BuildingSync, all which relate back to Standard 211: + +![Scenario Types](./img/b1-sc-docs.png) + +We will repeatedly come back to the concept of a Scenario, as they are core to organizing information in a BuildingSync document. + +The current building measured scenario is intended to capture true measured historical data. Typically this refers to utility bill data, but AMI type data can also be captured (later). We start off by creating a new scenario element and defining its type as follows: +- `Scenario[ScenarioType/CurrentBuilding/CalculationMethod/Measured]`. This is an XPath expression that can be interpreted as "A Scenario that has the child elements ScenarioType/CurrentBuilding/CalculationMethod/Measured". The XML for this would look like: +```xml + + + + + + + + + +``` + +We build this scenario up programatically as follows: + + +```python +# define the current building measured scenario (cbms) +cbms = bsync.Scenario( + bsync.Scenario.ScenarioType( + bsync.CurrentBuilding( + bsync.CalculationMethod( + bsync.Measured() + ) + ) + ) +) +cbms['ID'] = 'Scenario-measured' + +# add the scenario to the audit report and scenarios parent grouping +scenarios += cbms +``` + +#### Utilities +Relevant Standard 211 Sections: 6.1.2 +In the next section, we will create resource use elements to define energy data. First, we need to get add utility information. Utility information gets added at the report level. Specific information required includes: +- Rate schedules (you can get very expressive in BuildingSync with Rate Schedules - we keep it pretty minimal here) +- Utility account numbers + + +```python +elec_ut = bsync.Utility( + bsync.RateSchedules( + bsync.RateSchedule( + bsync.TypeOfRateStructure( + bsync.FlatRate( + bsync.FlatRate.RatePeriods( + bsync.FlatRate.RatePeriods.RatePeriod( + bsync.ApplicableStartDateForEnergyRate(date(2019,6,1)), + bsync.ApplicableEndDateForEnergyRate(date(2019,9,30)), + bsync.EnergyCostRate(0.08852), # $0.08852/kWh + bsync.ApplicableStartDateForDemandRate(date(2019,6,1)), + bsync.ApplicableEndDateForDemandRate(date(2019,9,30)), + bsync.ElectricDemandRate(0.) # no demand cost + ), + bsync.FlatRate.RatePeriods.RatePeriod( + bsync.ApplicableStartDateForEnergyRate(date(2019,1,1)), + bsync.ApplicableEndDateForEnergyRate(date(2019,5,31)), + bsync.EnergyCostRate(0.05314), # $0.05314/kWh + bsync.ApplicableStartDateForDemandRate(date(2019,1,1)), + bsync.ApplicableEndDateForDemandRate(date(2019,5,31)), + bsync.ElectricDemandRate(0.) # no demand cost + ), + bsync.FlatRate.RatePeriods.RatePeriod( + bsync.ApplicableStartDateForEnergyRate(date(2019,10,1)), + bsync.ApplicableEndDateForEnergyRate(date(2019,12,31)), + bsync.EnergyCostRate(0.05314), # $0.05314/kWh + bsync.ApplicableStartDateForDemandRate(date(2019,10,1)), + bsync.ApplicableEndDateForDemandRate(date(2019,12,31)), + bsync.ElectricDemandRate(0.) # no demand cost + ) + ) + ) + ), + bsync.ReferenceForRateStructure('https://www.xcelenergy.com/company/rates_and_regulations/rates/rate_books'), + bsync.FixedMonthlyCharge(16.88), + ID='RateSchedule-Electricity' + ) + ), + bsync.UtilityMeterNumbers( + bsync.UtilityMeterNumber('Some-meter-ID') + ), + bsync.EIAUtilityID(12345), + bsync.UtilityName('Xcel Energy'), + bsync.UtilityAccountNumber('some-account-number'), + bsync.UtilityBillpayer('Building Owner'), + ID='Utility-Electric' +) +ng_ut = bsync.Utility( + bsync.RateSchedules( + bsync.RateSchedule( + bsync.TypeOfRateStructure( + bsync.FlatRate( + bsync.FlatRate.RatePeriods( + bsync.FlatRate.RatePeriods.RatePeriod( + bsync.ApplicableStartDateForEnergyRate(date(2019,1,1)), + bsync.ApplicableEndDateForEnergyRate(date(2019,12,31)), + bsync.EnergyCostRate(0.16360) # $/therm + ) + ) + ) + ), + bsync.ReferenceForRateStructure('https://www.xcelenergy.com/company/rates_and_regulations/rates/rate_books'), + bsync.FixedMonthlyCharge(43.88), + ID='RateSchedule-Natural-Gas' + ) + ), + bsync.UtilityMeterNumbers( + bsync.UtilityMeterNumber('Some-meter-ID') + ), + bsync.UtilityName('Xcel Energy'), + bsync.UtilityAccountNumber('some-other-account-number'), + bsync.UtilityBillpayer('Building Owner'), + ID='Utility-Natural-Gas' +) +``` + + +```python +utilities += elec_ut +utilities += ng_ut +``` + +#### ResourceUses and TimeSeries Data +Now that we have a current building measured scenario, we want to declare energy and monthly billing data. Per Std 211 6.1.2.1, a minimum of 12 months (preferably up to 3 years) of energy use data is required. The mechanical system of the small office prototype is a heatpump air handler with natural gas backup. We run the simulation to get estimates for this, which come out as follows: + +| Resource Type | Jan | Feb | Mar | Apr | May | Jun | Jul | Aug | Sep | Oct | Nov | Dec | +| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | +| Electricity (kWh) | 5933.1 | 5446.1 | 5736.49 | 4980.5 | 5187.21 | 5842.95 | 5801.73 | 6220.16 | 5682.87 | 5571.93 | 5525.15 | 5405.94 | +| Natural Gas (MMBtu) | 1.72 | 1.25 | 0.41 | 0.43 | 0.01 | 0.0 | 0.0 | 0.0 | 0.0 | 0.2 | 0.4 | 4.3 | +| Electricity peak (kW) | 23.58 | 25.38 | 26.04 | 24.45 | 17.03 | 22.71 | 22.01 | 21.81 | 20.63 | 21.87 | 21.63 | 21.78 | + +In BuildingSync land, we need to declare an resource use for each resource type. Standard, allowable enumerations exist for this already. We do this as follows: + + +```python +all_ru = bsync.ResourceUses() + +# create a resource use for electricity, units of kWh, all end uses +# we also add info about the 'peak' units +# we also connect it up to a utility +elec_ru = bsync.ResourceUse( + bsync.EnergyResource('Electricity'), + bsync.ResourceUseNotes('This is required to document irregularities in monthly energy patterns (Std 211 6.1.2.1.j). No irregularities found.'), + bsync.ResourceUnits('kWh'), + bsync.PeakResourceUnits('kW'), + bsync.EndUse('All end uses'), + bsync.UtilityIDs( + bsync.UtilityID(IDref=elec_ut['ID']) + ), + ID=f'ResourceUse-Electricity' +) +# given the above, we add the annual totals +elec_ru += bsync.AnnualFuelUseNativeUnits(67334.15) +elec_ru += bsync.AnnualFuelUseConsistentUnits(229.75365655) #convert to MMBTU +elec_ru += bsync.AnnualPeakNativeUnits(26.04) # kW as specified above +elec_ru += bsync.AnnualPeakConsistentUnits(26.04) # already in kW, same as above +elec_ru += bsync.AnnualFuelCost(4613.82) # + +# create a resource use for natural gas, units of MMBtu, all end uses +# additional connect it up to the utility +ng_ru = bsync.ResourceUse( + bsync.EnergyResource('Natural gas'), + bsync.ResourceUseNotes('No irregularities in monthly energy consumption found.'), + bsync.ResourceUnits('MMBtu'), + bsync.EndUse('All end uses'), + bsync.UtilityIDs( + bsync.UtilityID(IDref=ng_ut['ID']) + ), + ID=f'ResourceUse-Natural-gas' +) +# given the above, we add the annual totals +ng_ru += bsync.AnnualFuelUseNativeUnits(8.72) +ng_ru += bsync.AnnualFuelUseConsistentUnits(8.72) # already in MMBTU +ng_ru += bsync.AnnualFuelCost(540.83) # + +# create resource uses for submetering of lighting, heating and cooling +lighting_ru = bsync.ResourceUse( + bsync.EnergyResource('Electricity'), + bsync.ResourceUnits('kWh'), + bsync.EndUse('Interior lighting'), + bsync.AnnualFuelUseNativeUnits(20062.69), + bsync.AnnualFuelUseConsistentUnits(68.45389828), + bsync.PercentEndUse(28.705), + bsync.ParentResourceUseID(IDref=elec_ru['ID']), + ID=f'ResourceUse-Electricity-Lighting-Submeter' +) +heating_ru = bsync.ResourceUse( + bsync.EnergyResource('Electricity'), + bsync.ResourceUnits('kWh'), + bsync.EndUse('Heating'), + bsync.AnnualFuelUseNativeUnits(4698.23), + bsync.AnnualFuelUseConsistentUnits(16.03036076), + bsync.PercentEndUse(6.722), + bsync.ParentResourceUseID(IDref=elec_ru['ID']), + ID=f'ResourceUse-Electricity-Heating-Submeter' +) +cooling_ru = bsync.ResourceUse( + bsync.EnergyResource('Electricity'), + bsync.ResourceUnits('kWh'), + bsync.EndUse('Cooling'), + bsync.AnnualFuelUseNativeUnits(6128.87), + bsync.AnnualFuelUseConsistentUnits(20.91170444), + bsync.PercentEndUse(8.769), + bsync.ParentResourceUseID(IDref=elec_ru['ID']), + ID=f'ResourceUse-Electricity-Cooling-Submeter' +) +shw_ru = bsync.ResourceUse( + bsync.EnergyResource('Electricity'), + bsync.ResourceUnits('kWh'), + bsync.EndUse('Domestic hot water'), + bsync.AnnualFuelUseNativeUnits(7185.37), + bsync.AnnualFuelUseConsistentUnits(24.51648244), + bsync.PercentEndUse(10.281), + bsync.ParentResourceUseID(IDref=elec_ru['ID']), + ID=f'ResourceUse-Electricity-SHW-Submeter' +) +pl_ru = bsync.ResourceUse( + bsync.EnergyResource('Electricity'), + bsync.ResourceUnits('kWh'), + bsync.EndUse('Plug load'), + bsync.AnnualFuelUseNativeUnits(14942.15), + bsync.AnnualFuelUseConsistentUnits(50.9826158), + bsync.PercentEndUse(21.379), + bsync.ParentResourceUseID(IDref=elec_ru['ID']), + ID=f'ResourceUse-Electricity-Plugload-Submeter' +) + +# add these to the ResourceUses parent element +all_ru += elec_ru +all_ru += ng_ru +all_ru += lighting_ru +all_ru += heating_ru +all_ru += cooling_ru +all_ru += shw_ru +all_ru += pl_ru +# ResourceUses are child elements of a specific scenario: +cbms += all_ru +``` + +#### All TimeSeries Data +The following cell simply performs the following: +1. Create a simple function to generate monthly timeseries elements for each resource use +1. Add it to a `TimeSeriesData` parent element +1. Add this back to the previously defined current building measured scenario (i.e. Scenario-1) + + +```python +full_ts_data = bsync.TimeSeriesData() + +# usage and peak data +monthly_elec = [5933.1, 5446.1, 5736.49, 4980.5, 5187.21, 5842.95, 5801.73, 6220.16, 5682.87, 5571.93, 5525.15, 5405.94] +monthly_ng = [1.72, 1.25, 0.41, 0.43, 0.01, 0.0, 0.0, 0.0, 0.0, 0.2, 0.4, 4.3] +monthly_elec_peak = [23.58, 25.38, 26.04, 24.45, 17.03, 22.71, 22.01, 21.81, 20.63, 21.87, 21.63, 21.78] +monthly_elec_lf = [0.373, 0.394, 0.390, 0.358, 0.374, 0.386, 0.369, 0.372, 0.373, 0.354, 0.380, 0.362] + +# costs data +monthly_elec_cost = [332.16, 306.29, 321.72, 281.54, 292.53, 534.10, 530.45, 567.49, 519.93, 312.97, 310.49, 304.15] +monthly_ng_cost = [46.69, 45.93, 44.55, 44.58, 43.90, 43.88, 43.88, 43.88, 43.88, 44.21, 44.53, 50.92] + +elec_ids = [] +ng_ids = [] +daysinmonth = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31] +def create_monthly(values, resource_use_id, start_year, tsrq='Energy', rt='Total'): + """ + tsrq: One of Energy, Power, Cost + rt: One of Total, Peak, Cost, Load factor + """ + monthly = [] + end_year = start_year + for i, val in enumerate(values, start=1): + if i % 12 == 0: + start_month = 12 + end_month = 1 + end_year += 1 + else: + start_month = i % 12 + end_month = start_month + 1 + start_dt = datetime(start_year, start_month, 1) + end_dt = datetime(end_year, end_month, 1) + + if rt == 'Load factor': + my_id = f'TS-{resource_use_id}-Loadfactor-{start_month}' + else: + my_id = f'TS-{resource_use_id}-{rt}-{start_month}' + + if rt == 'Peak': + ts = bsync.TimeSeries( + bsync.ReadingType(rt), + bsync.PeakType('On-peak'), + bsync.TimeSeriesReadingQuantity(tsrq), + bsync.StartTimestamp(start_dt), + bsync.EndTimestamp(end_dt), + bsync.IntervalDuration(daysinmonth[i-1]), + bsync.IntervalDurationUnits('Day'), + bsync.IntervalFrequency('Month'), + bsync.IntervalReading(float(val)), + bsync.ResourceUseID(IDref=resource_use_id), + ID=my_id + ) + else: + ts = bsync.TimeSeries( + bsync.ReadingType(rt), + bsync.TimeSeriesReadingQuantity(tsrq), + bsync.StartTimestamp(start_dt), + bsync.EndTimestamp(end_dt), + bsync.IntervalDuration(daysinmonth[i-1]), + bsync.IntervalDurationUnits('Day'), + bsync.IntervalFrequency('Month'), + bsync.IntervalReading(float(val)), + bsync.ResourceUseID(IDref=resource_use_id), + ID=my_id + ) + + monthly.append(ts) + + if tsrq == 'Energy': + if 'Electricity' in resource_use_id: + elec_ids.append(my_id) + else: + ng_ids.append(my_id) + return monthly + +elec_ts = create_monthly(monthly_elec, elec_ru['ID'], 2019) +ng_ts = create_monthly(monthly_ng, ng_ru['ID'], 2019) +elec_peak_ts = create_monthly(monthly_elec_peak, elec_ru['ID'], 2019, 'Power', 'Peak') +elec_lf_ts = create_monthly(monthly_elec_lf, elec_ru['ID'], 2019, 'Power', 'Load factor') + +elec_cost_ts = create_monthly(monthly_elec_cost, elec_ru['ID'], 2019, 'Cost', 'Cost') +ng_cost_ts = create_monthly(monthly_ng_cost, ng_ru['ID'], 2019, 'Cost', 'Cost') + +def add_to_full(months, full): + for month in months: + full += month + +add_to_full(elec_ts, full_ts_data) +add_to_full(ng_ts, full_ts_data) +add_to_full(elec_peak_ts, full_ts_data) +add_to_full(elec_lf_ts, full_ts_data) +add_to_full(elec_cost_ts, full_ts_data) +add_to_full(ng_cost_ts, full_ts_data) + +cbms += full_ts_data +``` + +#### Linked TimeSeriesIDs +Due to the fact that annual data reporting is dependent on which months / utility bill periods were used to calculate the annual total, the `AnnualFuelUseLinkedTimeSeriesIDs` element was introduced. It is required to specify exactly which months for each resource use were used in the calculation of the `AnnualFuelUseNativeUnits` and `AnnualFuelUseConsistentUnits` elements. We add this element below. + + +```python +elec_linked_ids = bsync.AnnualFuelUseLinkedTimeSeriesIDs() +for each_id in elec_ids: + elec_linked_ids += bsync.LinkedTimeSeriesID(IDref=each_id) + + +ng_linked_ids = bsync.AnnualFuelUseLinkedTimeSeriesIDs() +for each_id in ng_ids: + ng_linked_ids += bsync.LinkedTimeSeriesID(IDref=each_id) + +elec_ru += elec_linked_ids +ng_ru += ng_linked_ids +``` + +#### All Resource Totals + +We have defined monthly electricity (energy, power, cost) and natural gas (energy, cost) usage as timeseries elements. Now we basically just need to summarize these into site and source energy use totals. We use the `Scenario/AllResourceTotals/AllResourceTotal` element to achieve this. The Level 1 use case requires annual energy reporting to follow Standard 105s methodology including: + +- `SiteEnergyUse`: Corresponds to $E_{site}$ +- `BuildingEnergyUse`: Corresponds to $E_{bld}$ +- `ImportedEnergyConsistentUnits`: Corresponds to $E_{imp}$ +- `OnsiteEnergyProductionConsistentUnits`: Corresponds to $E_{g}$ +- `ExportedEnergyConsistentUnits`: Corresponds to $E_{exp}$ +- `NetIncreaseInStoredEnergyConsistentUnits`: Corresponds to $E_{s}$ + + +```python +art = bsync.AllResourceTotals( + bsync.AllResourceTotal( + bsync.AllResourceTotal.SiteEnergyUse(238473.65655), # reported in kBtu + bsync.SiteEnergyUseIntensity(43.3588), # reported in kbtu/ft2 + + # Since there is no energy generated onsite, there is no difference btw site and building energy usage / intensity + bsync.BuildingEnergyUse(238473.65655), + bsync.BuildingEnergyUseIntensity(43.3588), + + bsync.ImportedEnergyConsistentUnits(238.47365655), # in this case, same as building and site energy, but in MMBTU + bsync.OnsiteEnergyProductionConsistentUnits(0.), # no energy produced onsite, MMBtu + bsync.ExportedEnergyConsistentUnits(0.), # no energy exported, MMBtu + bsync.NetIncreaseInStoredEnergyConsistentUnits(0.), # no energy stored, MMBtu + + bsync.AllResourceTotal.SourceEnergyUse(737088.9), # reported in kBtu. Assume site -> source: elec = 3.167, ng = 1.084 + bsync.SourceEnergyUseIntensity(134.0), # kbtu/ft2 + bsync.EnergyCost(4952.48), + bsync.EnergyCostIndex(0.90), # $/ft2 + ID='AllResourceTotal-1' + ) +) +``` + + +```python +cbms += art +cbms += bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) +) +``` + +### Benchmark Scenario +Relevant Standard 211 Sections: +- 6.1.3 + +We inserted the above information (electricity, natural gas, square footage, etc.) into the Energy Star Portfolio Manager and got a score of 82. We can add this information into BuildingSync with our benchmark scenario. + +![ESPM](./img/ESPM.png) + + +```python +# define the benchmark scenario +bench_sc = bsync.Scenario( + bsync.AllResourceTotals( + bsync.AllResourceTotal( + bsync.AllResourceTotal.SiteEnergyUse(238473.65655), + bsync.SiteEnergyUseIntensity(43.3588), + bsync.EnergyCost(4952.48), + ID='AllResourceTotal-Benchmark' + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) + ), + ID='Scenario-Benchmark' +) +bench_st = bsync.Scenario.ScenarioType() +bench = bsync.Benchmark( + bsync.BenchmarkType( + bsync.PortfolioManager( + bsync.PMBenchmarkDate(date(2022, 6, 1)) + ) + ), + bsync.BenchmarkTool('Portfolio Manager'), + bsync.BenchmarkYear(2019), + bsync.BenchmarkValue(80.) +) + +# +scenarios += bench_sc +bench_sc += bench_st +bench_st += bench +``` + +### Target Scenario +Relevant Standard 211 Sections: +- 6.1.4 + +Since we used a PM score in the baseline, we will also use that for our target. Let's say we are shooting for a target score of 70. + + +```python +# define the target scenario in reference to the benchmark scenario +target_sc = bsync.Scenario( + bsync.AllResourceTotals( + bsync.AllResourceTotal( + bsync.AllResourceTotal.SiteEnergyUse(190348.6), + bsync.SiteEnergyUseIntensity(34.6), + bsync.EnergyCost(4846.04), + bsync.EnergyCostIndex(0.881), + ID='AllResourceTotal-Target' + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) + ), + ID='Scenario-Target' +) +target_st = bsync.Scenario.ScenarioType() +target = bsync.Target( + bsync.ReferenceCase(IDref=bench_sc['ID']), + bsync.AnnualSavingsSiteEnergy(39070.53), + bsync.AnnualSavingsCost(995), + bsync.ENERGYSTARScore(89.), +) + +# +scenarios += target_sc +target_sc += target_st +target_st += target +``` + +### Current Building Modeled Scenario +Relevant Standard 211 Sections: +- 6.1.5 & 6.1.6 + +Although not explicitly called out in Standard 211, the current building modeled scenario is implied as part of a Level 2 energy audit when doing detailed savings estimates and calculations for potential energy conservation measures. This is because when an energy and cost savings claim is made for a package of measures scenario, it needs to be _in reference_ to something, i.e., a current building modeled scenario (also often referred to as a baseline modeled scenario). The baseline modeled scenario should be interpreted as the expected performance of your building on an average or typical year. This is assuming the baseline modeled scenario is performed with TMY data, although they are likely first calibrated with AMY data. + +Since we are already using an energy model for this example and providing details for implementing a Standard 211 Level 1 energy audit, we will not go into this too much at this point. It should be addressed in future examples. + +### Package of Measures Scenario +Relevant Standard 211 Sections: +- 6.1.5 & 6.1.6 + +Standard 211 breaks out recommendations into low / no-cost (6.1.5) or capital (6.1.6). On the BuildingSync side, we don't change the data modeling between these two situations significantly, we simply change the value of the `Scenario/ScenarioType/PackageOfMeasures/CostCategory` element, while the majority of other features remain the same. +- Low / no-cost scenario: `Low-Cost or No-Cost` +- Capital scenario: `Capital` + +#### Measures + +Packages of measures first require measures to be instantiated inside the BuildingSync document in order to correctly incorporate them into the scenario. BuildingSync provides a significant number of already enumerated measures that can be used. We will first add some of these to our BuildingSync file. + +The scope of an individual measure is primarily conveyed by a few elements: +- `SystemCategoryAffected`: select one of an enumerated set of strings representing the general scope of system, e.g.. Refrigeration, Fan, Lighting, etc. +- `TechnologyCategories/TechnologyCategory/*/MeasureName`: Select a very specific measure to implement + + +```python +# A measure to modify HVAC schedules (no-cost EEM) +hvac_schedule_measure = bsync.Measure( + bsync.TypeOfMeasure( + bsync.ModificationRetrocommissions( + bsync.ModificationRetrocommissioning( + bsync.ExistingScheduleAffected(IDref=schedule_hvac['ID']), + bsync.ModifiedSchedule(IDref=schedule_hvac_new['ID']) + ) + ) + ), + bsync.SystemCategoryAffected('Air Distribution'), + bsync.TechnologyCategories( + bsync.TechnologyCategory( + bsync.OtherHVAC( + bsync.OtherHVAC.MeasureName('Other distribution') + ) + ) + ), + bsync.CustomMeasureName('Update HVAC schedule'), + bsync.LongDescription('The current HVAC schedule is set to be at fully ON fan operation during weekday from 7am - 8pm. This measure would implement a modified schedule to enable pre-cooling/pre-heating from 6am - 7am, and reduce output to 80 percent during peak time 12pm - 1pm.'), + bsync.MeasureScaleOfApplication('Individual system'), + bsync.UsefulLife(1.), + bsync.MeasureInstallationCost(0.), + bsync.MeasureMaterialCost(0.), + bsync.StartDate(date(2021,1,1)), + bsync.EndDate(date(2021,12,30)), + bsync.Recommended(True), + ID='Measure-HVAC-schedule-nocost' +) + +# A measure to upgrade the lighting system to LEDs (low-cost EEM) +led_measure = bsync.Measure( + bsync.TypeOfMeasure( + bsync.Replacements( + bsync.Replacement( + bsync.ExistingSystemReplaced(IDref=ls1['ID']), + bsync.AlternativeSystemReplacement(IDref=ls_new['ID']) + ) + ) + ), + bsync.SystemCategoryAffected('Lighting'), + bsync.TechnologyCategories( + bsync.TechnologyCategory( + bsync.LightingImprovements( + bsync.LightingImprovements.MeasureName('Retrofit with light emitting diode technologies') + ) + ) + ), + bsync.LongDescription('This measure is designed to replace all fluorescent bulbs with LEDs'), + bsync.MeasureScaleOfApplication('Individual system'), + bsync.UsefulLife(1.), + bsync.MeasureInstallationCost(50.), + bsync.MeasureMaterialCost(774.), + bsync.StartDate(date(2021,1,1)), + bsync.EndDate(date(2021,12,30)), + bsync.Recommended(True), + ID='Measure-LEDs' +) + +# A measure to upgrade the fans in the RTUs to use VFDs +# instead of simple on/off fans. +# The CFMs for each of the RTUs are around ~ 700-800cfm, +# so there is no obvious choice of fans to upgrade to vsds. +# Here, we just recommend upgrading all of them. +vsd_measure = bsync.Measure( + bsync.TypeOfMeasure( + bsync.ModificationRetrocommissions( + bsync.ModificationRetrocommissioning( + bsync.ExistingSystemAffected(IDref=fan['ID']), + bsync.ModifiedSystem(IDref=fan_new['ID']) + ) + ) + ), + # could have also used Air Distribution or Motor, this seemed ok too. + bsync.SystemCategoryAffected('Fan'), + bsync.TechnologyCategories( + bsync.TechnologyCategory( + bsync.OtherElectricMotorsAndDrives( + bsync.OtherElectricMotorsAndDrives.MeasureName('Add VSD motor controller') + ) + ) + ), + bsync.LongDescription('This measure is designed to retrofit all RTU fans with a VSD'), + bsync.MeasureScaleOfApplication('Individual system'), + bsync.UsefulLife(1.), + bsync.MeasureInstallationCost(750.), + bsync.MeasureMaterialCost(1250.), # assume $200~300 per fan + bsync.StartDate(date(2021,1,1)), + bsync.EndDate(date(2021,12,30)), + bsync.Recommended(True), + ID='Measure-VSDs' +) +``` + + +```python +measures += led_measure +measures += vsd_measure +``` + +#### POM Scenarios +Now that the measures have been added, we create three potential POM scenarios, and add the necessary attributes per Standard 211 6.1.5 and 6.1.6 +1. LEDs only +2. VSDs only +3. LEDs+VSDs + +The no-cost HVAC schedule measure is not taken into account in this example. + + +```python +pom_sc_1 = bsync.Scenario( + bsync.Scenario.ScenarioType( + bsync.PackageOfMeasures( + bsync.ReferenceCase(IDref=cbms['ID']), + bsync.MeasureIDs( + bsync.MeasureID(IDref=led_measure['ID']) + ), + bsync.CostCategory('Capital'), + bsync.AnnualSavingsSiteEnergy(35.713), + bsync.AnnualSavingsCost(772), + bsync.AnnualSavingsByFuels( + bsync.AnnualSavingsByFuel( + bsync.EnergyResource('Electricity'), + bsync.ResourceUnits('kWh'), + bsync.AnnualSavingsNativeUnits(11524.54) + ), + bsync.AnnualSavingsByFuel( + bsync.EnergyResource('Natural gas'), + bsync.ResourceUnits('MMBtu'), + bsync.AnnualSavingsNativeUnits(0.) + ) + ), + bsync.AnnualPeakElectricityReduction(3.22), + bsync.AnnualDemandSavingsCost(0), + bsync.AnnualWaterSavings(0.), + bsync.AnnualWaterCostSavings(0.), + bsync.ImplementationPeriod(1), + bsync.ImplementationPeriodCostSavings(0.), + bsync.PackageFirstCost(824.), + bsync.MVCost(0.), + bsync.OMCostAnnualSavings(0.), + bsync.EquipmentDisposalAndSalvageCosts(0.), + bsync.ProjectMarkup(0.), + bsync.FundingFromIncentives(0.), + bsync.FundingFromTaxCredits(0.), + bsync.OtherFinancialIncentives(0), # there might be incentives from utility for upgrading lighting to led + bsync.RecurringIncentives(0), + bsync.InternalRateOfReturn(0.), # for the first year the IRR is nagative (payback>1 yr) + bsync.SimplePayback(1.07), + ID='POM-LEDs' + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) + ), + ID='Scenario-POM-LEDs' +) + +pom_sc_2 = bsync.Scenario( + bsync.Scenario.ScenarioType( + bsync.PackageOfMeasures( + bsync.ReferenceCase(IDref=cbms['ID']), + bsync.MeasureIDs( + bsync.MeasureID(IDref=vsd_measure['ID']) + ), + bsync.CostCategory('Capital'), + bsync.AnnualSavingsSiteEnergy(5.175), + bsync.AnnualSavingsCost(9), + bsync.AnnualSavingsByFuels( + bsync.AnnualSavingsByFuel( + bsync.EnergyResource('Electricity'), + bsync.ResourceUnits('kWh'), + bsync.AnnualSavingsNativeUnits(207.24) + ), + bsync.AnnualSavingsByFuel( + bsync.EnergyResource('Natural gas'), + bsync.ResourceUnits('MMBtu'), + bsync.AnnualSavingsNativeUnits(4.46) + ) + ), + bsync.AnnualPeakElectricityReduction(0.42), + bsync.AnnualDemandSavingsCost(0), + bsync.AnnualWaterSavings(0.), + bsync.AnnualWaterCostSavings(0.), + bsync.ImplementationPeriod(1), + bsync.ImplementationPeriodCostSavings(0.), + bsync.PackageFirstCost(2000.), + bsync.MVCost(0.), + bsync.OMCostAnnualSavings(0.), + bsync.EquipmentDisposalAndSalvageCosts(0.), + bsync.ProjectMarkup(0.), + bsync.FundingFromIncentives(0.), + bsync.FundingFromTaxCredits(0.), + bsync.OtherFinancialIncentives(0), + bsync.RecurringIncentives(0), + bsync.InternalRateOfReturn(0.), + bsync.SimplePayback(230.15), + ID='POM-VSDs' + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) + ), + ID='Scenario-POM-VSDs' +) + +pom_sc_3 = bsync.Scenario( + bsync.Scenario.ScenarioType( + bsync.PackageOfMeasures( + bsync.ReferenceCase(IDref=cbms['ID']), + bsync.MeasureIDs( + bsync.MeasureID(IDref=led_measure['ID']), + bsync.MeasureID(IDref=vsd_measure['ID']), + ), + bsync.CostCategory('Capital'), + bsync.AnnualSavingsSiteEnergy(41.827), + bsync.AnnualSavingsCost(781), + bsync.AnnualSavingsByFuels( + bsync.AnnualSavingsByFuel( + bsync.EnergyResource('Electricity'), + bsync.ResourceUnits('kWh'), + bsync.AnnualSavingsNativeUnits(11701.62) + ), + bsync.AnnualSavingsByFuel( + bsync.EnergyResource('Natural gas'), + bsync.ResourceUnits('MMBtu'), + bsync.AnnualSavingsNativeUnits(1.89) + ) + ), + bsync.AnnualPeakElectricityReduction(4.7), + bsync.AnnualDemandSavingsCost(0), + bsync.AnnualWaterSavings(0.), + bsync.AnnualWaterCostSavings(0.), + bsync.ImplementationPeriod(1), + bsync.ImplementationPeriodCostSavings(0.), + bsync.PackageFirstCost(2824.), + bsync.MVCost(0.), + bsync.OMCostAnnualSavings(0.), + bsync.EquipmentDisposalAndSalvageCosts(0.), + bsync.ProjectMarkup(0.), + bsync.FundingFromIncentives(0.), + bsync.FundingFromTaxCredits(0.), + bsync.OtherFinancialIncentives(0), + bsync.RecurringIncentives(0), + bsync.InternalRateOfReturn(0.), + bsync.SimplePayback(3.62), + ID='POM-LEDs-VSDs' + ) + ), + bsync.LinkedPremises( + bsync.LinkedPremises.Building( + bsync.LinkedBuildingID(IDref=b1['ID']) + ) + ), + ID='Scenario-POM-LEDs-VSDs' +) +``` + + +```python +scenarios += pom_sc_1 +scenarios += pom_sc_2 +scenarios += pom_sc_3 +``` + +# Validation + +Now we need to check if everything we went through actually works? Do we have the required information for a Level 2 Audit? Head over to the [use case validator](https://buildingsync.net/validator) to find out! + +![Selection Tool](./img/UC-Selection.png) + +Use the line below to write the file to disk + + +```python +bsync_dump(root, file='example-smalloffice-level2.xml') +``` + + +You should see a green check mark for the L200 AUDIT use case! + +![Valid](./img/valid_level2.png) + diff --git a/docs/notebooks/bsync_examples/example1.xml b/docs/notebooks/bsync_examples/example-smalloffice-level1.xml similarity index 100% rename from docs/notebooks/bsync_examples/example1.xml rename to docs/notebooks/bsync_examples/example-smalloffice-level1.xml diff --git a/docs/notebooks/bsync_examples/example-smalloffice-level2.xml b/docs/notebooks/bsync_examples/example-smalloffice-level2.xml new file mode 100644 index 00000000..821b846f --- /dev/null +++ b/docs/notebooks/bsync_examples/example-smalloffice-level2.xml @@ -0,0 +1,2682 @@ + + + + + + + + + Small Office Prototype in Denver + Here we record general problems / issues identified in a walkthrough survey. +
+ + + Some address + + + Denver + CO + 80014 +
+ Commercial + Office + + 1 + 0 + 1 + 0 + true + false + + + Gross + 5500.000000 + + + + + + Conditioned + 5500.000000 + + + + + + 6500.000000 + 0.000000 + 0.213300 + 0.050000 + 2000 + 2000 + 2010 + 2020-03-01 + 2000 + +
+ Space function + Office + Office + + + Peak total occupants + 31.000000 + + + + + 40.000000 + Hours per week + + + 50.000000 + Weeks per year + + + + + Gross + 5500.000000 + + + Conditioned + 5500.000000 + + + Single zone +
+
+ Whole building + Rectangular + + + A1 + + + 909.012230 + + + + + 180.187860 + + + + + 42.086890 + + + + + B1 + + + 606.008200 + + + + + 120.125240 + + + + + 0.000000 + + + + + C1 + + + 909.012230 + + + + + 180.187860 + + + + + 0.000000 + + + + + D1 + + + 606.008200 + + + + + 120.125240 + + + + + 0.000000 + + + + + + + + 6444.999000 + Good + + + + + + + 3891.153600 + + + +
+
+ + + + + + + + + + Single zone + + + + + Packaged Unitary + Natural gas + 0.000000 + + + + 3.010000 + COP + 10311.100000 + 10311.100000 + W + Good + + + + + + + + + + 2000 + + + + + Packaged Unitary + Natural gas + 0.000000 + + + + 3.010000 + COP + 9801.300000 + 9801.300000 + W + Good + + + + + + + + + + 2000 + + + + + Packaged Unitary + Natural gas + 0.000000 + + + + 3.010000 + COP + 7858.100000 + 7858.100000 + W + Good + + + + + + + + + + 2000 + + + + + Packaged Unitary + Natural gas + 0.000000 + + + + 3.010000 + COP + 9067.800000 + 9067.800000 + W + Good + + + + + + + + + + 2000 + + + + + Packaged Unitary + Natural gas + 0.000000 + + + + 3.010000 + COP + 9855.400000 + 9855.400000 + W + Good + + + + + + + + + + 2000 + + + + + + + Packaged/unitary heat pump + Reciprocating + Single stage + + + 2.610000 + COP + 10198.900000 + W + Good + + + + + + + + + + 2000 + + + + + Packaged/unitary heat pump + Reciprocating + Single stage + + + 2.610000 + COP + 9847.200000 + W + Good + + + + + + + + + + 2000 + + + + + Packaged/unitary heat pump + Reciprocating + Single stage + + + 2.610000 + COP + 7737.100000 + W + Good + + + + + + + + + + 2000 + + + + + Packaged/unitary heat pump + Reciprocating + Single stage + + + 2.610000 + COP + 9143.800000 + W + Good + + + + + + + + + + 2000 + + + + + Packaged/unitary heat pump + Reciprocating + Single stage + + + 2.610000 + COP + 9847.200000 + W + Good + + + + + + + + + + 2000 + + + + + + + Central fan + CAV terminal box no reheat + None + + + None + Fixed + + + + + + + + + + + + + + + + 2000 + 1 + Good + + + + + Central fan + CAV terminal box no reheat + None + + + None + Fixed + + + + + + + + + + + + + + + + 2000 + 1 + Good + + + + + Central fan + CAV terminal box no reheat + None + + + None + Fixed + + + + + + + + + + + + + + + + 2000 + 1 + Good + + + + + Central fan + CAV terminal box no reheat + None + + + None + Fixed + + + + + + + + + + + + + + + + 2000 + 1 + Good + + + + + Central fan + CAV terminal box no reheat + None + + + None + Fixed + + + + + + + + + + + + + + + + 2000 + 1 + Good + + + + + + Single + Good + + + + + Single + Good + + + + + Single + Good + + + + + Single + Good + + + + + Single + Good + + + + + + Digital + + +
+ + + + + +
+ + + + + + + + T8 + + + Standard Electronic + + 0.200000 + + 100.000000 + 5.500000 + 32.000000 + 4 + 1.000000 + 43 + false + + + + + + + Programmable + + + + false + +
+ + + + + +
+ + + + + + T12 + + + Standard Electronic + 100.000000 + 1.582575 + 316.516000 + 1 + 1.000000 + 5 + true + + + + + + + Programmable + + + + false + +
+ + + + + +
+ + + + + + LED + + + Standard Electronic + + 0.100000 + + 100.000000 + 2.752000 + 16.000000 + 4 + 1.000000 + 43 + false + + + + + + + Photocell + Continuous + + + + false + +
+ + + + + +
+ + + + + + + + + + + 40.000000 + 123.000000 + + + Notes + + 1 + 3.600000 + Continuous + 123.000000 + 1.870180 + + Looped + Thermal Efficiency + 1.000000 + 40.000000 + 140.000000 + 1950.520000 + 11722.840000 + W + + + + + + + + + + 2000 + Electricity + Good + + + + +
+ +
+ + 1 + + + + + 0.536000 + 880.000000 + 880.000000 + Constant Volume + + + + + + 0.536000 + 872.000000 + 872.000000 + Variable Volume + + + + + + 0.536000 + 836.000000 + 836.000000 + Constant Volume + + + + + + 0.536000 + 830.000000 + 830.000000 + Variable Volume + + + + + + 0.536000 + 671.000000 + 671.000000 + Constant Volume + + + + + + 0.536000 + 664.000000 + 664.000000 + Variable Volume + + + + + + 0.536000 + 774.000000 + 774.000000 + Constant Volume + + + + + + 0.536000 + 766.000000 + 766.000000 + Variable Volume + + + + + + 0.536000 + 841.000000 + 841.000000 + Constant Volume + + + + + + 0.536000 + 833.000000 + 833.000000 + Variable Volume + + + + + + + + Wood frame + 0.547000 + + + + + Wood frame + 4.706000 + + + + + + + + Vinyl + Clear uncoated + Single pane + 3.241000 + 0.391000 + 0.391000 + + + + + + Vinyl + Low e + Triple pane + 0.300000 + 0.391000 + 0.391000 + + + + + Insulated metal + 0.500000 + + + Steel + 2.839000 + + + + + + + + 0.345000 + + + + Concrete poured + + + + + Miscellaneous Electric Load + 0.630000 + +
+ + + + + +
+ + + + + + Notes on test + Tight + 0.151000 + ACHnatural + Blower door + +
+ +
+ + + + + + Notes on test + +
+ +
+ + + + + + + + + Weekday + Occupied + 00:00:00 + 06:00:00 + 0.000000 + + + Weekday + Occupied + 06:00:00 + 07:00:00 + 11.000000 + + + Weekday + Occupied + 07:00:00 + 08:00:00 + 21.000000 + + + Weekday + Occupied + 08:00:00 + 12:00:00 + 100.000000 + + + Weekday + Occupied + 12:00:00 + 13:00:00 + 53.000000 + + + Weekday + Occupied + 13:00:00 + 17:00:00 + 100.000000 + + + Weekday + Occupied + 17:00:00 + 18:00:00 + 32.000000 + + + Weekday + Occupied + 18:00:00 + 22:00:00 + 11.000000 + + + Weekday + Occupied + 22:00:00 + 23:00:00 + 5.000000 + + + Weekday + Occupied + 23:00:00 + 23:59:59 + 0.000000 + + + Weekend + Occupied + 00:00:00 + 23:59:59 + 0.000000 + + + Holiday + Occupied + 00:00:00 + 23:59:59 + 0.000000 + + + + + + +
+ +
+ + + + + + Weekday + Lighting + 00:00:00 + 05:00:00 + 18.000000 + + + Weekday + Lighting + 05:00:00 + 07:00:00 + 23.000000 + + + Weekday + Lighting + 07:00:00 + 08:00:00 + 42.000000 + + + Weekday + Lighting + 08:00:00 + 12:00:00 + 90.000000 + + + Weekday + Lighting + 12:00:00 + 13:00:00 + 80.000000 + + + Weekday + Lighting + 13:00:00 + 17:00:00 + 90.000000 + + + Weekday + Lighting + 17:00:00 + 18:00:00 + 61.000000 + + + Weekday + Lighting + 18:00:00 + 20:00:00 + 42.000000 + + + Weekday + Lighting + 20:00:00 + 22:00:00 + 32.000000 + + + Weekday + Lighting + 22:00:00 + 23:00:00 + 23.000000 + + + Weekday + Lighting + 23:00:00 + 23:59:59 + 18.000000 + + + Weekend + Lighting + 00:00:00 + 23:59:59 + 18.000000 + + + Holiday + Lighting + 00:00:00 + 23:59:59 + 18.000000 + + + + + + + + + + + + Weekday + Miscellaneous equipment + 00:00:00 + 08:00:00 + 50.000000 + + + Weekday + Miscellaneous equipment + 08:00:00 + 12:00:00 + 100.000000 + + + Weekday + Miscellaneous equipment + 12:00:00 + 13:00:00 + 94.000000 + + + Weekday + Miscellaneous equipment + 13:00:00 + 17:00:00 + 100.000000 + + + Weekday + Miscellaneous equipment + 17:00:00 + 18:00:00 + 50.000000 + + + Weekday + Miscellaneous equipment + 18:00:00 + 23:59:59 + 20.000000 + + + Weekend + Miscellaneous equipment + 00:00:00 + 23:59:59 + 20.000000 + + + Holiday + Miscellaneous equipment + 00:00:00 + 23:59:59 + 20.000000 + + + + + + + + + + + + Weekday + HVAC equipment + 00:00:00 + 06:00:00 + 0.000000 + + + Weekday + HVAC equipment + 06:00:00 + 19:00:00 + 100.000000 + + + Weekday + HVAC equipment + 19:00:00 + 23:59:59 + 0.000000 + + + Weekend + HVAC equipment + 00:00:00 + 23:59:59 + 0.000000 + + + Holiday + HVAC equipment + 00:00:00 + 23:59:59 + 0.000000 + + + + + + + + + + + + Weekday + HVAC equipment + 00:00:00 + 06:00:00 + 0.000000 + + + Weekday + HVAC equipment + 06:00:00 + 07:00:00 + 60.000000 + + + Weekday + HVAC equipment + 07:00:00 + 12:00:00 + 100.000000 + + + Weekday + HVAC equipment + 12:00:00 + 13:00:00 + 80.000000 + + + Weekday + HVAC equipment + 13:00:00 + 18:00:00 + 100.000000 + + + Weekday + HVAC equipment + 18:00:00 + 20:00:00 + 60.000000 + + + Weekday + HVAC equipment + 20:00:00 + 23:59:59 + 0.000000 + + + Weekend + HVAC equipment + 00:00:00 + 23:59:59 + 0.000000 + + + Holiday + HVAC equipment + 00:00:00 + 23:59:59 + 0.000000 + + + + + + + + + + + + + + + + + + + + Lighting + + + + Retrofit with light emitting diode technologies + + + + Individual system + This measure is designed to replace all fluorescent bulbs with LEDs + 1.000000 + 50.000000 + 774.000000 + true + 2021-01-01 + 2021-12-30 + + + + + + + + + + + Fan + + + + Add VSD motor controller + + + + Individual system + This measure is designed to retrofit all RTU fans with a VSD + 1.000000 + 750.000000 + 1250.000000 + true + 2021-01-01 + 2021-12-30 + + + + + + + + + + + + + + + + Electricity + This is required to document irregularities in monthly energy patterns (Std 211 6.1.2.1.j). No irregularities found. + kWh + All end uses + 67334.150000 + 229.753657 + + + + + + + + + + + + + + + kW + 26.040000 + 26.040000 + 4613.820000 + + + + + + Natural gas + No irregularities in monthly energy consumption found. + MMBtu + All end uses + 8.720000 + 8.720000 + + + + + + + + + + + + + + + 540.830000 + + + + + + Electricity + kWh + Interior lighting + 28.705000 + 20062.690000 + 68.453898 + + + + Electricity + kWh + Heating + 6.722000 + 4698.230000 + 16.030361 + + + + Electricity + kWh + Cooling + 8.769000 + 6128.870000 + 20.911704 + + + + Electricity + kWh + Domestic hot water + 10.281000 + 7185.370000 + 24.516482 + + + + Electricity + kWh + Plug load + 21.379000 + 14942.150000 + 50.982616 + + + + + + Total + Energy + 2019-01-01T00:00:00 + 2019-02-01T00:00:00 + 31 + Day + Month + 5933.100000 + + + + Total + Energy + 2019-02-01T00:00:00 + 2019-03-01T00:00:00 + 28 + Day + Month + 5446.100000 + + + + Total + Energy + 2019-03-01T00:00:00 + 2019-04-01T00:00:00 + 31 + Day + Month + 5736.490000 + + + + Total + Energy + 2019-04-01T00:00:00 + 2019-05-01T00:00:00 + 30 + Day + Month + 4980.500000 + + + + Total + Energy + 2019-05-01T00:00:00 + 2019-06-01T00:00:00 + 31 + Day + Month + 5187.210000 + + + + Total + Energy + 2019-06-01T00:00:00 + 2019-07-01T00:00:00 + 30 + Day + Month + 5842.950000 + + + + Total + Energy + 2019-07-01T00:00:00 + 2019-08-01T00:00:00 + 31 + Day + Month + 5801.730000 + + + + Total + Energy + 2019-08-01T00:00:00 + 2019-09-01T00:00:00 + 31 + Day + Month + 6220.160000 + + + + Total + Energy + 2019-09-01T00:00:00 + 2019-10-01T00:00:00 + 30 + Day + Month + 5682.870000 + + + + Total + Energy + 2019-10-01T00:00:00 + 2019-11-01T00:00:00 + 31 + Day + Month + 5571.930000 + + + + Total + Energy + 2019-11-01T00:00:00 + 2019-12-01T00:00:00 + 30 + Day + Month + 5525.150000 + + + + Total + Energy + 2019-12-01T00:00:00 + 2020-01-01T00:00:00 + 31 + Day + Month + 5405.940000 + + + + Total + Energy + 2019-01-01T00:00:00 + 2019-02-01T00:00:00 + 31 + Day + Month + 1.720000 + + + + Total + Energy + 2019-02-01T00:00:00 + 2019-03-01T00:00:00 + 28 + Day + Month + 1.250000 + + + + Total + Energy + 2019-03-01T00:00:00 + 2019-04-01T00:00:00 + 31 + Day + Month + 0.410000 + + + + Total + Energy + 2019-04-01T00:00:00 + 2019-05-01T00:00:00 + 30 + Day + Month + 0.430000 + + + + Total + Energy + 2019-05-01T00:00:00 + 2019-06-01T00:00:00 + 31 + Day + Month + 0.010000 + + + + Total + Energy + 2019-06-01T00:00:00 + 2019-07-01T00:00:00 + 30 + Day + Month + 0.000000 + + + + Total + Energy + 2019-07-01T00:00:00 + 2019-08-01T00:00:00 + 31 + Day + Month + 0.000000 + + + + Total + Energy + 2019-08-01T00:00:00 + 2019-09-01T00:00:00 + 31 + Day + Month + 0.000000 + + + + Total + Energy + 2019-09-01T00:00:00 + 2019-10-01T00:00:00 + 30 + Day + Month + 0.000000 + + + + Total + Energy + 2019-10-01T00:00:00 + 2019-11-01T00:00:00 + 31 + Day + Month + 0.200000 + + + + Total + Energy + 2019-11-01T00:00:00 + 2019-12-01T00:00:00 + 30 + Day + Month + 0.400000 + + + + Total + Energy + 2019-12-01T00:00:00 + 2020-01-01T00:00:00 + 31 + Day + Month + 4.300000 + + + + Peak + On-peak + Power + 2019-01-01T00:00:00 + 2019-02-01T00:00:00 + 31 + Day + Month + 23.580000 + + + + Peak + On-peak + Power + 2019-02-01T00:00:00 + 2019-03-01T00:00:00 + 28 + Day + Month + 25.380000 + + + + Peak + On-peak + Power + 2019-03-01T00:00:00 + 2019-04-01T00:00:00 + 31 + Day + Month + 26.040000 + + + + Peak + On-peak + Power + 2019-04-01T00:00:00 + 2019-05-01T00:00:00 + 30 + Day + Month + 24.450000 + + + + Peak + On-peak + Power + 2019-05-01T00:00:00 + 2019-06-01T00:00:00 + 31 + Day + Month + 17.030000 + + + + Peak + On-peak + Power + 2019-06-01T00:00:00 + 2019-07-01T00:00:00 + 30 + Day + Month + 22.710000 + + + + Peak + On-peak + Power + 2019-07-01T00:00:00 + 2019-08-01T00:00:00 + 31 + Day + Month + 22.010000 + + + + Peak + On-peak + Power + 2019-08-01T00:00:00 + 2019-09-01T00:00:00 + 31 + Day + Month + 21.810000 + + + + Peak + On-peak + Power + 2019-09-01T00:00:00 + 2019-10-01T00:00:00 + 30 + Day + Month + 20.630000 + + + + Peak + On-peak + Power + 2019-10-01T00:00:00 + 2019-11-01T00:00:00 + 31 + Day + Month + 21.870000 + + + + Peak + On-peak + Power + 2019-11-01T00:00:00 + 2019-12-01T00:00:00 + 30 + Day + Month + 21.630000 + + + + Peak + On-peak + Power + 2019-12-01T00:00:00 + 2020-01-01T00:00:00 + 31 + Day + Month + 21.780000 + + + + Load factor + Power + 2019-01-01T00:00:00 + 2019-02-01T00:00:00 + 31 + Day + Month + 0.373000 + + + + Load factor + Power + 2019-02-01T00:00:00 + 2019-03-01T00:00:00 + 28 + Day + Month + 0.394000 + + + + Load factor + Power + 2019-03-01T00:00:00 + 2019-04-01T00:00:00 + 31 + Day + Month + 0.390000 + + + + Load factor + Power + 2019-04-01T00:00:00 + 2019-05-01T00:00:00 + 30 + Day + Month + 0.358000 + + + + Load factor + Power + 2019-05-01T00:00:00 + 2019-06-01T00:00:00 + 31 + Day + Month + 0.374000 + + + + Load factor + Power + 2019-06-01T00:00:00 + 2019-07-01T00:00:00 + 30 + Day + Month + 0.386000 + + + + Load factor + Power + 2019-07-01T00:00:00 + 2019-08-01T00:00:00 + 31 + Day + Month + 0.369000 + + + + Load factor + Power + 2019-08-01T00:00:00 + 2019-09-01T00:00:00 + 31 + Day + Month + 0.372000 + + + + Load factor + Power + 2019-09-01T00:00:00 + 2019-10-01T00:00:00 + 30 + Day + Month + 0.373000 + + + + Load factor + Power + 2019-10-01T00:00:00 + 2019-11-01T00:00:00 + 31 + Day + Month + 0.354000 + + + + Load factor + Power + 2019-11-01T00:00:00 + 2019-12-01T00:00:00 + 30 + Day + Month + 0.380000 + + + + Load factor + Power + 2019-12-01T00:00:00 + 2020-01-01T00:00:00 + 31 + Day + Month + 0.362000 + + + + Cost + Cost + 2019-01-01T00:00:00 + 2019-02-01T00:00:00 + 31 + Day + Month + 332.160000 + + + + Cost + Cost + 2019-02-01T00:00:00 + 2019-03-01T00:00:00 + 28 + Day + Month + 306.290000 + + + + Cost + Cost + 2019-03-01T00:00:00 + 2019-04-01T00:00:00 + 31 + Day + Month + 321.720000 + + + + Cost + Cost + 2019-04-01T00:00:00 + 2019-05-01T00:00:00 + 30 + Day + Month + 281.540000 + + + + Cost + Cost + 2019-05-01T00:00:00 + 2019-06-01T00:00:00 + 31 + Day + Month + 292.530000 + + + + Cost + Cost + 2019-06-01T00:00:00 + 2019-07-01T00:00:00 + 30 + Day + Month + 534.100000 + + + + Cost + Cost + 2019-07-01T00:00:00 + 2019-08-01T00:00:00 + 31 + Day + Month + 530.450000 + + + + Cost + Cost + 2019-08-01T00:00:00 + 2019-09-01T00:00:00 + 31 + Day + Month + 567.490000 + + + + Cost + Cost + 2019-09-01T00:00:00 + 2019-10-01T00:00:00 + 30 + Day + Month + 519.930000 + + + + Cost + Cost + 2019-10-01T00:00:00 + 2019-11-01T00:00:00 + 31 + Day + Month + 312.970000 + + + + Cost + Cost + 2019-11-01T00:00:00 + 2019-12-01T00:00:00 + 30 + Day + Month + 310.490000 + + + + Cost + Cost + 2019-12-01T00:00:00 + 2020-01-01T00:00:00 + 31 + Day + Month + 304.150000 + + + + Cost + Cost + 2019-01-01T00:00:00 + 2019-02-01T00:00:00 + 31 + Day + Month + 46.690000 + + + + Cost + Cost + 2019-02-01T00:00:00 + 2019-03-01T00:00:00 + 28 + Day + Month + 45.930000 + + + + Cost + Cost + 2019-03-01T00:00:00 + 2019-04-01T00:00:00 + 31 + Day + Month + 44.550000 + + + + Cost + Cost + 2019-04-01T00:00:00 + 2019-05-01T00:00:00 + 30 + Day + Month + 44.580000 + + + + Cost + Cost + 2019-05-01T00:00:00 + 2019-06-01T00:00:00 + 31 + Day + Month + 43.900000 + + + + Cost + Cost + 2019-06-01T00:00:00 + 2019-07-01T00:00:00 + 30 + Day + Month + 43.880000 + + + + Cost + Cost + 2019-07-01T00:00:00 + 2019-08-01T00:00:00 + 31 + Day + Month + 43.880000 + + + + Cost + Cost + 2019-08-01T00:00:00 + 2019-09-01T00:00:00 + 31 + Day + Month + 43.880000 + + + + Cost + Cost + 2019-09-01T00:00:00 + 2019-10-01T00:00:00 + 30 + Day + Month + 43.880000 + + + + Cost + Cost + 2019-10-01T00:00:00 + 2019-11-01T00:00:00 + 31 + Day + Month + 44.210000 + + + + Cost + Cost + 2019-11-01T00:00:00 + 2019-12-01T00:00:00 + 30 + Day + Month + 44.530000 + + + + Cost + Cost + 2019-12-01T00:00:00 + 2020-01-01T00:00:00 + 31 + Day + Month + 50.920000 + + + + + + 238473.656550 + 43.358800 + 737088.900000 + 134.000000 + 238473.656550 + 43.358800 + 238.473657 + 0.000000 + 0.000000 + 0.000000 + 4952.480000 + 0.900000 + + + + + + + + + + + + + + 2022-06-01 + + + Portfolio Manager + 2019 + 80.000000 + + + + + 238473.656550 + 43.358800 + 4952.480000 + + + + + + + + + + + + + 39070.530000 + 995 + 89.000000 + + + + + 190348.600000 + 34.600000 + 4846.040000 + 0.881000 + + + + + + + + + + + + + + + + Capital + 35.713000 + 772 + + + Electricity + kWh + 11524.540000 + + + Natural gas + MMBtu + 0.000000 + + + 3.220000 + 0 + 0.000000 + 0.000000 + 1 + 824.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0 + 0 + 1.070000 + 0.000000 + + + + + + + + + + + + + + + + Capital + 5.175000 + 9 + + + Electricity + kWh + 207.240000 + + + Natural gas + MMBtu + 4.460000 + + + 0.420000 + 0 + 0.000000 + 0.000000 + 1 + 2000.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0 + 0 + 230.150000 + 0.000000 + + + + + + + + + + + + + + + + + Capital + 41.827000 + 781 + + + Electricity + kWh + 11701.620000 + + + Natural gas + MMBtu + 1.890000 + + + 4.700000 + 0 + 0.000000 + 0.000000 + 1 + 2824.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0.000000 + 0 + 0 + 3.620000 + 0.000000 + + + + + + + + + + Level 2: Energy Survey and Analysis + + + + + + + + + --06-01 + --09-30 + --06-01 + --09-30 + 0.088520 + 0.000000 + + + --01-01 + --05-31 + --01-01 + --05-31 + 0.053140 + 0.000000 + + + --10-01 + --12-31 + --10-01 + --12-31 + 0.053140 + 0.000000 + + + + + https://www.xcelenergy.com/company/rates_and_regulations/rates/rate_books + 16.880000 + + + 12345 + Xcel Energy + + Some-meter-ID + + some-account-number + Building Owner + + + + + + + + + --01-01 + --12-31 + 0.163600 + + + + + https://www.xcelenergy.com/company/rates_and_regulations/rates/rate_books + 43.880000 + + + Xcel Energy + + Some-meter-ID + + some-other-account-number + Building Owner + + + + + + + + + + + + + + Owner + + The dude + Some big company + + + 123-456-7890 + + + + + the.dude@somebigco.net + + + + + + Energy Auditor + + The lady + Auditeers + + + 123-456-7890 + + + + + the.lady@the-three-auditeers.com + + + + + + + diff --git a/docs/notebooks/bsync_examples/img/ESPM.png b/docs/notebooks/bsync_examples/img/ESPM.png new file mode 100644 index 00000000..224b3d7a Binary files /dev/null and b/docs/notebooks/bsync_examples/img/ESPM.png differ diff --git a/docs/notebooks/bsync_examples/img/valid_level2.png b/docs/notebooks/bsync_examples/img/valid_level2.png new file mode 100644 index 00000000..b80fe678 Binary files /dev/null and b/docs/notebooks/bsync_examples/img/valid_level2.png differ