Docs/applications guide

docs/desktop-applications/lifesim/applications-guide/v1.0/00-document-info.mdx

@@ -1,28 +1,24 @@
 ---
 title: Document Info
-reportDate: March 2026
+reportDate: September 2026
 reportType: Computer Program Document
 reportTitle: LifeSim
 reportSubTitle: Applications Guide
 reportAuthors: ['Susie Byrd, Risk Management Center']
 reportAbstract:
-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.
+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.
 reportSubjectTerms:
-responsiblePersonName: xx
-responsiblePersonNumber: ###-###-####
-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>."
+responsiblePersonName: Susie Byrd
+responsiblePersonNumber: 412-735-0037
+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>.'
 ---
 
-import Link from "@docusaurus/Link";
-import addBaseUrl from "@docusaurus/useBaseUrl";
-import DocumentMetadata from "@site/src/components/DocumentMetadata";
-import NavContainer from "@site/src/components/NavContainer";
+import Link from '@docusaurus/Link';
+import addBaseUrl from '@docusaurus/useBaseUrl';
+import DocumentMetadata from '@site/src/components/DocumentMetadata';
+import NavContainer from '@site/src/components/NavContainer';
 
-<NavContainer 
-  link="/desktop-applications/lifesim"
-  linkTitle="LifeSim"
-  document="desktop-applications/lifesim/applications-guide"
-></NavContainer>
+<NavContainer link="/desktop-applications/lifesim" linkTitle="LifeSim" document="desktop-applications/lifesim/applications-guide"></NavContainer>
 
 # Document Information
 

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

@@ -2,23 +2,27 @@
 title: Version History
 ---
 
-import Link from "@docusaurus/Link";
-import NavContainer from "@site/src/components/NavContainer";
-import TableVersionHistory from "@site/src/components/TableVersionHistory";
+import Link from '@docusaurus/Link';
+import NavContainer from '@site/src/components/NavContainer';
+import TableVersionHistory from '@site/src/components/TableVersionHistory';
 
-<NavContainer 
-  link="/desktop-applications/lifesim"
-  linkTitle="LifeSim"
-  document="desktop-applications/lifesim/applications-guide"
-></NavContainer>
+<NavContainer link="/desktop-applications/lifesim" linkTitle="LifeSim" document="desktop-applications/lifesim/applications-guide"></NavContainer>
 
 # Version History
 
 <TableVersionHistory
   versions={['1.0']}
-  dates={['March 2026']}
-  descriptions={["Initial release of LifeSim Applications Guide"]}
+  dates={['September 2026']}
+  descriptions={['Official release of the LifeSim Applications Guide.']}
   modifiedBy={['Susie Byrd']}
-  reviewedBy={['xx']}
-  approvedBy={['xx']}
+  reviewedBy={[
+    <>
+      Paul Risher
+      <br />
+      Sarah Mattingly
+      <br />
+      Ariel Feldman
+    </>,
+  ]}
+  approvedBy={['-']}
 />

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

@@ -1,52 +1,32 @@
 ---
-title: "Preface"
+title: 'Preface'
 ---
 
-import Link from "@docusaurus/Link";
-import addBaseUrl from "@docusaurus/useBaseUrl";
-import Citation from "@site/src/components/Citation";
-import CitationFootnote from "@site/src/components/CitationFootnote";
-import NavContainer from "@site/src/components/NavContainer";
-import VersionSelector from "@site/src/components/VersionSelector";
-
-<NavContainer 
-  link="/desktop-applications/lifesim"
-  linkTitle="LifeSim"
-  document="desktop-applications/lifesim/applications-guide"
-></NavContainer>
+import Link from '@docusaurus/Link';
+import addBaseUrl from '@docusaurus/useBaseUrl';
+import Citation from '@site/src/components/Citation';
+import CitationFootnote from '@site/src/components/CitationFootnote';
+import Figure from '@site/src/components/Figure';
+import FigureInline from '@site/src/components/FigureInline';
+import FigReference from '@site/src/components/FigureReference';
+import NavContainer from '@site/src/components/NavContainer';
+import ProcessList from '@site/src/components/ProcessList';
+import TableReference from '@site/src/components/TableReference';
+import TableVertical from '@site/src/components/TableVertical';
+import VersionSelector from '@site/src/components/VersionSelector';
+
+<NavContainer link="/desktop-applications/lifesim" linkTitle="LifeSim" document="desktop-applications/lifesim/applications-guide"></NavContainer>
 
 # Preface
 
-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
-warning and evacuation process for estimating potential life loss and direct economic damages resulting from floods. The following is a description of
- the major capabilities of LifeSim:
-
-- Graphical User Interface
-- Agent Based Modeling
-- Uncertainty
-- Graphics and Reporting
-
-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
-maintaining a high level of efficiency for the user.
-
-LifeSim uses an agent-based approach to track individuals throughout the warning and evacuation process. During an evacuation, agents are interacting
-with the roads, other vehicles, and the incoming hazard. After the warning and evacuation process has been simulated, LifeSim calculates lethality for
- those people who are exposed to the hazard and the associated direct damages. By tracking individual people and their movements, LifeSim can help
-identify where people are most at risk of losing their lives, whether it is on roads or in structures.
-
-Three modes of evacuation are included in LifeSim: cars, sports utility vehicles (SUVs), and pedestrians. For vehicular evacuation, a dual regime
-modified Greenshields model (USDOT) in conjunction with spillback enforcement is used for traffic propagation to represent the effects of traffic
-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
-minimum stop-and-go speeds based on the Highway Capacity Manual (HCM) (TRB 2000).
-
-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,
-directionality, ground offset (for bridges), and interconnectivity. The road network can be imported from an existing GIS polyline shapefile or from
-OpenStreetMap. OpenStreetMap is a collaborative project to create a free editable map of the world. During each timestep at the user defined interval
-Δ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
-point, gets caught, or becomes stranded. More information on the evacuation simulation can be found in the  (RMC 2021).
-
-LifeSim applies both natural variability and knowledge uncertainty through Monte Carlo analysis. Multiple parameters can be entered with uncertainty
-including those that influence the warning and evacuation timeline. Each iteration in a simulation represents a scenario that could occur given the
-data uncertainties in the model. The results of the analysis provide a distribution of estimated consequences from a given hazard.
-
-<CitationFootnote />
+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
+Guide and Technical Reference Manual provide some detailed information on how to use LifeSim. The Applications Guide walks through several real-life dam projects
+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;
+other applications walk through Flood Risk Management (FRM) and Coastal Storm Risk Management (CSRM) studies and how LifeSim was used to support plan formulation
+and decision-making.
+
+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>
+and <Link to="/docs/desktop-applications/lifesim/technical-reference-manual/v1.0/preface">LifeSim Technical Reference Manual</Link>. The Applications Guide is not
+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.
+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
+various types of studies and analyses.