Skip to content

Commit a21d8d0

Browse files
AdamGohsAdamGohs
authored
Merge pull request #128 from USACE-RMC/docs/major/lifesim-tech-ref-manual-v1.0
Initial webpage release of 2020 LifeSim Technical Reference Manual. Updated applicable items to 2026.
2 parents 77ee183 + 967d86e commit a21d8d0

133 files changed

Lines changed: 11037 additions & 57 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/technical-reference-manual/v1.0/00-document-info.mdx‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
title: Document Info
3+
reportDate: July 2020
4+
reportType: Computer Program Document
5+
reportTitle: LifeSim
6+
reportSubTitle: Technical Reference Manual
7+
reportAuthors: ['U.S. Army Corps of Engineers, Risk Management Center']
8+
reportAbstract: "The US Army Corps of Engineers (USACE) Hydrologic Engineering Center's (HEC) Life Loss Estimation (HEC-LifeSim) software is a spatially-distributed dynamic simulation modeling system for estimating potential life loss and economic damages from natural and dam and levee failure floods. The main purpose of the HEC-LifeSim software is to help USACE study teams better understand the consequences of a flood event. Although flooding can lead to many types of severe consequences, the primary objective of the USACE Dam and Levee Safety Program is to manage risk to the public who rely on those structures to keep them reasonably safe from flooding."
9+
reportSubjectTerms:
10+
[
11+
'HEC-LifeSim',
12+
'USACE',
13+
'life loss',
14+
'spatially',
15+
'dynamic',
16+
'simulation',
17+
'modeling',
18+
'economic',
19+
'damages',
20+
'levee safety',
21+
'analysis',
22+
'hazard',
23+
'emergency',
24+
'hydraulic data',
25+
'HEC-RAS',
26+
'grid set',
27+
'structure inventories',
28+
'damage category',
29+
'occupancy type',
30+
'construction type',
31+
'stability criteria',
32+
'submergence criteria',
33+
'emergency planning zone',
34+
'EPZ',
35+
'road network data',
36+
'shapefile',
37+
'destination data',
38+
'alternatives',
39+
'simulations',
40+
'results',
41+
'animation',
42+
'uncertainty',
43+
'arrival',
44+
'attribute',
45+
'feature',
46+
'properties',
47+
'gridded map',
48+
'vertex',
49+
]
50+
responsiblePersonName: Woodrow Fields
51+
citationGuide: 'Risk Management Center, <i>LifeSim Technical Reference Manual</i>, Davis, CA: U.S. Army Corps of Engineers, Institute for Water Resources, 2020. Accessed on <i>{enter current date here}</i>.'
52+
---
53+
54+
import Link from '@docusaurus/Link';
55+
import addBaseUrl from '@docusaurus/useBaseUrl';
56+
import DocumentMetadata from '@site/src/components/DocumentMetadata';
57+
import NavContainer from '@site/src/components/NavContainer';
58+
59+
<NavContainer
60+
link="/desktop-applications/lifesim"
61+
linkTitle="LifeSim"
62+
document="desktop-applications/lifesim/technical-reference-manual"
63+
></NavContainer>
64+
65+
# Document Information
66+
67+
<DocumentMetadata metadata={frontMatter} />

‎docs/desktop-applications/lifesim/technical-reference-manual/v1.0/00-version-history.mdx‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
title: Version History
3+
---
4+
5+
import Link from '@docusaurus/Link';
6+
import NavContainer from '@site/src/components/NavContainer';
7+
import TableVersionHistory from '@site/src/components/TableVersionHistory';
8+
9+
<NavContainer
10+
link="/desktop-applications/lifesim"
11+
linkTitle="LifeSim"
12+
document="desktop-applications/lifesim/technical-reference-manual"
13+
></NavContainer>
14+
15+
# Version History
16+
17+
<TableVersionHistory
18+
versions={['1.0']}
19+
dates={['August 2026']}
20+
descriptions={[
21+
'Initial release of LifeSim Technical Reference Manual as a web document. Source is the LifeSim Technical Reference Manual CPD-97a.',
22+
]}
23+
modifiedBy={['Susie Byrd, Karen Mai']}
24+
reviewedBy={['Paul Risher']}
25+
approvedBy={['Woodrow Fields']}
26+
/>

‎docs/desktop-applications/lifesim/technical-reference-manual/v1.0/01-preface.mdx‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
---
2+
title: 'Preface'
3+
---
4+
5+
import Link from '@docusaurus/Link';
6+
import addBaseUrl from '@docusaurus/useBaseUrl';
7+
import Button from '@site/src/components/Button';
8+
import Citation from '@site/src/components/Citation';
9+
import CitationFootnote from '@site/src/components/CitationFootnote';
10+
import Figure from '@site/src/components/Figure';
11+
import FigureInline from '@site/src/components/FigureInline';
12+
import FigReference from '@site/src/components/FigureReference';
13+
import NavContainer from '@site/src/components/NavContainer';
14+
import ProcessList from '@site/src/components/ProcessList';
15+
import TableReference from '@site/src/components/TableReference';
16+
import TableVertical from '@site/src/components/TableVertical';
17+
import VersionSelector from '@site/src/components/VersionSelector';
18+
19+
<NavContainer
20+
link="/desktop-applications/lifesim"
21+
linkTitle="LifeSim"
22+
document="desktop-applications/lifesim/technical-reference-manual"
23+
></NavContainer>
24+
25+
# Preface
26+
27+
The U.S. Army Corps of Engineers (USACE) Life Loss Estimation (LifeSim) software allows you to evaluate the life loss and economic damages
28+
resulting from a single flood scenario.
29+
30+
The LifeSim software is developed at RMC, which is a division of the USACE Institute for Water Resources (IWR). The first version of LifeSim (Version 1.0) was
31+
released in 2017. This Technical Reference Manual was tailored for Version 2.0 of the LifeSim software.
32+
33+
Woodrow Fields leads the LifeSim development team. Stephanie Owen and Brennan Beam provided review and support throughout the development of this
34+
manual in 2020. Jason Needham and William Lehman contributed significantly to all versions of LifeSim. Lea Adams was the Chief of the Water Resources Systems Division,
35+
and Chris Dunn was the director during the development of Version 2.0 of the
36+
software.
37+
38+
This Technical Reference Manual was originally prepared for the USACE Hydrologic Engineering Center (HEC) by HDR Engineering, Inc. Additional
39+
information can be found in the <Link to="/docs/desktop-applications/lifesim/users-guide/v1.0/welcome-to-lifesim">LifeSim User's Guide</Link>. LifeSim manuals
40+
are available on this RMC Software Documentation website and
41+
the <a href="https://www.rmc.usace.army.mil/Software/LifeSim/" target="_blank" rel="noopener noreferrer">RMC website</a>.
42+
43+
## Software
44+
45+
<Button href="https://github.com/USACE-RMC/LifeSim/releases/download/v2.2/LifeSim_2.2.7z">
46+
<u>🡇</u> LifeSim v2.2
47+
</Button>
48+
49+
LifeSim Version 2.2 is available for download as a self-extracting setup package.
50+
51+
<CitationFootnote />

‎docs/desktop-applications/lifesim/technical-reference-manual/v1.0/02-executive-summary.mdx‎

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: "Executive Summary"
3+
---
4+
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
19+
link="/desktop-applications/lifesim"
20+
linkTitle="LifeSim"
21+
document="desktop-applications/lifesim/technical-reference-manual"
22+
></NavContainer>
23+
24+
# Executive Summary
25+
26+
Welcome to the Risk Management Center's LifeSim Technical Reference Manual. The main purpose of the LifeSim software is to help study teams better
27+
understand the consequences of a flood event.
28+
29+
LifeSim is a spatially-distributed, dynamic simulation modeling system for estimating potential life loss and economic damages from flood hazards. A
30+
hazard is a natural or man-made event that threatens to overwhelm and injure life and/or property, e.g., a flood, toxic plume, or wildfire. LifeSim
31+
explicitly models the warning and mobilization of people potentially exposed to the hazard and predicts the spatial distribution of fatalities within
32+
buildings and on road networks expected to be impacted by the hazard. Although LifeSim was developed for dam and levee safety analyses, the software
33+
is not limited to breach flood hazards (RMC, 2021) <Citation citationKey="RMC2021"/>. The key component of LifeSim's methodology is that
34+
the magnitude of life loss depends on whether
35+
people evacuate successfully and whether those who fail to evacuate can find adequate
36+
shelter (Aboelata, Bowles, and McClelland, 2003) <Citation citationKey="AboelataBowlesMcClelland2003"/>.
37+
38+
LifeSim is built around a database. Each component exchanges data with other components throughout the database, which includes various GIS layers and
39+
tables. Default relationships and values are provided for many inputs. LifeSim's methodology reflects its early authors' understanding of the factors
40+
affecting life loss. Simply put, LifeSim determines people and assets that would be subject to a certain flood, how people evacuate or seek shelter,
41+
and estimates damages and fatalities for those people and assets caught by the flood.
42+
43+
This technical reference manual describes the methods, internal algorithms, and computations that LifeSim uses to calculate fatalities and damages
44+
resulting from floods or other hazards, and to display the spatial distribution of those consequences. A strong understanding of these internal
45+
processes will increase the user's ability to identify model limitations, provide suitable inputs, communicate the importance of results, and help
46+
validate decisions that LifeSim supports.
47+
48+
<CitationFootnote />

0 commit comments

Comments
 (0)