Skip to content

Commit 4a52683

Browse files
Began resolving easy, editorial type items from Paul's review
1 parent 3df93ac commit 4a52683

8 files changed

Lines changed: 17 additions & 15 deletions

docs/desktop-applications/lifesim/applications-guide/v1.0/01-preface.mdx

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -27,10 +27,11 @@ import VersionSelector from "@site/src/components/VersionSelector";
2727
software used by the U.S. Army Corps of Engineers. LifeSim is designed to simulate the entire warning and evacuation process for estimating potential life loss
2828
and direct economic damages resulting from floods. The following is a description of the major capabilities of LifeSim:
2929

30-
- Graphical User Interface
31-
- Agent Based Modeling
32-
- Uncertainty
33-
- Graphics and Reporting
30+
- Agent-Based Modeling
31+
- Geographic Context
32+
- Modeled interactions between a dynamic flood hazard, buildings, and the evacuating population
33+
- Adherence to research on warning delays
34+
- Monte Carlo sampling of uncertainty
3435

3536
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
3637
maintaining a high level of efficiency for the user.

docs/desktop-applications/lifesim/applications-guide/v1.0/02-introduction.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,15 +56,15 @@ your results. The examples are intended as a guide for performing similar analys
5656
title: (
5757
<>
5858
<strong>Summary of LifeSim Inputs</strong>, defines and explains the required inputs for all LifeSim studies. Finally, some recommended
59-
data pre-processing is discussed. Reference back to this section for additional information on Hydraulic Data, Emergency Planning Zones (EPZ),
59+
data pre-processing is discussed. Refer back to this section for additional information on Hydraulic Data, Emergency Planning Zones (EPZ),
6060
Structure Inventories, Alternatives, and Simulations.
6161
</>
6262
),
6363
},
6464
{ // STEP 2
6565
title: (
6666
<>
67-
<strong>Estimating Consequence for Levees and Floodwalls</strong>, demonstrates the data required to estimate consequences
67+
<strong>Estimating Consequences for Levees and Floodwalls</strong>, demonstrates the data required to estimate consequences
6868
(life loss and direct economic damages) for a levee or floodwall failure. The example describes the required inputs, ways to acquire emergency preparedness
6969
information for populations at risk (PAR) and emergency management agencies (EMAs), how to simulate evacuation, and how to analyze your modeling
7070
results.

docs/desktop-applications/lifesim/applications-guide/v1.0/03-summary-of-lifesim-inputs.mdx

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ evacuation (i.e., road network and destinations) are discussed in detail in the
3434
## Hydraulic Data
3535

3636
Each of the applications in this guide details how to import hydraulic data from Hydrologic Engineering Center’s River Analysis System (HEC-RAS),
37-
including various import sources (e.g., summary grids and Hierarchical Data Format files) from HEC-RAS. There are nuances in selecting the correct
37+
including various import sources (e.g., summary grids and HDF files) from HEC-RAS. There are nuances in selecting the correct
3838
hazard occurrence time for dams, levees, cascading dam failures, etc. The hazard occurrence time is defined as the point in time in which the hazard
3939
(e.g., dam failure, levee overtopping) occurs. It is the anchor point for all other time-dependent warning and evacuation parameters within the
4040
simulation.
@@ -190,7 +190,8 @@ occupancy types in LifeSim.
190190
When importing a structure inventory into LifeSim, if structure, content, and/or vehicle values are not readily available, you can
191191
check <FigureInline src="figures/desktop-applications/lifesim/applications-guide/v1.0/inline-images/inline-checkbox.png" /> the “Missing”
192192
box and enter a default value. In the example below, all structures in the structure inventory have a value of 200,000 dollars. If the purpose of the study
193-
is only to evaluate life loss and not monetary damages, it may be appropriate to set these values to 0 dollars.
193+
is only to evaluate life loss and not monetary damages, it may be appropriate to set these values to 0 dollars or to 1 dollar in order
194+
to obtain percent damaged over each structure and the structure inventory.
194195

195196
<Figure
196197
figKey="figure-1"

docs/desktop-applications/lifesim/applications-guide/v1.0/04-estimating-consequences-for-levees-and-floodwalls.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Simulating Alternatives.
4646
## Hydraulic Data
4747

4848
The Cache Creek Levee utilized output from the Hydrologic Engineering Center’s River Analysis System (HEC-RAS) <Citation citationKey="HECRAS2024"/>.
49-
When using HEC-RAS data in LifeSim, the hydraulic data should be in the form of Hierarchical Data Format (HDF) files. HDF files are an open source file format
49+
When using HEC-RAS data in LifeSim, the hydraulic data should be in the form of HDF files. HDF files are an open source file format
5050
that supports large, complex, heterogeneous data (note: Only HEC-RAS versions 5.0 and later produce the HDF files required by LifeSim). For HEC-RAS HDF plan files, the output
5151
is essentially a package of depths, velocities, and hydraulic timing files. Using HDF files allows you to simulate evacuation in LifeSim easily and with greater detail.
5252
For most levees/floodwalls, it is recommended to simulate evacuation to accurately capture potential life loss in structures <em>and</em> on roads.
@@ -170,7 +170,7 @@ the EPZ should represent the leveed area. Otherwise, it is likely that both econ
170170
including consequences that are outside of the leveed area. Presumably you are estimating the consequences and risk of a levee or floodwall; therefore, you
171171
need to understand where the excess risk (i.e., “levee risk” or the risk associated with the levee) is, which is only within the leveed area.
172172

173-
For most levees and floodwalls, the shapefile used for the EPZ should represent the estimated leveed area. The National Levee Database (NLD) is a
173+
The National Levee Database (NLD) is a
174174
resource that includes most floodwalls and levees within the U.S. <Citation citationKey="NLD"/>. The NLD shows the leveed area for each project and allows you
175175
to download the leveed area as a shapefile, which should be used as the EPZ for the study.
176176

docs/desktop-applications/lifesim/applications-guide/v1.0/05-estimating-consequences-for-dams.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ economic damage estimates for the Curwensville Dam project.*
3737
## Data Requirements
3838

3939
To take full advantage of LifeSim capabilities, an unsteady Hydrologic Engineering Center’s River Analysis System (HEC-RAS) <Citation citationKey="HECRAS2024"/>
40-
dam fail model with a range of fail {/*Do we want to update the terminology to fail and non-fail?*/} and corresponding non-fail events is required. Non-fail events are needed to identify any areas flooded prior
40+
dam fail model with a range of fail and corresponding non-fail events is required. Non-fail events are needed to identify any areas flooded prior
4141
to the fail, which allows you to understand excess life loss and excess risk of the dam. Alternatively, the inundation footprint from a failure
4242
model the time step immediately before the breach initiation time can be used to identify areas flooded prior to the failure. For this example, the non-fail inundation
4343
extents were provided to identify pre-fail flooding. This example also assumes that both maximum depth grids and inundation boundary polygons for each event
@@ -365,7 +365,7 @@ The subsequent sections will discuss setting up a LifeSim model by importing dat
365365
### Hydraulic Data
366366

367367
To calculate life loss, LifeSim requires depths, velocities, and arrival times from unsteady hydraulic modeling. The most common
368-
method of delivering this information into the LifeSim model is through HEC-RAS Hierarchical Data Format (HDF) plan files (Note: Only HEC-RAS versions
368+
method of delivering this information into the LifeSim model is through HEC-RAS HDF plan files (Note: Only HEC-RAS versions
369369
5.0 and later produce the HDF files required by LifeSim). For each hydraulic scenario, the user will need the plan file from HEC-RAS and the terrain files (both
370370
the HDF and the associated Tagged Image Format (TIF) files) so that LifeSim can calculate depths and arrival times.
371371

docs/desktop-applications/lifesim/applications-guide/v1.0/07-estimating-consequences-for-coastal-infrastructure.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ be necessary.
8686
### Hydraulic Data
8787

8888
When using Hydrologic Engineering Center’s River Analysis System (HEC-RAS) <Citation citationKey="HECRAS2024"/> data as LifeSim input, the hydraulic data should be
89-
in the form of Hierarchical Data Format (HDF) files so the user can easily simulate evacuation when necessary. Unlike riverine/inland levees or floodwalls,
89+
in the form of HDF files so the user can easily simulate evacuation when necessary. Unlike riverine/inland levees or floodwalls,
9090
simulating evacuation in a coastal environment may not be a critical part of estimating direct life loss. In most cases, life loss on roads in a
9191
coastal context, where the source of inundation is most associated with an infrequent storm event (e.g., hurricane), is not expected to be the primary
9292
risk driver. Lead times for these types of events are generally expected to be greater than 24 hours (e.g., hurricane tracking begins several days

docs/desktop-applications/lifesim/applications-guide/v1.0/08-estimating-life-loss-in-planning-comparing-alternatives-for-riverine-coastal-flooding.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ Simulating Alternatives.
5959
### Hydraulic Data
6060

6161
The Ala Wai LifeSim model utilized output from the Hydrologic Engineering Center’s River Analysis System (HEC-RAS) <Citation citationKey="HECRAS2024"/>.
62-
Ideally, the HEC-RAS inputs should be in the form of Hierarchical Data Format (HDF) files so the user can easily simulate evacuation in LifeSim. However,
62+
Ideally, the HEC-RAS inputs should be in the form of HDF files so the user can easily simulate evacuation in LifeSim. However,
6363
summary grids or other output from other hydraulic models could be utilized in LifeSim (reference the LifeSim 2.0 Technical Reference Manual
6464
<Citation citationKey="LifeSimTech2021"/> and the
6565
<Link to="/docs/desktop-applications/lifesim/users-guide/v1.0/hydraulic-data">LifeSim Users Guide, Hydraulic Data</Link> chapter for additional information). For planning studies,

docs/desktop-applications/lifesim/applications-guide/v1.0/09-estimating-direct-economic-damages.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ in LifeSim.
5050
### Hydraulic Data
5151

5252
The Ala Wai LifeSim model utilized output from the Hydrologic Engineering Center’s River Analysis System (HEC-RAS) <Citation citationKey="HECRAS2024"/>. Ideally,
53-
the HEC-RAS inputs should be in the form of Hierarchical Data Format (HDF) to streamline the process; this is the easiest way to calculate both direct economic
53+
the HEC-RAS inputs should be in the form of HDF to streamline the process; this is the easiest way to calculate both direct economic
5454
damages and life loss in one LifeSim model. However, summary grids (reference the
5555
<Link to="/docs/desktop-applications/lifesim/applications-guide/v1.0/using-summary-grids-in-lifesim/#purpose">Using Summary Grids in LifeSim</Link> chapter) and
5656
other hydraulic models could be utilized in LifeSim (reference the LifeSim 2.0 Technical Reference Manual <Citation citationKey="LifeSimTech2021"/> and the

0 commit comments

Comments
 (0)