From fc9b3e68415fb11b903be46b102f94f0c9bb9b71 Mon Sep 17 00:00:00 2001 From: kflemin <2205659+kflemin@users.noreply.github.com> Date: Fri, 24 Jan 2025 13:51:24 -0700 Subject: [PATCH] eo-compliance --- docs/references.md | 2 - docs/release_notes.md | 50 ---------------------- docs/user_doc_analyses.md | 73 ++------------------------------ docs/user_doc_getting_started.md | 1 - 4 files changed, 3 insertions(+), 123 deletions(-) diff --git a/docs/references.md b/docs/references.md index bf192da4..1bceab83 100644 --- a/docs/references.md +++ b/docs/references.md @@ -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. diff --git a/docs/release_notes.md b/docs/release_notes.md index bce87423..274cb447 100644 --- a/docs/release_notes.md +++ b/docs/release_notes.md @@ -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 diff --git a/docs/user_doc_analyses.md b/docs/user_doc_analyses.md index 5824aef2..03209d80 100644 --- a/docs/user_doc_analyses.md +++ b/docs/user_doc_analyses.md @@ -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 @@ -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 @@ -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 @@ -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 diff --git a/docs/user_doc_getting_started.md b/docs/user_doc_getting_started.md index 1fa695ad..0b99eda1 100644 --- a/docs/user_doc_getting_started.md +++ b/docs/user_doc_getting_started.md @@ -231,7 +231,6 @@ following: - BETTER - EUI - Average Annual CO2 -- Energy Equity & Environmental Justice (EEEJ) ??? note "Analyses" ![Analyses](images/analysis_run.png)