diff --git a/Examples/pbdl-0000/README.rst b/Examples/pbdl-0000/README.rst index b87c56d..6a88141 100644 --- a/Examples/pbdl-0000/README.rst +++ b/Examples/pbdl-0000/README.rst @@ -18,6 +18,7 @@ For the moment frame and stick model, the columns of each story are provided a u .. figure:: figures/LA_3Story.png :align: center + :alt: "Technical architectural drawings and specifications for a 3-story building. Image includes three diagrams labeled as PLAN, ELEVATION, and MOMENT FRAMES. The Plan view shows a top-down layout with 6 bays at 30 feet by 4 bays at 30 feet, one section is shaded. The Elevation view details a side profile of a building with multiple floors and foundational supports. The Moment Frames diagram shows a grid with columns labeled A to E. Below the images, tables list structural components for the NS Moment Resisting Frame and NS Gravity Frames, specifying different sizes and types of columns, beams, and girder plates for various stories." :width: 400 :figclass: align-center diff --git a/Examples/pbdl-0001/README.rst b/Examples/pbdl-0001/README.rst index c59791f..a14f4b9 100644 --- a/Examples/pbdl-0001/README.rst +++ b/Examples/pbdl-0001/README.rst @@ -11,6 +11,7 @@ The demands and the performance model for this example are based on the example .. figure:: figures/P58_background_doc.png :align: center + :alt: Cover page of a technical document titled "PACT Beta Test Example: Building B Reinforced Concrete Special Moment Frame Building." The top right corner has a sidebar titled "Background Document FEMA P-58/BD-3.7.15." The cover features two images showing books on seismic performance assessment of buildings, overlaid with the FEMA and ATC logos. The document is prepared by Curt Haselton and Travis Churpalo of California State University, Chico, and submitted to the Applied Technology Council and prepared for the Federal Emergency Management Agency. The address of FEMA in Washington, D.C. is provided at the bottom. :width: 400 :figclass: align-center @@ -24,6 +25,7 @@ The first tab in the **DL** panel defines the asset model. The asset model assig .. figure:: figures/asset_model.png :align: center + :alt: Screenshot of a software interface titled "Damage and Loss Assessment" from the Pelicun application. On the left, a vertical navigation bar with menu options: UQ, GI, SIM, EVT, FEM, RV, DL, and RES with 'DL' highlighted. The main area of the interface includes tabs for Asset, Demands, Damage, and Losses, with "General Information" including fields for "Number of Stories" and "Plan Area" as well as a drop-down for "Occupancy Type". Below is a "Component Assignment" section with Load and Save buttons, lists for available and assigned components, and buttons to add or remove these components. In the bottom pane, there's a detailed entry for a wall partition component, including type, quantity, blocks, and additional specifications. :figclass: align-center The asset model can consider uncertainties in the types of components assigned and in their quantities. This example does not introduce those uncertainties for the sake of simplicity. Consequently, for this example, the component types and their quantities are identical in all realizations. @@ -32,6 +34,7 @@ Pelicun provides a convenience method for defining the asset model. We can prepa .. figure:: figures/component_table.png :align: center + :alt: A screenshot of an Excel spreadsheet filled with various data related to construction or engineering. The spreadsheet contains columns labeled ID, Units, Location, Direction, Theta_0, Blocks, Family, Theta_1, and Comment, with corresponding entries in rows beneath. The data includes references to architectural components, measurements, and types of installations like HVAC, piping, and fire sprinkler systems. The spreadsheet layout is standard with grid lines separating the cells, and some column headers are highlighted in gray. :figclass: align-center The tabular information in the csv file follows the information provided at the bottom of the Asset Model panel where the selected component is assigned to various locations and directions in the building. @@ -45,12 +48,14 @@ The first tab defines the demand model.Under ``Data Source`` we specified that t .. figure:: figures/demand_model.png :align: center + :alt: Screenshot of a software interface titled "Damage and Loss Assessment" from a tool called "Pelican". The interface includes several panels with options for inputting data and configuring analysis parameters. The left panel has a vertical navigation bar with the selected option "DL". The main window is split into tabs labeled "Asset", "Demands", "Damage", and "Losses". The "Demands" tab is active, displaying sections for "Data Source", where a file can be chosen, "Stochastic Model" with drop-down options for distribution type, and configurable truncation and collapse limits. On the right, there is a "Sample" section for setting sample size and raw data usage, as well as "Residual Drifts" where drift ratios for two different directions can be inputted, referencing FEMA P-58 for inference. The design is clean with a color scheme of blues, grays, and white. :figclass: align-center Demand distribution data was extracted from the FEMA P-58 background documentation referenced in the Introduction. The nonlinear analysis results from Figures 1-14 – 1-21 provide the 10th percentile, median, and 90th percentile of EDPs in two directions on each floor at each intensity level. We used that information to fit a lognormal distribution and sample 50 realizations of EDPs that follow the data provided for stripe #4 in the original example. The EDP data is stored in the ``demands_s4.csv`` file: .. figure:: figures/demand_data.png :align: center + :alt: An Excel spreadsheet filled with numerical data across columns labeled from A to K and rows numbered from 1 to 23. Each cell contains a decimal value, with data organized in a systematic, tabular format. This appears to be some sort of dataset, possibly related to scientific or statistical research. :figclass: align-center The header of the table uses the standard SimCenter demand naming convention to identify the type, location, and direction of each EDP. Each row corresponds to one realization - such data typically would come from dynamic analysis. @@ -66,6 +71,7 @@ We use the Damage Model tab to extend the above dataset with two Global Vulnerab .. figure:: figures/damage_model.png :align: center + :alt: Screenshot of a software interface for Damage and Loss Assessment with various tabs and parameters. The main section is titled "Pelican" with tabs for Asset, Demands, Damage, and Losses. Subsections titled "Global Vulnerabilities" list parameters such as 'Irreparable Damage' with median and log standard deviation sliders, and 'Collapse' with inputs for Demand, Capacity, Distribution, and Theta 1. "Damage Process" shows an approach dropdown menu with selection "FEMA P-58". On the left side, there's a vertical menu with options UQ, GI, SIM, EVT, FEM, RV, DL (highlighted), and RES. :figclass: align-center @@ -83,6 +89,7 @@ Consequence modeling is decoupled from damage modeling in Pelicun. The Loss Mode .. figure:: figures/loss_model.png :align: center + :alt: Screenshot of a damage and loss assessment interface titled "Pelican" with various input sections for an asset's demands, damage, and losses. It includes fields for global consequences cost and time with editable parameters such as unit, median, distribution, and θ. The cost is set to "USD_2011" with a median value of "12500000" and a normal distribution, whereas the time is measured in "worker_day" with a median value of "15000" and a lognormal distribution. There are checkboxes for replacement, an export database button that says "Export DB," and dropdown menus for selecting consequence data and mapping approach. The sidebar contains vertical tabs labeled UQ, GI, SIM, EVT, FEM, RV, DL, and RES, with the DL tab highlighted. :figclass: align-center We use this panel to add a replacement consequence to the FEMA P-58 dataset. This defines a replacement cost and time and the automatic mapping links these consequences with the collapse and irreparable damage events. Note that the replacement consequences are defined using random variables in this example to capture the uncertainty in those numbers. The deterministic replacement values that FEMA P-58 uses can be reproduced in PBE by choosing N/A for the Distribution of Cost and Time. @@ -95,11 +102,13 @@ Once the performance assessment has been set up in the **DL** panel, click on th .. figure:: figures/1_RES_summary.png :align: center + :alt: Screenshot of a data summary table with columns for Decision Variable, Probability, Mean, Standard Dev., and Log Standard Dev. Listed decision variables are 'repair cost,' 'repair time - parallel,' 'repair time - sequential,' 'collapsed?,' and 'irreparable?' with numerical values provided for mean and standard deviations for cost and repair times, and probability values for 'collapsed?' and 'irreparable?' options. :figclass: align-center .. figure:: figures/1_RES_data.png :align: center + :alt: A screenshot of a computer interface displaying a bar chart and a data table. The bar chart is labeled "Frequency %" on the y-axis and "repair cost" on the x-axis, with figures ranging from approximately 3.07 million to 22.26 million. Bars of various heights represent different frequencies, with the first and fourth bars being the tallest. Below the chart, there's a table with columns named "repair cost," "pair time - paral," "air time - sequer," "collapsed?" and "irreparable?" Rows with numeric data correspond to these columns. The interface includes tabs labeled "Summary" and "Data Values," with the "Data Values" tab currently selected. :figclass: align-center -In the **Data** tab of the **RES** panel, we are presented with both a graphical plot and a tabular listing of the data. By left- and right-clicking on the individual columns the plot axis changes (left mouse click controls vertical axis, right mouse click the horizontal axis). If a singular column of the tabular data is selected with both right and left mouse buttons, a frequency and CDF plot will be displayed. +In the **Data** tab of the **RES** panel, we are presented with both a graphical plot and a tabular listing of the data. By left- and right-clicking on the individual columns the plot axis changes (left mouse click controls vertical axis, right mouse click the horizontal axis). If a singular column of the tabular data is selected with both right and left mouse buttons, a frequency and CDF plot will be displayed. \ No newline at end of file diff --git a/Examples/pbdl-0002/README.rst b/Examples/pbdl-0002/README.rst index 972ed4e..9ad944e 100644 --- a/Examples/pbdl-0002/README.rst +++ b/Examples/pbdl-0002/README.rst @@ -7,6 +7,7 @@ This study explores a simple uncertainty propagation problem in the following th .. figure:: figures/model3.png :align: center + :alt: A diagram showing a simplified representation of a structure with three rigid beams connected by what appear to be pivots or joints, indicated by circles, aligned vertically. The uppermost joint is labeled "w/2," and the lower two are each labeled "w," suggesting a distribution of forces or weights. The base of the structure is attached to a surface indicated by shaded diagonal lines, which may represent it being fixed or anchored. The words "Rigid beams" are noted to the right side of the structure, emphasizing its construction. The background is solid black, and the diagram is depicted in white lines and text for contrast. :width: 400 :figclass: align-center @@ -24,6 +25,7 @@ This panel provides an interface to various forward propagation procedures which .. figure:: figures/2_UQ.png :align: center + :alt: Screenshot of a graphical user interface for a software program with a sidebar and a main content area. The sidebar includes the acronyms UQ, GI, SIM, EVT, FEM, RV, DL, and RES in white text against a dark background, which are likely navigation menu items or module names. The main content area displays settings related to the "UQ Engine" with "Dakota" selected from a dropdown menu. There is a section titled "Dakota Method Category" with "Forward Propagation" selected, followed by options to choose a method ("LHS" currently selected), set the number of samples ("40"), and input a seed value ("867"). Lastly, checkboxes for "Parallel Execution" and "Save Working dirs" are visible with "Parallel Execution" checked. The layout suggests that this is a configuration panel for running uncertainty quantification (UQ) simulations or analyses. :figclass: align-center Step 2: GI @@ -35,6 +37,7 @@ It is important to review and specify the desired Units for the calculation here .. figure:: figures/2_GI.png :align: center + :alt: Screenshot of a user interface showing "Building Information" with fields for name, properties (including year built, number of stories, structural type, height, width, depth, and plan area), location (latitude and longitude), and units (force in kips, length in inches, and temperature in Celsius). The building name is entered as "Test", the year built is "1990", and it has "3" stories with a "RM1" structural type. No image of the actual building is present, just the data entry interface. :figclass: align-center @@ -47,6 +50,7 @@ This model could have random properties that we could sample and propagate the c .. figure:: figures/2_SIM.png :align: center + :alt: Screenshot of a Building Model Generator software interface displaying various input fields and parameters for engineering simulations. The left panel shows a selection menu with options like UQ, GI, SIM, EVT, among others highlighted, with SIM currently selected. The central panel titled "Building Information" includes data input fields for properties such as Number of Stories, Floor Weights, Story Stiffness in X and Y directions, Yield Strength, Damping Ratio, and others, with numerical values entered. To the right is a simple representation of a multi-degree of freedom (MDOF) system with three horizontal blue squares, symbolizing floor masses, connected by vertical lines, indicating the building model's response to simulations. :figclass: align-center @@ -60,6 +64,7 @@ The Vlachos et al. (2018) model generates ground motion time histories based on .. figure:: figures/2_EVT.png :align: center + :alt: Screenshot of a software interface titled "Load Generator" for a Stochastic Ground Motion simulation. The interface shows a selected stochastic loading model referencing Vlachos et al. (2018), along with input fields for Moment Magnitude (set to 7), Closest-to-Site Rupture Distance in kilometers (set to 40), and Average shear-wave velocity for the top 30 meters in meters per second (labeled 'vs'), with a radio button for providing a seed value (set to 500). There is a navigation sidebar on the left with various options like UQ, GI, SIM, EVT (selected), FEM, RV, DL, and RES. :figclass: align-center @@ -70,6 +75,7 @@ We now proceed to the **FEM** panel where we can adjust settings for running the .. figure:: figures/2_FEM.png :align: center + :alt: Screenshot of a user interface for a finite element application named OpenSees. The panel is showing various input fields classified under headings like Analysis, Integration, Algorithm, ConvergenceTest, Solver, Damping Model, and Selected Tangent Stiffness. Each category has predetermined choices or numerical inputs, with a 'Choose' button at the bottom right. On the left sidebar, 'FEM' is highlighted, indicating the current section the user is in, with other sections like UQ, GI, SIM, EVT, RV, DL, and RES listed above and below. :figclass: align-center @@ -80,6 +86,7 @@ Now in the **RV** panel we will enter the distributions and values for our rando .. figure:: figures/2_RV.png :align: center + :alt: Screenshot of a software interface for inputting random variables. On the left side is a vertical menu with options including UQ, GI, SIM, EVT, FEM, RV (highlighted in blue), DL, and RES. The main panel is titled "Input Random Variables" with fields for Variable Name (populated with 'vs'), Distribution (set to 'Normal'), Mean (set to '400'), and Standard Deviation (set to '100'). There are buttons for 'Add', 'Clear All', 'Correlation Matrix', 'Show PDF', 'Export', and 'Import'. The background and menu are dark gray, while the main panel has a white background with blue highlights. :figclass: align-center .. warning:: @@ -97,24 +104,28 @@ Because Hazus components are assigned at the building level, there is only one p .. figure:: figures/2_DL_asset.png :align: center + :alt: Screenshot of a damage and loss assessment software interface with various sections for inputting information about a building's characteristics and components. The General Information section includes fields for 'Number of Stories' and 'Plan Area'. A section for Component Assignment is shown with buttons for 'Load', 'Save', 'Add', 'Add All', 'Remove', 'Remove All', and lists 'Available in DB' and 'Assigned' components. There is a portion labeled 'Databases' with a dropdown menu for 'Component Vulnerability' currently set to 'Hazus Earthquake' and a button to 'Export DB'. The interface also includes vertical navigation tabs on the left side with labels such as UQ, GI, SIM, EVT, FEM, RV, DL, and RES, with the DL tab highlighted. :figclass: align-center Under the Demands tab, we specify that the demand data is provided by the Workflow automatically; we assume that demands follow a multivariate lognormal distribution. After fitting such a distribution to the data, we sample 500 demand realizations for damage and loss assessment. .. figure:: figures/2_DL_demands.png :align: center + :alt: Screenshot of a user interface for a 'Damage and Loss Assessment' application named Pelicun. The interface includes tabs for inputs categorized under Asset, Demands, Damage, and Losses. Current visible settings include 'Data Source' with 'Demand Data: from Workflow,' 'Stochastic Model' with 'Distribution: fit lognormal,' checkboxes for 'Add Uncertainty' and 'Remove collapses,' 'Sample' with 'Sample Size' of 500 and a checkbox for 'Directly use raw demand data,' and 'Residual Drifts' with a setting 'do not infer.' On the left side, there's a vertical menu with the options UQ, GI, SIM, EVT, FEM, RV, DL (highlighted), and RES. :figclass: align-center The Damage tab setup is simple when the Hazus earthquake methodology is used because this method includes collapse in the structure component damage states and does not consider irreparable damage. The Damage Process employed by this method is included in PBE and selected for this example. .. figure:: figures/2_DL_damage.png :align: center + :alt: Screenshot of a user interface for a damage and loss assessment application named Pelicun with a menu on the left side showing acronyms UQ, GI, SIM, EVT, FEM, RV, DL, RES with 'DL' highlighted, indicating the current section. The main panel has tabs labeled 'Asset,' 'Demands,' 'Damage,' 'Losses' and sections titled 'Global Vulnerabilities' with checkboxes for 'Irreparable Damage' and 'Collapse,' and 'Damage Process' with a dropdown menu set to 'Hazus Earthquake.' The interface has a clean, professional layout with a grey and teal color scheme. :figclass: align-center Losses are calculated using the included Hazus Earthquake consequence functions for repair costs and an Automatic mapping between damaged components and consequence models. This mapping uses the occupancy type and component types specified in the Asset tab earlier and selects the corresponding consequence functions following the Hazus methodology. .. figure:: figures/2_DL_loss.png :align: center + :alt: Screenshot of a Damage and Loss Assessment software interface titled "Pelicun" displaying various tabs and options for analysis, including a selected tab labeled 'DL' on the left sidebar, and categories such as Asset, Demands, Damage, and Losses with subcategories like Repairs, Global Consequences, Database, and Mapping on the main panel. An option to export the database is visible, and the dropdown menu shows "Hazus Earthquake" as the selected consequence data. :figclass: align-center Analysis & Results @@ -124,11 +135,13 @@ Once a full workflow has been defined click on the **Run** button. When the anal .. figure:: figures/2_RES_summary.png :align: center + :alt: A screenshot of a computer interface displaying a summary table with decision variables related to repair scenarios. The variables include "repair cost," "repair time - parallel," "repair time - sequential," "collapsed?" and "irreparable?" with corresponding statistical values for probability, mean, standard deviation, and log standard deviation. Some fields are filled with numerical data, while others are marked with dashes or "N/A" to indicate unavailable information. :figclass: align-center .. figure:: figures/2_RES_data.png :align: center + :alt: A screenshot showing a software interface with a bar chart and a data table. The bar chart is labeled "Frequency %" on the y-axis and "repair cost" on the x-axis, with bars representing different frequencies at varying repair cost intervals. The data table beneath the chart lists numerical values across columns with headers such as "repair cost," "pair time - paral," "air time - sequer," "collapsed?" and "irreparable?" The interface also includes a sidebar with various menu options like UQ, GI, SIM, EVT, FEM, RV, DL, and RES highlighted in turquoise. :figclass: align-center -In the **Data** tab of the **RES** panel, we are presented with both a graphical plot and a tabular listing of the data. By left- and right-clicking on the individual columns the plot axis changes (left mouse click controls vertical axis, right mouse click the horizontal axis). If a singular column of the tabular data is selected with both right and left mouse buttons, a frequency and CDF plot will be displayed. +In the **Data** tab of the **RES** panel, we are presented with both a graphical plot and a tabular listing of the data. By left- and right-clicking on the individual columns the plot axis changes (left mouse click controls vertical axis, right mouse click the horizontal axis). If a singular column of the tabular data is selected with both right and left mouse buttons, a frequency and CDF plot will be displayed. \ No newline at end of file diff --git a/Examples/pbdl-0003/README.rst b/Examples/pbdl-0003/README.rst index 5debd20..1c96203 100644 --- a/Examples/pbdl-0003/README.rst +++ b/Examples/pbdl-0003/README.rst @@ -11,6 +11,7 @@ The demands and the performance model for this example are based on the example .. figure:: figures/P58_background_doc.png :align: center + :alt: Cover page of a technical document titled "Background Document FEMA P-58/BD-3.7.15 PACT Beta Test Example: Building B Reinforced Concrete Special Moment Frame Building." It includes two inset images of another document called "Seismic Performance Assessment of Buildings," with one showing a collapsed ceiling and the other the cover. Prepared by Curt Haselton and Travis Churapalo from California State University, Chico, and submitted to the Applied Technology Council and the Federal Emergency Management Agency (FEMA). The page features logos of FEMA, ATC, and California State University, Chico. :width: 400 :figclass: align-center @@ -18,6 +19,7 @@ The recovery methodology in this example is based on the `REDi Recovery Engine < .. figure:: figures/REDi_background_doc.png :align: center + :alt: The image shows the cover of a white report titled "REDi™ Rating System" described as "Resilience-based Design Initiative for the Next Generation of Buildings - EARTHQUAKE EDITION." A graphic resembling a seismograph reading symbolizing an earthquake is prominently displayed in red across the mid-section of the cover. At the bottom right, there is text indicating "Version 1.0 November 2019." The cover features a clean, minimalistic design with a black and red color scheme. :width: 400 :figclass: align-center @@ -31,6 +33,7 @@ The first tab in the **DL** panel defines the asset model. The asset model assig .. figure:: figures/asset_model.png :align: center + :alt: Screenshot of a "Damage and Loss Assessment" software interface with tabs for Asset, Demands, Damage, Losses, and Outputs. The section shown includes "General Information" with fields for "Number of Stories" set to 4 and "Plan Area" set to 15000 square feet, among others. "Component Assignment" features buttons for loading and saving, with options to add or remove components from a database, listed as "FEMA P-58." Detailed component information, including descriptions and notes, is provided in a structured format at the bottom of the interface. The interface appears to be used for assessing building components' vulnerability and response to damage. :figclass: align-center The asset model can consider uncertainties in the types of components assigned and in their quantities. This example does not introduce those uncertainties for the sake of simplicity. Consequently, for this example, the component types and their quantities are identical in all realizations. @@ -39,6 +42,7 @@ Pelicun provides a convenience method for defining the asset model. We can prepa .. figure:: figures/component_table.png :align: center + :alt: A screenshot of a spreadsheet displaying various rows of data detailing construction information. Each row contains multiple fields such as ID, Units, Location, Direction, Theta, Blocks, Family, Theta_1, and Comment. The cells are filled with alphanumeric text and numbers that seem to be specifications, such as dimensions for construction materials, types of installations, and comments that provide additional details like "Midrise stick-built curtain wall" or "HVAC Stainless Steel Ducting." The spreadsheet is partially visible and the text is in a clear, readable font on a white background with grid lines separating each cell. :figclass: align-center The tabular information in the csv file follows the information provided at the bottom of the Asset Model panel where the selected component is assigned to various locations and directions in the building. @@ -52,12 +56,14 @@ The first tab defines the demand model.Under ``Data Source`` we specified that t .. figure:: figures/demand_model.png :align: center + :alt: Screenshot of a software interface titled "Damage and Loss Assessment" with various tabs such as Asset, Demands, Damage, Losses, and Outputs. The current view shows settings for data source with "Demand Data: from File" selected, and a probabilistic model with "Distribution: fit truncated lognormal" chosen, an option to remove collapses checked, and a section for PID with a value of 0.06. To the right, there's a section for defining sample size, with the number 500 entered, and another option to infer residual drifts as per FEMA P-58. The interface has a clean, professional look with shades of blue and gray. :figclass: align-center Demand distribution data was extracted from the FEMA P-58 background documentation referenced in the Introduction. The nonlinear analysis results from Figures 1-14 – 1-21 provide the 10th percentile, median, and 90th percentile of EDPs in two directions on each floor at each intensity level. We used that information to fit a lognormal distribution and sample 50 realizations of EDPs that follow the data provided for stripe #4 in the original example. The EDP data is stored in the ``demands_s4.csv`` file: .. figure:: figures/demand_data.png :align: center + :alt: A screenshot showing a spreadsheet filled with numerical data. Each cell in the spreadsheet contains a decimal number, and the columns are labeled from A to K with headers such as "1-PFA-0-1", "1-PFA-0-2", and so on up to "1-PFA-4-2". The rows are numbered from 1 to 23 on the left side, indicating different data entries or measurements. The numbers are in a variety of ranges, indicating a dataset possibly used for analysis or reporting purposes. :figclass: align-center The header of the table uses the standard SimCenter demand naming convention to identify the type, location, and direction of each EDP. Each row corresponds to one realization - such data typically would come from dynamic analysis. @@ -73,6 +79,7 @@ We use the Damage Model tab to extend the above dataset with two Global Vulnerab .. figure:: figures/damage_model.png :align: center + :alt: Screenshot of a software interface for damage and loss assessment. The interface is divided into two sections with tabs such as 'Global Vulnerabilities' and 'Damage Process'. Under Global Vulnerabilities, options like 'Irreparable Damage' with median and log standard deviation sliders, and 'Collapse' with demand, capacity, and distribution parameters are visible. The Damage Process section indicates the approach used, labeled 'FEMA P-58'. The interface has a sidebar with various options including UQ, GI, SIM, EVT, FEM, RV, DL, PRF, and RES highlighted in different shades of blue and gray. :figclass: align-center @@ -90,6 +97,7 @@ Consequence modeling is decoupled from damage modeling in Pelicun. The Loss Mode .. figure:: figures/loss_model.png :align: center + :alt: Screenshot of a damage and loss assessment software interface with multiple tabs, including 'Asset', 'Demands', 'Damage', 'Losses', 'Outputs', and 'Repairs'. The focus is on the 'Repairs' section, showing 'Component Repair Consequences' with options to select from a FEMA P-58 database and 'Repair Consequence Types', including repair cost, repair time, and embodied carbon and energy in repairs. Below, there is a section for 'Available Consequence Models' displaying details on bolted shear tab gravity connections. Further down, a section titled 'Global Consequences' is partially visible with options for replacement, while 'Mapping' with an approach option set to 'Automatic' can be seen at the bottom of the interface. :figclass: align-center We use this panel to add a replacement consequence to the FEMA P-58 dataset. This defines a replacement cost and time and the automatic mapping links these consequences with the collapse and irreparable damage events. Note that the replacement consequences are defined using random variables in this example to capture the uncertainty in those numbers. The deterministic replacement values that FEMA P-58 uses can be reproduced in PBE by choosing N/A for the Distribution of Cost and Time. @@ -102,6 +110,7 @@ For the recovery performance assessment, the `REDi Recovery Engine `_ section in the REDi documentation. @@ -114,11 +123,13 @@ Once the performance assessment has been set up, click on the **Run** button. Wh .. figure:: figures/1_RES_summary.png :align: center + :alt: Screenshot of a spreadsheet with statistical data analysis, featuring columns labeled 'Decision Variable,' 'Probability,' 'Mean,' 'Standard Dev.,' 'Log Standard Dev.,' 'Minimum,' '10th Percentile,' 'Median,' '90th Percentile,' and 'Maximum.' Rows include various metrics such as 'Embodied Carbon in Repairs,' 'Repair Cost,' 'Embodied Energy in Repairs,' 'Repair Time - parallel,' 'Repair Time - sequential,' and categories under 'RES' with probabilities for 'Collapsed?' and 'Irreparable?' and recovery values under 'REDi Recovery' for 'Full Recovery,' 'Functional Recovery,' 'Immediate Occupancy,' and 'Max delay.' Each metric contains numerical data, some cells are empty indicated by a dash. :figclass: align-center .. figure:: figures/1_RES_data.png :align: center + :alt: A screenshot of a computer interface displaying a scatter plot with many blue data points spread vertically across a set of horizontal axis values. The y-axis is labeled as "Repair Times - sequential" with values ranging from 0 to approximately 47000, and the x-axis seems to have numerical values from around 0 to 500, but the exact parameter is not visible. Below the graph, there's a section showing a data table with columns titled "id," "Carbon in Rc," "Repair Cost," "Energy in Rc repair Time - parallel," "repair Time - sequential," "Collapsed?," and "Irreparable?" with numerical values in each cell, indicating detailed data corresponding to the graph above. The interface tabs suggest viewing options such as "Summary" and "Data Values." :figclass: align-center In the **Data** tab of the **RES** panel, we are presented with both a graphical plot and a tabular listing of the data. By left- and right-clicking on the individual columns the plot axis changes (left mouse click controls vertical axis, right mouse click the horizontal axis). If a singular column of the tabular data is selected with both right and left mouse buttons, a frequency and CDF plot will be displayed. \ No newline at end of file