ANA: Asset Analysis =================== In this panel, users can select specific applications for analyzing different asset classes. To choose an asset type, such as Buildings or Transportation Network, users interact with the **Asset Selection Ribbon** on the left side of the interface as depicted in :numref:`fig-R2DANAInputPanel`. This ribbon is initially hidden and becomes visible when multiple asset types are selected in the **GI: General Information** panel. Only assets marked in the **GI** panel will be listed in the **Asset Selection Ribbon**. Switching between assets updates the **Input Panel** to display the relevant analysis applications for the selected asset type. .. contents:: :local: .. _fig-R2DANAInputPanel: .. figure:: figures/R2DANAInputPanel.png :align: center :figclass: align-center Buildings analysis input panel. .. _lbl-ANABuildings: Buildings --------- For building analysis, the following applications are supported: - OpenSees - OpenSeesPy - IMasEDP - Capacity Spectrum Method - PreTrained Surrogate Models - CustomPy-Simulation - None OpenSees Analysis Model *********************** The **OpenSees** option performs structural analysis using OpenSees. If an "Analysis Script" argument is provided, the quantities defined with the graphical user interface will be ignored. .. _fig-R2DANAOpenSees: .. figure:: figures/R2DANAOpenSees.png :align: center :figclass: align-center :width: 800 OpenSees analysis option Following is an example of user-provided :download:`analysis script ` (.tcl) that additionally sets the "-fullGenLapack 1" flag on top of the selections shown in the above image. .. literalinclude:: src/ANA_OpenSees.tcl :language: tcl OpenSeesPy Analysis Model ************************* The **OpenSeesPy** application utilizes OpenSeesPy for structural analysis. IMasEDP Analysis Model ************************* The IMasEDP application directly uses the hazard intensity measure (IM) as the engineering demand parameter (EDP), bypassing structural analysis. Capacity Spectrum Method ************************* The **Capacity Spectrum Method** is a simplified method for estimating the seismic performance of structures. The method uses the capacity curve of the structure and the response spectrum of the ground motion to estimate the maximum response of the structure. The method is based on the assumption that the maximum response of the structure is the intersection of the capacity curve and the response spectrum. The method requires three inputs: the demand spectrum, the capacity curve, and the damping model. Demand Spectrum Model: ~~~~~~~~~~~~~~~~~~~~~~ The demand spectrum model is the response spectrum of the ground motion assuming a 5% damping ratio. The demand spectrum model defined in HAZUS [HAZUS2022]_ is implemented in R2D now. This model uses pesudo-spectrum acceleration at 0.3 seconds and 1.0 seonds as the anchor points and completes the spectrum using the method described in section 4.1.3.2 of [HAZUS2022]_, considering the earthquake magnitude. To use the HAZUS demand spectrum model, "SA_0.3" and "SA_1.0" should exist in the columns of the ground motion intensity measures defined in the **ASD** tab. Other demand spectrum model can be implemented by editing SimCenterBackendApplication Python script `here `_ or contacting the developers. .. [HAZUS2022] Federal Emergency Management Agency (FEMA) (2022) Hazus Multi-Hazard Loss Estimation Methodology: Earthquake Model (Hazus®-MH . Technical Manual 5.1). Washington, DC: Mitigation Division, Department of Homeland Security, Federal Emergency Management Agency. Capacity Curve Model: ~~~~~~~~~~~~~~~~~~~~~~ The capacity curve model proposed by Cao and Peterson [cao2006]_ is implemented in R2D. The model is an extension of the [HAZUS2022]_ capacity curve model. The model uses the capacity curve parameters (e.g. yield strength, yield displacement, ultimate strength, ultimate displacement etc.) to anchor the capacity curve of the structure. Further, an ecliptic passing the yield and ultimate points in [HAZUS2022]_ is used to complete the capacity curve. To use this model, all building information needed to classfify the building into a class defined in [HAZUS2022]_ should be provided in the **ASD** tab. `R2D Example 1 `_ provides an example of how to define the building inventory for the capacity curve model. The model is implemented in the SimCenterBackendApplication Python script `here `_. New capacity curve models can be implemented by editing the backend source code or contacting the developers. Damping Model: ~~~~~~~~~~~~~~~~~~~~~~ The capacity spectrum method requires a damping model to estimate the maximum response of the structure. The damping model proposed by Cao and Peterson [cao2006]_ is implemented in R2D. The model is an extension of the [HAZUS2022]_ capacity curve model. As defined in section 5.6 of [HAZUS2022]_, effective damping ratio is the sum of elastic damping and hysteretic damping. The effective damping ratio is estimated according to the building class defined in [HAZUS2022]_, and the hysteretic damping is estimated using the curve proposed by Cao and Peterson [cao2006]_. The effective damping is used to estimate the demand spectrum reduction parameters (See section 5.6.1.1 of [HAZUS2022]_) iteratively. The model is implemented in the SimCenterBackendApplication Python script `here `_. New damping models can be implemented by editing the backend source code or contacting the developers. .. [cao2006] Cao, T., & Petersen, M. D. (2006). Uncertainty of earthquake losses due to model uncertainty of input ground motions in the Los Angeles area. Bulletin of the Seismological Society of America, 96(2), 365-376. Pre-trained surrogate models **************************** The **Pre-trained surrogate model** is used to import the surrogate models trained using `EE-UQ `_. The surrogate model can take the parameters of structure (e.g. initial stiffness, post-yield stiffness, yield drift, construction year etc) and the intensity measures of recorded or stochastically generated ground motions (e.g. peak ground acceleration, peak spectral acceleration, significant duration etc.) as its input. .. panels:: :column: col-lg-12 col-md-12 col-sm-12 col-xs-12 p-2 .. figure:: figures/R2DANASurrogateWorkflow.png :align: center :figclass: align-center :width: 1200 Refer to `Step 1 `_ in the EE-UQ documentation for initial steps. Users must complete the *Surrogate Models* and *Default Analysis* tabs to use pre-trained surrogate models. .. _fig-R2DANASurrogateInputPanel: .. figure:: figures/R2DANASurrogateInput.png :align: center :figclass: align-center Buildings analysis input panel. .. role:: uqblue :uqblue:`Surrogate Models` * **Filter script**: A Python script provided by the user to assign surrogate models to buildings when multiple surrogate models representing different building types are provided. The script should contain a function named ``model distributor`` that processes dictionary inputs for general information (``GI``) and structural analysis model parameters (``SAM``), returning the surrogate model name or "Default". Below is an example of the filter script. .. literalinclude:: src/ANA_surrogate_filter.py Below are example keys and values of GI and SAM dictionaries that will be provided to the model. .. tabs:: .. tab:: GI .. literalinclude:: src/ANA_GI.json :language: json .. tab:: SAM (MDOF-Lu) .. literalinclude:: src/ANA_SAM.json :language: json * **Surrogate models**: surrogate model files in JSON (.json) format. Each surrogate model can be separately trained and exported in JSON format through EE-UQ. The surrogate models will take structural parameters (**structure information** and **structural analysis parameters computed in the modeling app** (specified in the MOD tab)), and **ground motion intensity parameters** as inputs. Below, we list the names of the parameters that will be passed to the surrogate model and its example values. When training a surrogate model through EE-UQ, make sure it only expects a subset of the structural variables listed below as inputs (The ground motion parameters are processed automatically internally, so users do not need to be concerned about naming rules on those variables). 1. Structure information - user-provided inventory data .. csv-table:: User-provided structure information :file: src/ANA_surrogate_GI.csv :header-rows: 1 :align: center :widths: 2, 1, 2,7 2. Structural properties - variables from the modeling (MOD) application (example for a 2-story building using MDOF-LU) .. csv-table:: Structural parameters estimated by structural modeling app (specified in the MOD tab) :file: src/ANA_surrogate_SAM.csv :header-rows: 1 :align: center :widths: 2, 1, 2, 7 Refer to :ref:`lbl-MODMDOFLu` for more details. Custom modeling apps should follow the specified format for "SAM.json". See :download:`here ` for an example of SAM.json file. 3. Ground motion parameters (automatically named internally both in EE-UQ and R2D) .. csv-table:: Ground motion parameters :file: src/ANA_surrogate_GM.csv :header-rows: 1 :align: center :widths: 2, 1, 2, 7 R2D ensures only the intensity measures specified during the training of the surrogate model are computed and utilized. :uqblue:`Default Analysis` Choose the analysis engine for cases where the **filter script** returns "Default". .. _lbl-ANATransport: Transportation Infrastructure Analysis --------------------------------------- IMasEDP Analysis Model ************************* Similar to buildings, the IMasEDP application for transportation infrastructure uses the hazard intensity measure (IM) directly as the engineering demand parameter (EDP), bypassing structural analysis.