Skip to content

Commit

Permalink
Merge pull request #73 from SEED-platform/eo-compliance
Browse files Browse the repository at this point in the history 
eo-compliance
  • Loading branch information
@kflemin
kflemin authored Jan 24, 2025
2 parents dd44a0c + fc9b3e6 commit d804532
Show file tree
Hide file tree
Showing 4 changed files with 3 additions and 123 deletions.
2 changes: 0 additions & 2 deletions docs/references.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,6 @@

## Publications

* Long, N., Fleming, K., Langlois-Romero, I., Henze, G. P., Applegate, S. (2024). ["Equitable Energy Metrics for Integration into Building Performance Standard Tracking Platforms."](./resources/SimBuild2024_SEED_EEEJ.pdf). In IBPSA-USA SimBuild 2024. Denver, CO.

* Bugnion, V., Long, N., Mitchell, R., Bergmann, H., Swindler, A., Beers, E. (2022). ["Building Performance Standards to Drive Market Transformation"](./resources/Bugnion-2022-aceee.pdf). 2022 ACEEE Summer Study on Energy Efficiency in Buildings.

* Long, N., Swindler, A., Bergmann, H., Reagan, A., Held, A., & Longley, J. (2020). ["Standardizing City Benchmarking and Reporting: Use Cases in Consolidating Building Data with SEED"](./resources/Long-2020-Standardizing_City_Benchmarking.pdf), 2020 ACEEE Summer Study on Energy Efficiency in Buildings.
Expand Down
50 changes: 0 additions & 50 deletions docs/release_notes.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -53,56 +53,6 @@ If you have any questions about releases or changes to the program, please conta

## New Features

### Analyses

#### EEEJ -- Energy Equity and Environmental Justice

SEED now has an Analyses feature that will show buildings that are in disadvantaged communities using data from:

- US Census Bureau census tract data
- [Climate and economic Justice Screening Tool](https://screeningtool.geoplatform.gov/en#3/33.47/-97.5)

![](images/EEEJ_climateJusticeScreeningTool.png)

To run an EEEJ analysis, do the following:

- **Property List view**

- **Select the properties for the analysis**
- **Actions pulldown list**
- Give the analysis a name and select the “Energy Equity & Environmental Justice (EEEJ) option

![](images/EEEJ_runAnalyses.png)

To view the results:

- **Analyses**

- The results will be be displayed in the Analyses screen

![](images/EEEJ_analyses_results.png)

- Click on the Run ID in the analysis list to see individual building results

![](images/EEEJ_analyses_results_bldg.png)

- **Inventory**

- **Property List and Detail View:** Results are displayed in the Inventory Property List and Detail view in these fields

![](images/EEEJ_inventory_prop_results.png)

- **Property List View:** Results are also displayed on the Inventory List Map

![](images/EEEJ_inventory_prop_map.png)

- **Property Detail:**

- Results are displayed in the Property Detail view in "card" format
- It is also possible to run Analysis for a specific property from the Property Detail view

![](images/EEEJ_inventory_prop_detail.png)

### Data

#### Batch Import of Audit Template Files
Expand Down
73 changes: 3 additions & 70 deletions docs/user_doc_analyses.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ There are several analyses that can be run on properties. Expand the sections b
??? note "Overview"
## Analysis Overview

There are currently six different types of Analyses available in SEED:
There are currently several 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
Expand All @@ -16,9 +16,8 @@ There are several analyses that can be run on properties. Expand the sections b
- 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**
- Provides various aggregations of the available Elements in a property

## Generating an Analysis

Expand All @@ -41,7 +40,7 @@ There are several analyses that can be run on properties. Expand the sections b

![](images/analyses_general_03.png)

??? note "BSyncr" Analysis"
??? note "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
Expand Down Expand Up @@ -227,72 +226,6 @@ There are several analyses that can be run on properties. Expand the sections b

![](images/analyses_co2_viewing_analysis_03.png)

??? note "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](https://screeningtool.geoplatform.gov/en/methodology){:.external}
- [Environmental Justice Screening and Mapping Tool (EJScreen)](https://www.epa.gov/ejscreen){:.external}
- [The U.S. Department of Housing and Urban Development](https://hudgis-hud.opendata.arcgis.com/){:.external}

### 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](https://geocoding.geo.census.gov/){:.external} 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

1. First select one or more properties on the inventory list page and then choose ‘Run Analysis’ from the Actions dropdown menu:
![Select Run an Analysis from the Actions Menu](images/eeej_1.webp){:.seed-img}

2. 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:
![Name your analysis and select EEEJ as the type](images/eeej_2.webp){:.seed-img}

3. 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.
![Navigate to your analysis](images/eeej_3.webp){:.seed-img}

4. On the Analyses page you can see a list of analyses run and their status:
![List of analyses](images/eeej_4.webp){:.seed-img}

5. 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:
![Click on run ID for details page](images/eeej_5.webp){:.seed-img}

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

![Analysis details page](images/eeej_6.webp){:.seed-img}

An example EJ Screen report:

![Example EJ Screen report](images/eeej_7.webp){:.seed-img}

6. As part of the analysis, the result fields above (except for the EJ Screen Report Link) have been saved directly to each property:
![Analysis results saved to property fields](images/eeej_8.webp){:.seed-img}

7. 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).
![Analysis card at the top of the property detail page](images/eeej_9.webp){:.seed-img}

8. The disadvantaged census tracts can be visualized on the map page (the areas with blue shading):
![SEED map showing disadvantaged community census tracts](images/eeej_10.webp){:.seed-img}

??? note "Element Statistics Analysis"
## Element Statistics Analysis

Expand Down
1 change: 0 additions & 1 deletion docs/user_doc_getting_started.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -231,7 +231,6 @@ following:
- BETTER
- EUI
- Average Annual CO2
- Energy Equity & Environmental Justice (EEEJ)

??? note "Analyses"
![Analyses](images/analysis_run.png)
Expand Down

0 comments on commit d804532

Please sign in to comment.