Analyses
There are several analyses that can be run on properties. Expand the sections below to learn more about each analysis.
Overview
Analysis Overview¶
There are currently six different types of Analyses available in SEED:
- BSyncr
- Makes a Building Sync file from the property data in SEED to be used with the NMEC (Normalized Metered Energy Consumption) program
- Algorithms are based on methods in this Github repository NMECR Github Repo
- BETTER
- Runs a BETTER analysis from the property data in SEED BETTER web Tool
- EUI
- Calculates the EUI of a property based on the meter data and the gross floor area
- Average Annual CO2
- Calculates the CO2 emissions of a property based on the meter data and the eGRID region (which is based on the location of the property)
- Energy Equity & Environmental Justice (EEEJ)
- The Energy Equity & Environmental Justice analysis retrieves EEEJ information and indicators for your properties from various sources
- Element Statistics
Generating an Analysis¶
- In the Property List, select the properties you want to perform an analysis on
- Select Run Analysis from the Actions menu choice
- Add an Analysis Name and select the Analysis Type
-
Depending on the analysis type, there will be various other parameters to set (see the sections below for each Analysis Type details)
-
Start the Analysis
- Using the left Navigation bar, go to the Analyses section of SEED to see the results
BSyncr" Analysis
Bsyncr Analysis¶
the BSyncr analysis option makes a Building Sync file from the property data in SEED to be used with the NMEC (Normalized Metered Energy Consumption) program. Algorithms are based on methods in this Github repository NMECR Github Repo
Setting up the Analysis¶
- In the Property List, select the properties you want to perform an analysis on
- Select Run Analysis from the Actions menu choice
- Add an Analysis Name and set Type = BSyncr
Running the Analysis¶
- Click the “Create Analysis” button to start the analysis
- Go to the Analyses page (from the left Navigation bar) to see the status of the analysis
Viewing the Analysis Results¶
On the Analyses page, it is possible to click on the BSyncr analysis name, and see the individual analyses, and then click on the Run IDs for each property to see the details for that property.
BETTER Analysis
BETTER Analysis¶
The Building Efficiency Targeting Tool for Energy Retrofits (BETTER) is a software toolkit that enables building operators to quickly and easily identify the most cost-saving energy efficiency measures in buildings and portfolios using readily available building and energy data. For more details, see the BETTER website.
BETTER can be used to quickly assess the potential energy savings in a building, which then allows users to filter for the buildings with the hightest potential savings, and target those buildings for a more detailed energy audit.
It is possible to run BETTER from the SEED Property Inventory List view, and then view the results.
Analysis Pre-requisites¶
In order to run a BETTER analysis from SEED on a building, the following data must be imported into the Property Inventory
Data mapping on import¶
Several fields must be properly mapped when imported into SEED in order to have the correct information for a BETTER analysis.
Property Type The Property Type must be mapped (for example from the ENERGY STAR Portfolio Manager field called "Property Type - Self Selected") and must be set to a "Space Type" recognized by BETTER. See the BETTER FAQ web page, Building Spaces Types section section for the latest space types, as new types are added frequently.
Address Data The Address data for the property must be mapped properly on import, according to the following fields, in order to correctly set the location and weather data that BETTER will use for the analysis.
- 'Address Line 1' field
- 'City' and 'State' fields OR 'Postal Code' field
Monthly meter data¶
- 12 months (or more) of consecutive meter data, for either gas or electricity, or both. This data is available from ENERGY STAR Portfolio Manager, which is one of the easiest methods for importing the data into SEED.
BETTER account settings¶
When a BETTER account is created, an API token can be generated in the "My Profile" section of the BETTER account. This is used in SEED to connect to BETTER in the background to run a BETTER analysis on a property in SEED.
In SEED, this API token is then entered into the Organizations/Settings in the "BETTER Analysis API Key" section
Running the Analysis¶
-
In the Inventory List, select one or more properties on which you want to perform a BETTER analysis, and select ‘Run Analysis’ from the Actions dropdown menu
-
The Run Analysis dialog box will appear. Add a descriptive name for the current analysis, and set Type to BETTER
-
Setting Type to BETTER causes more settings to be displayed.
- When all the settings have been properly defined, click the Create Analysis button to start the analysis running. Clicking on the Analyses navigation button will go to the Analyses page, where the currently running analysis is shown. The Run Status column shows the progress of the analyses
- Viewing the BETTER results On the Analyses page, click on the Analysis Name which will then display the results for each individual property.
SEED will display the reports in the same way as they would be displayed in BETTER. Click the Run ID link to see the reports
Clicking on the Property link will display the Property Detail page for that property with the BETTER Analysis details added
One the Property Detail page, clicking on the Analyses link will show all the analyses for this property
SEED also saves many of the BETTER results in fields, which can then be added to the results display in both the Property List and Property Detail views
EUI Analysis
EUI Analysis¶
Setting up the Analysis¶
- In the Property List, select the properties you want to perform an analysis on
- Select Run Analysis from the Actions menu choice
- Add an Analysis Name and set Type = EUI
Running the Analysis¶
- Click the “Create Analysis” button to start the analysis
- Go to the Analyses page to see the status of the analysis
Viewing the Analysis Results¶
On the Analyses page, it is possible to click on the EUI analysis name, and see the individual analyses
Then click on the Run IDs for each property to see the details for that property.
In the Property List view, the field Analysis EUI is added to show the calculated value.
If the value is blank, it means that there was not meter data to calculate the value
Average Annual CO2 Analysis
Average Annual CO2 Analysis¶
Data Import¶
- In the Property data being imported to SEED, for a CO2 analysis the following must be added
- eGRID Subregion Code
- Find the eGRID Subregion definitions here eGRID Subregion Codes
- eGRID Subregion Code
Setting up the Analysis¶
- In the Property List, select the properties you want to perform an analysis on
- Select Run Analysis from the Actions menu choice
- Add an Analysis Name and set Type = Average Annual CO2
Running the Analysis¶
- Click the “Create Analysis” button to start the analysis
- Go to the Analyses page (from the left Navigation bar) to see the status of the analysis
Viewing the Analysis Results¶
On the Analyses page, it is possible to click on the CO2 analysis name, and see the individual analyses
Then click on the Run ID or the Property link for each property to see the details for that property.
In the Property List view, the fields “Average Annual CO2” and “Average Annual CO2 Coverage” contain the CO2 results in the Inventory Property List View.
Energy Equity & Environmental Justice (EEEJ) Analysis
Energy Equity & Environmental Justice (EEEJ) Analysis¶
The Energy Equity & Environmental Justice analysis retrieves EEEJ information and indicators for your properties from various sources including:
- The Climate and Economic Justice Screening Tool
- Environmental Justice Screening and Mapping Tool (EJScreen)
- The U.S. Department of Housing and Urban Development
Analysis Pre-requisites¶
The analysis requires certain data to be available in SEED in order to run successfully. The name of these fields is important at this time.
- 'Address Line 1' field
- 'City' and 'State' fields OR 'Postal Code' field
- Optional: 'Latitude' and 'Longitude' from geocoded property
The analysis workflow uses the Census geocoder API to retrieve each property's census tract based on the Address Line 1 + either City/State or Postal Code information. If the property has already been geocoded, this information will instead be used to determine the census tract.
Note that the census geocoder API is a bit slow. Selecting less than 20 properties at a time for teh analysis or geocoding the properties with the MapQuest API prior to running the analysis is recommended.
Once the census tract is determined
Running the Analysis¶
-
First select one or more properties on the inventory list page and then choose ‘Run Analysis’ from the Actions dropdown menu:
-
In the modal window that will appear, name your analysis and select “Energy Equity & Environmental Justice (EEEJ)” as the Type of analysis from the dropdown menu:
-
Messages indicating an error or a successful analysis creation will be displayed in the top right corner of the page. You can click the link in the message at the top right of the screen “Click here to view your analyses”. Or you can navigate to the Analyses page from the left navigation menu.
-
On the Analyses page you can see a list of analyses run and their status:
-
Click on the analysis name to access more details about the analysis. You can read a small description of the analysis explaining where the data came from at the top of the page. To see details about a specific property, click on the run ID next to the property:
Details for a property include:
- Latitude, Longitude, and Census Tract retrieved from the Census Geocoder service
- Whether a property is classified as disadvantaged (DAC) according to the CEJST data
- Whether a property is low income according to CEJST data
- Whether a property is classified as having an energy burden and being low income according to CEJST data
- The percentile of energy burden according to CEJST data
- The share of neighboring disadvantaged tracts according to CEJST data
- The number of affordable housing locations in the identified census tract according to HUD datasets on multi-family assisted housing and public development housing.
- A link to the EJ screen report generated for a 1-mile area around the property
An example EJ Screen report:
-
As part of the analysis, the result fields above (except for the EJ Screen Report Link) have been saved directly to each property:
-
Additionally, an Analysis "Card" is saved at the top of the individual Property Detail page (note that this shows only the last analysis run, but all analyses can be accessed from the Analyses menu).
-
The disadvantaged census tracts can be visualized on the map page (the areas with blue shading):
Element Statistics Analysis
Element Statistics Analysis¶
This Analysis provides aggregation values of the available Elements that exist on the Property Details page for a property.
There are two different types of aggregations that will be generated:
-
The analysis will count the number of Component_SubTypes that equal “D.D.C. Control Panel”. This will create a new field called “Number of D.D.C. Control Panels”. This field will be zero if there are no Component_SubTypes equal to “D.D.C Control Panel” in the Elements table for a property.
-
The analysis will calculate the aggregate Condition Index of the Scope 1 Uniformat Categories listed below as an average. This value will then create new fields called “DRINKING FOUNTAINS & COOLERS CI”, “DOMESTIC WATER EQUIPMENT CI”, etc. This field will be blank if there are missing Uniformat categories for a property. The Uniformat categories are listed below.
Uniformat Category |
---|
DRINKING FOUNTAINS & COOLERS |
DOMESTIC WATER EQUIPMENT |
GAS SUPPLY SYSTEM |
STEAM SUPPLY SYSTEM (FROM CENTRAL PLANT) |
OTHER ENERGY SUPPLY |
BOILERS |
FURNACES |
FUEL-FIRED UNIT HEATERS |
AUXILIARY EQUIPMENT |
OTHER HEAT GENERATING SYSTEMS |
CHILLED WATER SYSTEMS |
DIRECT EXPANSION SYSTEMS |
OTHER COOLING GENERATING SYSTEMS |
AIR HANDLING UNITS |
UNIT VENTILATORS |
UNIT HEATERS |
PACKAGE UNITS |
OTHER TERMINAL & PACKAGE UNITS |
REFRIGERATION SYSTEMS |
OTHER SPECIAL MECHANICAL SYSTEMS |
Property elements functionality is under development.
Building Upgrade Recommendation Analysis
Building Upgrade Recommendation Analysis¶
The Building Upgrade Recommendation Analysis is a workflow that can be used to identify what types of upgrades could be performed on selected buildings based on specific parameters such as year built, gross floor area, EUI, etc. Buildings can then be prioritized based on the results of the analysis.
The workflow implemented is depicted in the following diagram:
The configurable parameters are defined as:
- Total EUI Goal - The Total EUI Goal for the building (including Electricity, Gas, Etc.)
- Year Built Threshold - The year built to use as a comparison threshold
- Poor Actual to Benchmark EUI Ratio - The poor ratio of Total EUI to Benchmark Total EUI value to use. Ratio = Total EUI/Benchmark EUI
- Fair Actual to Benchmark EUI Ratio - The fair ratio of Total EUI to Benchmark Total EUI value to use. Ratio = Total EUI/Benchmark EUI
- Building Square Footage Threshold - The gross square footage to use as a comparison threshold
- Fossil Fuel EUI Goal - The Fossil Fuel EUI Goal for the building
- Fossil Fuel-Fired Equipment RSL Threshold - The remaining service life (RSL) value to use for your fossil fuel-fired equipment as a comparison threshold in the calculations.
- Condition Index Threshold - The condition index to use as a comparison threshold
Analysis Pre-requisites¶
The analysis requires certain data to be available in SEED in order to run successfully:
- Year Built
- Gross Floor Area
- Total Building EUI
- Building Gas EUI
- Building Electricity EUI
- Building actual energy use
- ASHRAE Electricity EUI Target
- ASHRAE Gas EUI Target
- Condition Index of the Building
- Whether a building has a Building Automation System (BAS) - represented by counting the elements of type 'D.D.C Control Panel'
- The fossil fuel-fired element with the lowest remaining service life
The analysis will allow a user to select which fields to use for the information above, with the exception of "Year Built" and "Gross Floor Area": the canonical SEED fields "Year Built" and "Gross Floor Area" are automatically used to capture this information.
Running the Analysis¶
-
From the inventory page, select the properties in the table that you want to run the analysis on
-
From the Actions dropdown menu, select "Run an Analysis"
-
In the Run an Analysis modal, enter the name of the analysis and select "Building Upgrade Recommendation" as the type
-
Once the type is selected, the modal will expand with options to set the configurable thresholds for the workflow. Fill out these values and click 'Create Analysis'
-
The analysis will be created and a link will appear in the top right corner to take you directly to the analysis page. You can also access the Analyses from the "Analysis" left navigation menu.
-
On the analysis page you can see details about the analysis, a list of properties that were run, and links to see individual results.
-
On the individual property analysis results page, you can see similar information related to the configuration details and results.
-
This analysis adds the field 'Building Upgrade Recommendation' to the analysis.
The values entered in this field can be used to prioritize your buildings list. (For example, by filtering the inventory list by 'Deep Energy Retrofit' and labeling the resulting list of buildings with a particular label.) As shown in the diagram above, the possible values for this field are:
- Deep Energy Retrofit
- Equipment Replacement
- Re-tuning
- No DER Project Recommended
- Missing Data