Skip to content

Commit cea062f

Browse files
authored
Merge pull request #116 from USACE-RMC/docs/applications-guide
Docs/applications guide
2 parents c616129 + 8f3cd6a commit cea062f

182 files changed

Lines changed: 3498 additions & 2715 deletions

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/lifesim/applications-guide/v1.0/00-document-info.mdx‎

Lines changed: 10 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,24 @@
11
---
22
title: Document Info
3-
reportDate: March 2026
3+
reportDate: September 2026
44
reportType: Computer Program Document
55
reportTitle: LifeSim
66
reportSubTitle: Applications Guide
77
reportAuthors: ['Susie Byrd, Risk Management Center']
88
reportAbstract:
9-
reportAcknowledgments: A special thank you to Jordan McMaster, Kurt Buchanan, Woodrow Fields, and Karen Mai for their contributions and support to make the LifeSim Applications Guide a reality.
9+
reportAcknowledgments: A special thank you to Karen Mai, Jordan McMaster, Kurt Buchanan, Woodrow Fields, and Paul Risher, for their contributions and support to make the LifeSim Applications Guide a reality.
1010
reportSubjectTerms:
11-
responsiblePersonName: xx
12-
responsiblePersonNumber: ###-###-####
13-
citationGuide: "S. E. Byrd and xx, <i>LifeSim Applications Guide</i>, Davis, CA: U.S. Army Corps of Engineers, Risk Management Center, 2026. Accessed on <i>{enter current date here}</i>."
11+
responsiblePersonName: Susie Byrd
12+
responsiblePersonNumber: 412-735-0037
13+
citationGuide: 'S. E. Byrd et al., <i>LifeSim Applications Guide</i>, Davis, CA: U.S. Army Corps of Engineers, Risk Management Center, 2026. Accessed on <i>{enter current date here}</i>.'
1414
---
1515

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";
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';
2020

21-
<NavContainer
22-
link="/desktop-applications/lifesim"
23-
linkTitle="LifeSim"
24-
document="desktop-applications/lifesim/applications-guide"
25-
></NavContainer>
21+
<NavContainer link="/desktop-applications/lifesim" linkTitle="LifeSim" document="desktop-applications/lifesim/applications-guide"></NavContainer>
2622

2723
# Document Information
2824

‎docs/desktop-applications/lifesim/applications-guide/v1.0/00-version-history.mdx‎

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,23 +2,27 @@
22
title: Version History
33
---
44

5-
import Link from "@docusaurus/Link";
6-
import NavContainer from "@site/src/components/NavContainer";
7-
import TableVersionHistory from "@site/src/components/TableVersionHistory";
5+
import Link from '@docusaurus/Link';
6+
import NavContainer from '@site/src/components/NavContainer';
7+
import TableVersionHistory from '@site/src/components/TableVersionHistory';
88

9-
<NavContainer
10-
link="/desktop-applications/lifesim"
11-
linkTitle="LifeSim"
12-
document="desktop-applications/lifesim/applications-guide"
13-
></NavContainer>
9+
<NavContainer link="/desktop-applications/lifesim" linkTitle="LifeSim" document="desktop-applications/lifesim/applications-guide"></NavContainer>
1410

1511
# Version History
1612

1713
<TableVersionHistory
1814
versions={['1.0']}
19-
dates={['March 2026']}
20-
descriptions={["Initial release of LifeSim Applications Guide"]}
15+
dates={['September 2026']}
16+
descriptions={['Official release of the LifeSim Applications Guide.']}
2117
modifiedBy={['Susie Byrd']}
22-
reviewedBy={['xx']}
23-
approvedBy={['xx']}
18+
reviewedBy={[
19+
<>
20+
Paul Risher
21+
<br />
22+
Sarah Mattingly
23+
<br />
24+
Ariel Feldman
25+
</>,
26+
]}
27+
approvedBy={['-']}
2428
/>
Lines changed: 26 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,52 +1,32 @@
11
---
2-
title: "Preface"
2+
title: 'Preface'
33
---
44

5-
import Link from "@docusaurus/Link";
6-
import addBaseUrl from "@docusaurus/useBaseUrl";
7-
import Citation from "@site/src/components/Citation";
8-
import CitationFootnote from "@site/src/components/CitationFootnote";
9-
import NavContainer from "@site/src/components/NavContainer";
10-
import VersionSelector from "@site/src/components/VersionSelector";
11-
12-
<NavContainer
13-
link="/desktop-applications/lifesim"
14-
linkTitle="LifeSim"
15-
document="desktop-applications/lifesim/applications-guide"
16-
></NavContainer>
5+
import Link from '@docusaurus/Link';
6+
import addBaseUrl from '@docusaurus/useBaseUrl';
7+
import Citation from '@site/src/components/Citation';
8+
import CitationFootnote from '@site/src/components/CitationFootnote';
9+
import Figure from '@site/src/components/Figure';
10+
import FigureInline from '@site/src/components/FigureInline';
11+
import FigReference from '@site/src/components/FigureReference';
12+
import NavContainer from '@site/src/components/NavContainer';
13+
import ProcessList from '@site/src/components/ProcessList';
14+
import TableReference from '@site/src/components/TableReference';
15+
import TableVertical from '@site/src/components/TableVertical';
16+
import VersionSelector from '@site/src/components/VersionSelector';
17+
18+
<NavContainer link="/desktop-applications/lifesim" linkTitle="LifeSim" document="desktop-applications/lifesim/applications-guide"></NavContainer>
1719

1820
# Preface
1921

20-
LifeSim is the life loss and direct damage estimation software used by the U.S. Army Corps of Engineers. LifeSim is designed to simulate the entire
21-
warning and evacuation process for estimating potential life loss and direct economic damages resulting from floods. The following is a description of
22-
the major capabilities of LifeSim:
23-
24-
- Graphical User Interface
25-
- Agent Based Modeling
26-
- Uncertainty
27-
- Graphics and Reporting
28-
29-
The user interacts with LifeSim through a graphical user interface (GUI). The interface is designed to make it easy to use the software, while still
30-
maintaining a high level of efficiency for the user.
31-
32-
LifeSim uses an agent-based approach to track individuals throughout the warning and evacuation process. During an evacuation, agents are interacting
33-
with the roads, other vehicles, and the incoming hazard. After the warning and evacuation process has been simulated, LifeSim calculates lethality for
34-
those people who are exposed to the hazard and the associated direct damages. By tracking individual people and their movements, LifeSim can help
35-
identify where people are most at risk of losing their lives, whether it is on roads or in structures.
36-
37-
Three modes of evacuation are included in LifeSim: cars, sports utility vehicles (SUVs), and pedestrians. For vehicular evacuation, a dual regime
38-
modified Greenshields model (USDOT) in conjunction with spillback enforcement is used for traffic propagation to represent the effects of traffic
39-
density and road capacity on vehicle speed. Each road is assigned default values for the number of lanes, free flow speed, traffic jam densities, and
40-
minimum stop-and-go speeds based on the Highway Capacity Manual (HCM) (TRB 2000).
41-
42-
To define the routes people use to evacuate, a road network is provided where each segment of the network contains information such as road category,
43-
directionality, ground offset (for bridges), and interconnectivity. The road network can be imported from an existing GIS polyline shapefile or from
44-
OpenStreetMap. OpenStreetMap is a collaborative project to create a free editable map of the world. During each timestep at the user defined interval
45-
Δt, evacuating groups (PAR evacuating from a structure in a single vehicle) move as far as the model allows until the group reaches a destination
46-
point, gets caught, or becomes stranded. More information on the evacuation simulation can be found in the (RMC 2021).
47-
48-
LifeSim applies both natural variability and knowledge uncertainty through Monte Carlo analysis. Multiple parameters can be entered with uncertainty
49-
including those that influence the warning and evacuation timeline. Each iteration in a simulation represents a scenario that could occur given the
50-
data uncertainties in the model. The results of the analysis provide a distribution of estimated consequences from a given hazard.
51-
52-
<CitationFootnote />
22+
The idea for the LifeSim Applications Guide stemmed from the need to provide additional assistance and examples to the consequences field of practice. The User's
23+
Guide and Technical Reference Manual provide some detailed information on how to use LifeSim. The Applications Guide walks through several real-life dam projects
24+
and studies, and details how the LifeSim model was built and why. Some applications focus on using LifeSim to support dam and levee safety risk assessments;
25+
other applications walk through Flood Risk Management (FRM) and Coastal Storm Risk Management (CSRM) studies and how LifeSim was used to support plan formulation
26+
and decision-making.
27+
28+
For additional information on LifeSim, please refer to the <Link to="/docs/desktop-applications/lifesim/users-guide/v1.0/preface">LifeSim User's Guide</Link>
29+
and <Link to="/docs/desktop-applications/lifesim/technical-reference-manual/v1.0/preface">LifeSim Technical Reference Manual</Link>. The Applications Guide is not
30+
intended to be a stand-alone document, and it is recommended that users have a basic understanding of LifeSim and/or consequence estimation before using this guide.
31+
This guide is not intended to provide a comprehensive overview of all LifeSim features and capabilities, but rather to highlight how LifeSim can be used to support
32+
various types of studies and analyses.

0 commit comments

Comments
 (0)