diff --git a/README.md b/README.md index 5c541849..5c7212ef 100644 --- a/README.md +++ b/README.md @@ -10,11 +10,9 @@ [Visit full documentation here.](https://nlr-distribution-suite.github.io/erad/) -Understanding the impact of disaster events on people's ability to access critical services is key to designing appropriate programs to minimize the overall impact. Flooded roads, downed power lines, flooded power substation etc. could impact access to critical services like electricity, food, health and more. The field of disaster modeling is still evolving and so is our understanding of how these events would impact our critical infrastructures such power grid, hospitals, groceries, banks etc. +ERAD is a free, open-source Python toolkit for assessing distribution-system asset resilience under hazard scenarios. It models physical infrastructure using graph-based connectivity and computes hazard-specific exposure and survival probabilities for assets such as poles, lines, cables, transformers, substations, junction boxes, switches, and rooftop solar installations. Asset fragility curves relate hazard severity to failure probability for power-system components using relationships established in the literature for flood, wind, wildfire, and earthquake conditions. -ERAD is a free, open-source Python toolkit for computing energy resilience measures in the face of hazards like earthquakes and flooding. It uses graph database to store data and perform computation at the household level for a variety of critical services that are connected by power distribution network. It uses asset fragility curves, which are functions that relate hazard severity to survival probability for power system assets including cables, transformers, substations, roof-mounted solar panels, etc. recommended in top literature. Programs like undergrounding, microgrid, and electricity backup units for critical infrastructures may all be evaluated using metrics and compared across different neighborhoods to assess their effects on energy resilience. - -ERAD is designed to be used by researchers, students, community stakeholders, distribution utilities to understand and possibly evaluate effectiveness of different post disaster programs to improve energy resilience. It was funded by National Laboratory of the Rockies (NLR) and made publicly available with open license. +ERAD is designed for researchers, students, utilities, and other stakeholders who want to evaluate the performance of electric distribution systems under extreme events and compare asset hardening or mitigation strategies. It supports scenario-based analysis, uncertainty sampling, and export of asset-level results for downstream analysis and system comparison. It was funded by the National Laboratory of the Rockies (NLR) and made publicly available with an open license. ```mermaid flowchart TD diff --git a/docs/api/mcp_server.md b/docs/api/mcp_server.md index e6e535cc..b3d22aaf 100644 --- a/docs/api/mcp_server.md +++ b/docs/api/mcp_server.md @@ -1,6 +1,6 @@ # ERAD MCP Server -The ERAD MCP (Model Context Protocol) Server provides a powerful interface for running hazard simulations, querying assets, exploring historic hazards, and analyzing distribution system resilience through AI assistants like Claude Desktop and GitHub Copilot. +The ERAD MCP (Model Context Protocol) Server provides a powerful interface for running hazard simulations, querying assets, exploring historic hazards, and analyzing distribution system asset survivability through AI assistants like Claude Desktop and GitHub Copilot. ## Overview diff --git a/docs/community/code_of_contuct.md b/docs/community/code_of_conduct.md similarity index 95% rename from docs/community/code_of_contuct.md rename to docs/community/code_of_conduct.md index 0c20c25c..b3bf5fd7 100644 --- a/docs/community/code_of_contuct.md +++ b/docs/community/code_of_conduct.md @@ -25,7 +25,7 @@ Project maintainers are responsible for clarifying and enforcing our standards. This Code of Conduct applies to all project spaces, including GitHub repositories, discussions, issue trackers, and any public communications. ## Enforcement -Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project team at **aadil.latif@nrel.gov**. +Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project team at **aadil.latif@nlr.gov**. All complaints will be reviewed and addressed promptly. ## Attribution diff --git a/docs/intro.md b/docs/intro.md index 3d22de75..840babd5 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -2,13 +2,11 @@ ## Introduction -Understanding the impact of disaster events on people's ability to access critical service is key to designing appropriate programs to minimize the overall impact. Flooded roads, downed power lines, flooded power substation etc. could impact access to critical servies like electricity, food, health and more. The field of disaster modeling is still evolving and so is our understanding of how these events would impact our critical infrastrctures such power grid, hospitals, groceries, banks etc. +ERAD is a free, open-source Python toolkit for assessing distribution-system asset resilience under hazard scenarios. It models physical infrastructure using graph-based connectivity and computes hazard-specific exposure and survival probabilities for assets such as poles, lines, cables, transformers, substations, junction boxes, switches, and rooftop solar installations. Asset fragility curves relate hazard severity to failure probability for power-system components using relationships established in the literature for flood, wind, wildfire, and earthquake conditions. -ERAD is a free, open-source Python toolkit for quantifying energy resilience in the face of hazards like earthquakes and flooding. It uses graph structures to store data and perform computation at the household level for a variety of critical services that are connected by power distribution network. It uses asset fragility curves, which are functions that relate hazard severity to survival probability for power system assets including cables, transformers, substations, roof-mounted solar panels, etc. recommended in top literature. Programs like undergrounding, microgrid, and electricity backup units for critical infrastructures may all be evaluated using metrics and compared across different neighborhoods to assess their effects on energy resilience. +To enhance data consistency and cross-platform compatibility, ERAD also integrates with the [Grid-Data-Models (GDM)](https://github.com/NLR-Distribution-Suite/grid-data-models) framework. GDM provides standardized, Pydantic-based data structures for representing distribution networks, ensuring that ERAD can seamlessly interoperate with other power system analysis tools. As a result, researchers and utilities can run hazard analyses in ERAD using the same distribution system models applied in power flow studies, planning tools, and other simulation platforms, significantly reducing data preparation effort and improving reproducibility. -To enhance data consistency and cross-platform compatibility, ERAD also integrates with the [Grid-Data-Models (GDM)](https://github.com/NLR-Distribution-Suite/grid-data-models) framework. GDM provides standardized, Pydantic-based data structures for representing distribution networks, ensuring that ERAD can seamlessly interoperate with other power system analysis tools. This integration improves interoperability by enabling direct exchange of validated network models, preserving connectivity information, and supporting temporal changes in infrastructure state. As a result, researchers and utilities can run resilience analyses in ERAD using the same distribution system models applied in power flow studies, planning tools, and other simulation platforms, significantly reducing data preparation effort and improving reproducibility. - -ERAD is designed to be used by researchers, students, community stakeholders, distribution utilities to understand and possibly evaluate effectiveness of different post disaster programs to improve energy resilience. It was funded by National Laboratory of the Rockies (NLR) and made publicly available with open license. +ERAD is designed for researchers, students, utilities, and other stakeholders who want to evaluate the performance of electric distribution systems under extreme events and compare asset hardening or mitigation strategies. It was funded by the National Laboratory of the Rockies (NLR) and made publicly available with an open license. ## Table of Contents