Skip to content

Commit 85e53a4

Browse files
AdamGohsAdamGohs
committed
Scaffold v1.1 of RMC TotalRisk Users Guide
Copies v1.0 documents, figures, and bibliography to a new v1.1 folder so the revision can be edited without disturbing the published v1.0. Adds a placeholder row to 00-version-history.mdx and flips draft:true on the TotalRisk Users Guide entry in docConfig.js. No content changes in this commit — purely boilerplate scaffolding.
1 parent 7b12914 commit 85e53a4

219 files changed

Lines changed: 3271 additions & 1 deletion

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/desktop-applications/rmc-totalrisk/users-guide/v1.1/00-document-info.mdx‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: Document Info
3+
reportDate: April 2025
4+
reportType: Computer Program Document
5+
reportTitle: RMC-TotalRisk
6+
reportSubTitle: User's Guide
7+
reportAuthors: ['Haden Smith, Risk Management Center', 'Woodrow Fields, Risk Management Center']
8+
reportAbstract:
9+
reportAcknowledgments: RMC-TotalRisk would not exist without the support of Risk Management Center (RMC) leadership, in particular RMC Director Nate Snorteland and Lead Engineers David Margo, Jason Needham, and Timothy O’Leary. The authors also recognize David Bowles and Ruben Jongejan for performing an external peer review of the software and risk analysis framework. The software development team is very grateful to those who contributed to the software.
10+
reportSubjectTerms:
11+
responsiblePersonName: Haden Smith
12+
responsiblePersonNumber:
13+
citationGuide: "C. H. Smith and W. L. Fields, <i>RMC-TotalRisk User's Guide</i>, Lakewood, CO: U.S. Army Corps of Engineers, Risk Management Center, 2025. Accessed on <i>{enter current date here}</i>."
14+
---
15+
16+
import Link from '@docusaurus/Link';
17+
import addBaseUrl from '@docusaurus/useBaseUrl';
18+
import DocumentMetadata from '@site/src/components/DocumentMetadata';
19+
import NavContainer from '@site/src/components/NavContainer';
20+
21+
<NavContainer
22+
link="/desktop-applications/rmc-totalrisk"
23+
linkTitle="RMC-TotalRisk"
24+
document="desktop-applications/rmc-totalrisk/users-guide"
25+
></NavContainer>
26+
27+
# Document Information
28+
29+
<DocumentMetadata metadata={frontMatter} />

‎docs/desktop-applications/rmc-totalrisk/users-guide/v1.1/00-version-history.mdx‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
import Link from '@docusaurus/Link';
2+
import NavContainer from '@site/src/components/NavContainer';
3+
import TableVersionHistory from '@site/src/components/TableVersionHistory';
4+
5+
<NavContainer
6+
link="/desktop-applications/rmc-totalrisk"
7+
linkTitle="RMC-TotalRisk"
8+
document="desktop-applications/rmc-totalrisk/users-guide"
9+
></NavContainer>
10+
11+
# Version History
12+
13+
<TableVersionHistory
14+
versions={['1.1', '1.0']}
15+
dates={['May 2026', 'March 2026']}
16+
descriptions={['Placeholder — describe the changes in this revision.', 'Initial release as an online document.']}
17+
modifiedBy={['Enter author name', '-']}
18+
reviewedBy={['-', '-']}
19+
approvedBy={['-', 'Nate Snorteland']}
20+
/>

‎docs/desktop-applications/rmc-totalrisk/users-guide/v1.1/01-preface.mdx‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
title: Preface
3+
---
4+
5+
import NavContainer from "@site/src/components/NavContainer";
6+
import VersionSelector from "@site/src/components/VersionSelector";
7+
import Link from "@docusaurus/Link";
8+
import addBaseUrl from "@docusaurus/useBaseUrl";
9+
10+
<NavContainer
11+
link="/desktop-applications/rmc-totalrisk"
12+
linkTitle="RMC-TotalRisk"
13+
document="desktop-applications/rmc-totalrisk/users-guide"
14+
></NavContainer>
15+
16+
# Preface
17+
18+
The U.S. Army Corps of Engineers TotalRisk software (RMC-TotalRisk) performs quantitative risk calculations for a system from a set of hazard,
19+
transform, system response, and consequence functions. RMC-TotalRisk is part of an integrated software suite that supports risk assessments.
20+
The software features a fully integrated modeling platform, including a modern graphical user interface, data entry, report quality charts, and
21+
diagnostic tools. RMC-TotalRisk can evaluate risk for a single component with multiple failure modes and a complex system comprised of multiple
22+
components. This document is a guide for developing a quantitative risk analysis with RMC-TotalRisk.

‎docs/desktop-applications/rmc-totalrisk/users-guide/v1.1/02-welcome.mdx‎

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: Welcome to RMC-TotalRisk
3+
---
4+
5+
import NavContainer from "@site/src/components/NavContainer";
6+
import VersionSelector from "@site/src/components/VersionSelector";
7+
import Link from "@docusaurus/Link";
8+
import addBaseUrl from "@docusaurus/useBaseUrl";
9+
10+
<NavContainer
11+
link="/desktop-applications/rmc-totalrisk"
12+
linkTitle="RMC-TotalRisk"
13+
document="desktop-applications/rmc-totalrisk/users-guide"
14+
></NavContainer>
15+
16+
# Welcome to RMC-TotalRisk
17+
18+
The U.S. Army Corps of Engineers (USACE) Risk Management Center (RMC) developed the quantitative risk analysis software (RMC-TotalRisk) to enhance and
19+
expedite risk assessments conducted by the USACE Flood Risk Management, Planning, and Dam and Levee Safety Communities of Practice.
20+
21+
RMC-TotalRisk is a menu-driven software that conducts risk analysis based on user-defined hazard, transform, system response, and consequence functions.
22+
The software features a fully integrated modeling platform, including a modern graphical user interface, data entry capabilities, and report quality
23+
charts and diagnostics. RMC-TotalRisk can perform multi-failure risk analysis for individual dams or levees as well as for complex systems with multiple
24+
components.
25+
26+
## Why You Should Use RMC-TotalRisk
27+
28+
RMC-TotalRisk is a powerful risk analysis software designed with an intuitive and easy-to-use interface. It simplifies the complexity of risk assessments
29+
by connecting the core components of risk — hazard, transform, response, and consequences — through a clear and intuitive risk diagram. The software
30+
generates a comprehensive range of risk outputs, including excess, background, total, failure, and non-failure risks. Each component of the analysis can
31+
incorporate uncertainty, and the software supports modeling multiple locations with distinct failure modes as separate system components, streamlining
32+
system-level risk evaluations.
33+
34+
RMC-TotalRisk offers unique capabilities that set it apart from other USACE software. It supports diverse hazard types, including floods, earthquakes,
35+
and wildfires, extending beyond the flood hazards modeled by most tools. The software also accommodates a wide range of consequence types, enabling
36+
assessments of life loss, economic impacts, and environmental effects. Seamless integration with other USACE programs allows it to import data from RMC-RFA,
37+
RMC-BestFit, RRFT, ERDC-StormSim, HEC-WAT, HEC-RAS, HEC-SSP, and LifeSim, providing unparalleled inter-software compatibility.
38+
39+
The software includes advanced functionalities, such as event tree analysis, which enables users to model geotechnical and structural performance with
40+
diagnostic and sensitivity tools unavailable in other USACE platforms. RMC-TotalRisk uniquely accounts for multiple failure modes, offering options for joint,
41+
competing, common cause, and mutually exclusive failure modes, each with distinct consequences. Additionally, it models dependency between failure mode
42+
capacities and hazard functions using flexible options, including user-defined correlation matrices.
43+
44+
RMC-TotalRisk calculates five critical types of risk — excess, background, total, failure, and non-failure — that are essential for informed decision-making.
45+
It provides comprehensive outputs, including loss exceedance curves, risk measures, and assurance metrics, all fully compliant with USACE policies for dam safety,
46+
levee safety, and flood risk management. Furthermore, it can replicate and update legacy risk analyses from tools like DAMRAE, LST, and HEC-FDA, enhancing its
47+
value for risk-informed investment decisions.
48+
49+
## When You Should Use RMC-TotalRisk
50+
51+
Use RMC-TotalRisk whenever you need to perform a risk analysis, particularly when the analysis involves complex systems with multiple components, uncertainties,
52+
or dependencies. While the software is frequently applied in flood risk management, its capabilities extend far beyond this domain. RMC-TotalRisk is relevant to
53+
any scenario involving hazards, responses, and consequences, making it a versatile tool for a wide range of scientific, engineering, and policy applications.
54+
55+
The examples in this document relate to flood risk for dams and levees. However, the software is not limited to flood risk management applications. RMC-TotalRisk
56+
is designed as a general-purpose risk analysis software capable of estimating risk for various complex systems. Its flexibility and robust analytical framework
57+
make it suitable for applications such as:
58+
59+
- **Flood Risk Assessment**: Evaluate risks associated with floods, including structural vulnerabilities and potential consequences for infrastructure and populations
60+
- **Seismic Risk Assessment**: Evaluate risks associated with earthquakes, including structural vulnerabilities and potential consequences for infrastructure
61+
and populations.
62+
- **Wildfire Risk Management**: Estimate the probability of occurrence, and assess associated economic, environmental, and human impacts.
63+
- **Environmental Risk Analysis**: Analyze risks to ecosystems from natural or anthropogenic hazards, including climate change impacts, pollution, or habitat degradation.
64+
- **Industrial and Infrastructure Safety**: Assess risks for critical infrastructure, such as power plants, bridges, or pipelines, accounting for failure modes
65+
and interdependencies.
66+
- **Custom Applications**: Tackle any scenario where hazards and consequences can be defined, including risks related to human health, transportation systems, or
67+
supply chain disruptions.
68+
69+
RMC-TotalRisk's ability to integrate diverse hazards, model complex dependencies, and account for uncertainties makes it ideal for multidisciplinary applications.
70+
Whether you are working on a dam safety program, evaluating the environmental impacts of a natural disaster, or designing resilient infrastructure, RMC-TotalRisk
71+
provides the tools to comprehensively assess and communicate risk, supporting informed decision-making.

‎docs/desktop-applications/rmc-totalrisk/users-guide/v1.1/03-overview.mdx‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: Risk Analysis Framework
3+
---
4+
5+
import NavContainer from "@site/src/components/NavContainer";
6+
import VersionSelector from "@site/src/components/VersionSelector";
7+
import Link from "@docusaurus/Link";
8+
import addBaseUrl from "@docusaurus/useBaseUrl";
9+
import Figure from "@site/src/components/Figure";
10+
import FigReference from "@site/src/components/FigureReference";
11+
import Citation from "@site/src/components/Citation";
12+
import CitationFootnote from "@site/src/components/CitationFootnote";
13+
14+
<NavContainer
15+
link="/desktop-applications/rmc-totalrisk"
16+
linkTitle="RMC-TotalRisk"
17+
document="desktop-applications/rmc-totalrisk/users-guide"
18+
></NavContainer>
19+
20+
# Risk Analysis Framework
21+
22+
In RMC-TotalRisk, a risk analysis computes the risk associated with a collection of potential failure modes for each system component. A failure mode consists
23+
of three key inputs: a hazard, the system’s response to the hazard, and the consequences of that response. A non-failure mode, on the other hand, includes the
24+
hazard and the associated non-failure consequences.
25+
26+
A risk analysis uses four types of functions as inputs:
27+
28+
- **Hazard Function**: Commonly called a frequency curve, this function describes the exceedance probabilities of various hazard levels. Examples include annual
29+
maximum peak flow frequency, peak reservoir pool stage frequency, and peak ground acceleration.
30+
- **Transform Function**: This function converts hazard levels from one type to another. For example, a peak flow-frequency function can be transformed into a
31+
stage-frequency function using a flow-to-stage rating curve. Transform functions are optional.
32+
- **System Response Function**: Often referred to as a fragility curve, this function defines the conditional probability of failure for various hazard levels,
33+
such as water surface elevations (WSEs). The system response function specifies the failure mode.
34+
- **Consequence Function**: Sometimes called a damage function, this function describes the consequences of failure or non-failure for various hazard levels,
35+
such as annual maximum peak WSEs.
36+
37+
For example, <FigReference figKey="figure-1"/> illustrates the conceptual risk analysis process for a levee with a single failure mode and a
38+
single system component. Beginning in the top left of the figure, the flood **hazard** is defined by an annual maximum peak flow-frequency distribution, estimated
39+
using flood-frequency analysis methods. Next, moving to the top right, peak flow is **transformed** to a WSE using a stage-discharge rating curve estimated using
40+
a hydraulic model. Then, moving to the bottom right, the **system response function** is defined by a probability of failure given the WSE, often derived from
41+
engineering analysis and expert elicitation methods. And finally, moving to the bottom left, the **consequences** given failure are estimated as a function of WSE.
42+
43+
<Figure
44+
figKey="figure-1"
45+
src="figures/desktop-applications/rmc-totalrisk/users-guide/v1.0/figure0.png"
46+
alt="Levee risk analysis process for a single failure mode and a single system component."
47+
caption="Levee risk analysis process for a single failure mode and a single system component."
48+
/>
49+
50+
The risk analysis computes the expected annual consequences by integrating over these functions. For a deeper understanding of the mathematics involved in risk
51+
analysis, refer to the technical reference manual (Smith et al., 2025) <Citation citationKey="TechRef"/>. Additional USACE guidance on risk
52+
analysis for flood risk management is in EM 1110-2-1619 (USACE, 1996) <Citation citationKey="EM1619"/>
53+
and Best Practices in Dam and Levee Safety Risk Analysis (USBR and USACE, 2019) <Citation citationKey="BestPractices"/>.
54+
55+
This user guide demonstrates how to create a project; enter hazard, transform, response, and consequence functions; create a risk diagram, perform a risk analysis,
56+
and review results.
57+
58+
<CitationFootnote/>

0 commit comments

Comments
 (0)