E14 - Basic HAZUS Transportation Infrastructure
===============================================

+-----------------+------------------------------------------------------------+
| Download files  | :examplesgithub:`Download <E14BasicHAZUSTransportation/>`  |
+-----------------+------------------------------------------------------------+

This earthquake example demonstrates rapid analysis capabilities with the HAZUS earthquake damage and loss assessment methodology for transportation infrastructure. Asset-level Damage and Losses (D&L) are calculated directly from Intensity Measures (IM) for buildings, highway bridges, highway tunnels, and roadways. The IM field that represents ground shaking intensity measures in Alameda Island, CA, from an Mw7.05 event on the Hayward fault was obtained from Probabilistic Seismic Hazard Analysis (PSHA). The liquefaction-induced ground failure intensity measures (Permanent Ground Deformation) are calculated following the method proposed by Wang, C., Wang, D., & Chen, Q. (2021). Regional Evaluation of Liquefaction-Induced Lateral Ground Deformation for City-Scale Transportation Resilience Analysis. Journal of Infrastructure Systems, 27(2), 04021008.

.. figure:: r2dt-0014.png
   :width: 400px
   :align: center

This study will be defined by sequentially traversing the input panels of the **R2D** interface. However, as outlined in the online user's manual, these procedures can be serialized to and loaded immediately from a JSON file, which for this example may be found :examplesgithub:`here <E1BasicHAZUS/input.json>`.

#. **VIZ** The visualization panel in the following figure shows the location of the assets considered in this example.

   .. figure:: figures/r2dt-0014-VIZ.png
      :width: 600px
      :align: center


#. **GI** The unit system and asset type are prescribed in this panel. We select both Buildings and Transportation Network as asset types, and we are interested in the **building engineering demand parameters**, **damage measures**, and the resulting **decision variables**.

   .. figure:: figures/r2dt-0014-GI.png
      :width: 600px
      :align: center


#. **HAZ** Next, the hazard panel is used to load the event grid ``.csv`` file (:examplesgithub:`view on Github <E14BasicHAZUSTransportation/input_data/IMs/EventGrid.csv>`), which lists out the ground motions, which are used as the seismic hazard inputs in this example.

   .. figure:: figures/r2dt-0014-HAZ.png
      :width: 600px
      :align: center


#. **ASD** In the asset definition panel, the path to the :examplesgithub:`all_bldgs.csv <E14BasicHAZUSTransportation/input_data/all_bldgs.csv>` file is specified for buildings. 
For transportation infrastructure, the path to the :examplesgithub:`AI_hwy_inventory.geojson <E14BasicHAZUSTransportation/input_data/AI_hwy_inventory.geojson>` file is specified.
Once this file is loaded, the user can select which particular assets to include in the analysis by entering a valid range (e.g., 1-50) in the form and clicking **Select**. The ``all_bldgs.csv`` and ``AI_hwy_inventory.geojson``files include parameters for the damage and loss assessment (e.g., number of stories, year of built, occupancy class, structure type, and plan area) for the buildings and transportation infrastructure in the community.

   .. figure:: figures/r2dt-0014-ASD-building.png
      :width: 600px
      :align: center
   .. figure:: figures/r2dt-0014-ASD-transport.png
      :width: 600px
      :align: center


#. **HTA** Next, a hazard mapping algorithm is specified using the **Nearest Neighbor** method, which is configured as shown in the following figure with **100** samples in **4** neighbors, i.e., randomly sampling 100 ground motions from the nearest Ground Motion Grid points(each grid point has 1000 intensity measure realizations as specified in the **HAZ**).

   .. figure:: figures/r2dt-0014-HTA.png
      :width: 600px
      :align: center


#. **MOD** panel is not used for this procedure. The **Building Modeling** dropdown 
and **Transportation Components Modelling**should be left set to **None**.

   .. figure:: figures/r2dt-0014-MOD.png
      :width: 600px
      :align: center

#. **ANA** In the analysis panel, **IMasEDP** is selected from the primary dropdown for both Buildings and Transportation Network.

   .. figure:: figures/r2dt-0014-ANA.png
      :width: 600px
      :align: center


#. **DL** The damage and loss panel is now used to configure the **Pelicun** backend. The **HAZUS MH EQ IM** damage and loss method is selected and configured as shown in the following figure
for both Buildings and Transportation Network. 

   .. figure:: figures/r2dt-0014-DL.png
      :width: 600px
      :align: center


#. **UQ** For this example the **UQ** dropdown box should be set to **None**.

   .. figure:: figures/r2dt-0014-UQ.png
      :width: 600px
      :align: center
	  
#. **RV**

   The random variable panel will be left empty for this example.