.. _lbl-testbed_AC_example_outputs: ************************** Getting Started ************************** R2D Interface --------------- One approach to run the testbed simulation is via the `R2D application `_. After successfully downloading and launching, the major steps for setting up the run are listed as follows: #. Set the **Units** in the **GI** panel as shown in :numref:`r2d_gi` and check interested output files. .. figure:: figure/R2D_GI.png :name: r2d_gi :align: center :figclass: align-center :width: 500 R2D GI setup. #. Download and unzip the `HurricaneLaura_MappedPWS `_. Set the **Event File Listing Wind Field** in the **HAZ** panel to the "EventGrid.csv" in the unzipped "IMs" folder. The app would automatically load the directory (:numref:`r2d_haz`). And the **Units of Event Input File** should be "Miles per hour". .. figure:: figure/R2D_HAZ.png :name: r2d_haz :align: center :figclass: align-center :width: 500 R2D HAZ setup. #. Download the `BIM_LakeCharles_Full.csv `_ (under **01. Input: BIM - Building Inventory Data** folder). Select **CSV to BIM** in the **ASD** panel and set the **Import Path** to "BIM_LakeCharles_Full.csv" (:numref:`r2d_asd`). Specify the building IDs that you would like to include in the simulation. .. figure:: figure/R2D_ASD.png :name: r2d_asd :align: center :figclass: align-center :width: 500 R2D ASD setup. #. Set the **Regional Mapping** and **SimCenterEvent** in the **HTA** panel (e.g., :numref:`r2d_hta`). .. figure:: figure/R2D_HTA.png :name: r2d_hta :align: center :figclass: align-center :width: 500 R2D HTA setup. #. Set the "Building Modeling" in **MOD** panel to "None". .. figure:: figure/R2D_MOD.png :name: r2d_mod :align: center :figclass: align-center :width: 500 R2D MOD setup. #. Set the "Building Analysis Engine" in **ANA** panel to "IMasEDP". .. figure:: figure/R2D_ANA.png :name: r2d_ana :align: center :figclass: align-center :width: 500 R2D ANA setup. #. Set the "Damage and Loss Method" in **DL** panel to "HAZUS MH HU". Download the rulset scripts from `DesignSafe PRJ-3207 `_ (under **03. Input: DL - Rulesets for Asset Representation/scripts** folder) and set the **Auto populate script** to "auto_HU_LA.py" (:numref:`r2d_dl`). Note please place the rulset scripts in an individual folder so that the application could copy and load them later. .. figure:: figure/R2D_DL.png :name: r2d_dl :align: center :figclass: align-center :width: 500 R2D DL setup. #. Set the "UQ Application" in **UQ** panel to "None". .. figure:: figure/R2D_UQ.png :name: r2d_uq :align: center :figclass: align-center :width: 500 R2D UQ setup. After setting up the simulation, please click the **RUN** to execute the analysis. Once the simulation completed, the app would direct you to the **RES** panel (:numref:`r2d_res`) where you could examine and export the results. .. figure:: figure/R2D_RES.png :name: r2d_res :align: center :figclass: align-center :width: 500 R2D RES panel. For simulating the damage and loss for a large region of interest (please remember to reset the building IDs in **ASD**), it would be efficient to submit and run the job to `DesignSafe `_ on `Frontera `_. This can be done in R2D by clicking **RUN at DesignSafe** (one would need to have a valid `DesignSafe account `_ for login and access the computing resource). :numref:`r2d_run_ds` provides an example configuration to run the analysis (and please see `R2D User Guide `_ for detailed descriptions). The individual building simulations are paralleled when being conducted on Frontera which accelerate the process. It is suggested for the entire building inventory in this testbed to use 20 minutes with 96 Skylake (SKX) cores (e.g., 2 nodes with 48 processors per node) to complete the simulation. One would receive a job failure message if the specified CPU hours are not sufficient to complete the run. Note that the product of node number, processor number per node, and buildings per task should be greater than the total number of buildings in the inventory to be analyzed. .. figure:: figure/R2D_RUN.png :name: r2d_run_ds :align: center :figclass: align-center :width: 300 R2D - Run at DesignSafe (configuration). Users could monitor the job status and retrieve result data by **GET from DesignSafe** button (:numref:`r2d_get_ds`). The retrieved data include four major result files, i.e., *BIM.hdf*, *EDP.hdf*, *DM.hdf*, and *DV.hdf*. R2D also automatically converts the hdf files to csv files that are easier to work with. While R2D provides basic visualization functionalities (:numref:`r2d_res`), users could access the data which are downloaded under the remote work directory, e.g., */Documents/R2D/RemoteWorkDir* (this directory is machine specific and can be found in **File->Preferences->Remote Jobs Directory**). Once having these result files, users could extract and process interested information - the next section will use the results from this testbed as an example to discuss more details. .. figure:: figure/get_from_designsafe.png :name: r2d_get_ds :align: center :figclass: align-center :width: 400 R2D GET from DesignSafe. Sample Results --------------- The estimated wind-only, flood-only, and total losses under the four hurricane scenarios (:numref:`hurricane_cat`) are shown in :numref:`dl_c2` to :numref:`dl_c5`. .. figure:: figure/DL_category2.png :name: dl_c2 :align: center :figclass: align-center :width: 700 Estimated regional loss maps for the **Category 2** hurricane. .. figure:: figure/DL_category3.png :name: dl_c3 :align: center :figclass: align-center :width: 700 Estimated regional loss maps for the **Category 3** hurricane. .. figure:: figure/DL_category4.png :name: dl_c4 :align: center :figclass: align-center :width: 700 Estimated regional loss maps for the **Category 4** hurricane. .. figure:: figure/DL_category5.png :name: dl_c5 :align: center :figclass: align-center :width: 700 Estimated regional loss maps for the **Category 5** hurricane. Average expected loss ratios are also computed for individual cities, which are summarized in :numref:`cl_c2` to :numref:`cl_c5` .. figure:: figure/city_loss_c2.png :name: cl_c2 :align: center :figclass: align-center :width: 800 City-wise average expected loss ratios (**Category 2** hurricane). .. figure:: figure/city_loss_c3.png :name: cl_c3 :align: center :figclass: align-center :width: 800 City-wise average expected loss ratios (**Category 3** hurricane). .. figure:: figure/city_loss_c4.png :name: cl_c4 :align: center :figclass: align-center :width: 800 City-wise average expected loss ratios (**Category 4** hurricane). .. figure:: figure/city_loss_c5.png :name: cl_c5 :align: center :figclass: align-center :width: 800 City-wise average expected loss ratios (**Category 5** hurricane). For the top five cities with most assets in the building inventory, the average expected wind losses are computed for different built eras. Buildings before 1980s generally have relatively higher wind loss ratios where 1970s is found to be the worst decade for Atlantic City, Brigantine, and Galloway. Since 1980, the building performance is improved where the post-2000 buildings are found to behave much better than buildings in the other groups. .. figure:: figure/atlantic_wind_loss.png :name: wl_atlantic :align: center :figclass: align-center :width: 800 Average expected wind loss ratios (Atlantic City). .. figure:: figure/brigantine_wind_loss.png :name: wl_brigantine :align: center :figclass: align-center :width: 800 Average expected wind loss ratios (Brigantine). .. figure:: figure/galloway_wind_loss.png :name: wl_galloway :align: center :figclass: align-center :width: 800 Average expected wind loss ratios (Galloway). .. figure:: figure/margate_wind_loss.png :name: wl_margate :align: center :figclass: align-center :width: 800 Average expected wind loss ratios (Margate City). .. figure:: figure/ventor_wind_loss.png :name: wl_ventor :align: center :figclass: align-center :width: 800 Average expected wind loss ratios (Ventor City). The results from the loss estimation for each scenario above (Category 2-5) and each available inventory, can be accessed (:numref:`example_results`). .. list-table:: Access points for example results :name: example_results :header-rows: 1 :align: center * - Scenario - Inventory Options - Location * - Scaled Category 2 - Flood-Exposed Inventory, Exploration Inventory - `Category2.zip `_ * - Scaled Category 3 - Flood-Exposed Inventory, Exploration Inventory - `Category2.zip `_ * - Scaled Category 4 - Flood-Exposed Inventory, Exploration Inventory - `Category2.zip `_ * - Category 5 - Flood-Exposed Inventory, Exploration Inventory - `Category2.zip `_