Skip to content

Commit

Permalink
bc - Added alt text to Example RST files using GPT4-Vision
Browse files Browse the repository at this point in the history
  • Loading branch information
bacetiner committed May 30, 2024
1 parent 3392623 commit a900d78
Show file tree
Hide file tree
Showing 13 changed files with 158 additions and 0 deletions.
1 change: 1 addition & 0 deletions Examples/eeuq-0000/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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: A black and white technical drawing with three sections labeled PLAN, ELEVATION, and MOMENT FRAMES, representing a 3-story building's structural design. The PLAN shows a top view with a grid indicating 6 bays at 30 feet by 4 bays at 30 feet, one shaded area in the grid center. The ELEVATION depicts the side view of a building with three levels on support columns. The MOMENT FRAMES show another grid with labeled columns A through E. Below the diagrams, tables list the specifications for columns and beams for the North-South moment resisting frame and gravity frames, including steel beam designations like W14X257 and girder sizes like W30X116.
:width: 400
:figclass: align-center

Expand Down
17 changes: 17 additions & 0 deletions Examples/eeuq-0001/README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ Consider the problem of uncertainty quantification for a three-story shear build

.. figure:: figures/model2.png
:align: center
:alt: A diagram depicting a structure with three horizontally aligned rigid beams, each separated by an equally distributed vertical force labeled "w". At the top beam, the force is labeled "w/2". The beams are supported on each end by a symbol indicating a fixed support, and the structure appears to be a simplified representation of a statically determinate beam or bridge under distributed loads.
:width: 400
:figclass: align-center

Expand Down Expand Up @@ -47,6 +48,7 @@ To perform a Sampling or Forward propagation uncertainty analysis the user would

.. figure:: figures/shearUQ.png
:align: center
:alt: Screenshot of a user interface with a left-side menu showing categories like UQ, GI, SIM, EVT, FEM, EDP, RV, and RES. On the right, there is a section titled "UQ Engine" with a dropdown menu selecting "Dakota," another dropdown for "Dakota Method Category" selecting "Forward Propagation," with options below for "Method" choosing "LHS," a field to input the number of samples (set to 1000), and a field for the seed value (set to 20). The interface has a clean design with mainly blue and gray colors.
:figclass: align-center

.. note::
Expand All @@ -59,6 +61,7 @@ To perform a Sampling or Forward propagation uncertainty analysis the user would

.. figure:: figures/shearSIM.png
:align: center
:alt: Screenshot of a Building Model Generator software interface with various input fields for defining building specifications such as number of stories, floor weights, story heights, and stiffness values. On the right side of the screen is a diagram representing a multi-degree of freedom (MDOF) model of a building with three levels, indicated by blue squares, and a vertical line representing the structure's height.
:figclass: align-center

.. note::
Expand All @@ -67,18 +70,21 @@ To perform a Sampling or Forward propagation uncertainty analysis the user would

.. figure:: figures/shearSIM-OpenSees.png
:align: center
:alt: Screenshot of a Building Model Generator software interface showing a selected file path for an Input Script labeled "ShearBuilding3.tcl", fields for specifying Response Nodes, Spatial Dimension, and Degrees Of Freedom (DOF) at Nodes. There are tabs on the left side for various modules like UQ, GI, SIM, EVT, FEM, EDP, RV, and RES, with SIM currently selected or highlighted. A drop-down menu at the top right corner indicates the software is integrated with or supports OpenSees.
:figclass: align-center

4. Next select the **EVT** panel. From the **Load Generator** pull-down menu select the **Multiple PEER** option. This will present a panel with three buttons: **Add**, **Remove** and **Load Directory**. Click the **Add** button. Give the motion a name, here enter ``elCentro`` in the first line edit. Now for the motion, enter the path to the ``elCentro.AT2`` motion. Leave the motion acting in the **1** dof direction and for the scale factor in this direction, enter **factorEC**.

.. figure:: figures/shearEVT.png
:align: center
:alt: A screenshot of a software interface with a sidebar on the left containing menu items such as UQ, GI, SIM, EVT (highlighted), FEM, EDP, RV, and RES. The main area is titled "Load Generator" and includes a dropdown menu with the option "Multiple PEER" selected, a section titled "List of PEER Events" with a radio button option labeled "elCentro" and another radio button option next to a file path input box. There are buttons labeled "Add," "Remove," and "Load Directory," as well as a "Choose" button next to the file path. At the end, there are input boxes for "DOF" with a value of "1" and a "Factor" labeled "factorEC." The interface appears to be for configuring events, possibly for engineering simulations or analyses.
:figclass: align-center

5. Next choose the **FEM** panel. Here we will change the entries to use Rayleigh damping, with Rayleigh factor chosen using the first and third modes. For the **MDOF** model generator, because it generates a model with two translational and one rotational degree-of-freedom in each direction and because we have provided the same ``k`` values in each translational direction (i.e. we will have duplicate eigenvalues), we specify as shown in the figure modes **1** and **6**.

.. figure:: figures/shearFEM.png
:align: center
:alt: Screenshot of a software interface for finite element application with various parameter fields. The dropdown at the top is set to "OpenSees." The parameters include settings for "Analysis," "Integration," "Algorithm," "ConvergenceTest," "Solver," "Damping Model," "Damping Ratio," "Selected Tangent Stiffness," and modes 1 and 2 with numerical input fields. There's also a field for "Analysis Script" at the bottom. The interface has a sidebar with tabs labeled "UQ," "GI," "SIM," "EVT," "FEM," "EDP," "RV," "RES," with the "FEM" tab highlighted.
:figclass: align-center

.. note::
Expand All @@ -87,6 +93,7 @@ To perform a Sampling or Forward propagation uncertainty analysis the user would

.. figure:: figures/shearFEM-OpenSees.png
:align: center
:alt: Screenshot of a software interface with the title "FE Application" selected from a menu. The interface is divided into various settings grouped under Analysis, Integration, Algorithm, ConvergenceTest, Solver, and Damping Model, with parameters like "Transient -numSubLevels 2 -numSubSteps 10", "Newmark 0.5 0.25", "Newton", "NormUnbalance 1.0e-2 10", and "Umfpack" filled in the respective text fields. There is also a section for Damping Model showing "Rayleigh Damping" selected from a dropdown menu, alongside fields for Damping Ratio, Selected Tangent Stiffness, Mode 1, and Mode 2 with numerical values set. A button labeled "Choose" next to an empty field for Analysis Script is located at the bottom of the interface.
:figclass: align-center


Expand All @@ -97,6 +104,7 @@ To perform a Sampling or Forward propagation uncertainty analysis the user would

.. figure:: figures/shearRV.png
:align: center
:alt: Screenshot of a software interface showing a table titled "Input Random Variables" with fields for variable name, distribution type, mean, standard deviation, and a button to "Show PDF". Four variables are defined: 'wR' with a normal distribution, mean of 50, and standard deviation of 5; 'w' with a normal distribution, mean of 100, and standard deviation of 10; 'k' with a normal distribution, mean of 326.32, and standard deviation of 25; 'factorEC' with a uniform distribution and a range from 1.2 to 1.8. To the left, a vertical navigation bar lists categories such as UQ, GI, SIM, EVT, FEM, EDP, RV, and RES, with RV highlighted in blue.
:figclass: align-center

.. warning::
Expand All @@ -107,18 +115,21 @@ To perform a Sampling or Forward propagation uncertainty analysis the user would

.. figure:: figures/shearRES1.png
:align: center
:alt: Screenshot of a computer interface showing a statistical data analysis with several entries. The interface includes categories on the left such as UQ, GI, SIM, EVT, FEM, EDP, RV, and RES which are highlighted one by one. The main panel displays tables of different datasets, each with a Name, Mean, StdDev (standard deviation), Skewness, and Kurtosis values. The data fields show numerical values for different parameters named 1-PFA-0-1, 1-PFA-1-1, 1-PFD-1-1, among others, indicating different mean values and variation measures. The top of the main panel has tabs labeled 'Summary' and 'Data Values,' with 'Summary' currently selected.
:figclass: align-center

If the user selects the **Data** tab in the **RES** panel, they will be presented with both a graphical plot and a tabular listing of the data. By left- and right-clicking with the mouse in the individual columns the axis changes (the left mouse click controls the vertical axis, right mouse clicks the horizontal axis).

.. figure:: figures/shearRES7.png
:align: center
:alt: Two side-by-side images of graphical user interfaces containing scatter plots with numerous blue dots representing data points. The plots are labeled with various factor levels on the x-axis and a FP-BF metric on the y-axis. There are tables below the scatter plots with numerical data, and elements of the user interface, such as buttons labeled "Save Data," "Summary," and "Data Values," are visible in each image. The interfaces have additional sections labeled with acronyms such as UQ, GI, SIM, EVT, FEM, EDP, RV, and RES. The exact data values and specific interface functionality are not discernible.
:figclass: align-center

Various views of the graphical display can be obtained by left- and right-clicking in the columns of the tabular data. 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, as shown in the figure below.

.. figure:: figures/shearRES6.png
:align: center
:alt: The image displays two charts side by side within a software interface. On the left is a histogram with the x-axis labeled '-1*PFD-p-1' showing a distribution of values with various frequencies. On the right is a cumulative distribution curve that gradually increases and flattens out as it progresses along the same x-axis label. Below each chart, there is a table titled 'RES' with columns 'Run #', 'W', 'R', 'N', 'a', 'factor_EC', 'factor_FC-p-1', 'factor_FC-p+1', 'factor_FC-p+1.10', 'factor_FC-p+3', 'factor_FC-p+1.50', 'factor_FC-p+3.01'. The first row of the table displays numerical data. The top of the interface includes tabs labeled 'Summary' and 'Data Values' suggesting these charts are part of a data analysis or simulation program.
:figclass: align-center


Expand Down Expand Up @@ -150,13 +161,15 @@ The steps are the same as the previous example, with the exception of step 4 def

.. figure:: figures/shearEDP-U.png
:align: center
:alt: Screenshot of a user interface titled "Engineering Demand Parameter Generator" with the option set to "User Defined." The UI includes fields for "Additional Input" with a file path entered and two "Processing Script" fields each accompanied by a "Choose" button. There's a "Response Parameters" section with "Name Node_4_Disp_1" listed, and two buttons labeled "Add" and "Remove." To the left, there is a sidebar with various options including UQ, GI, SIM, EVT, FEM, EDP (highlighted), RV, and RES.
:figclass: align-center


2. Next click on the **Run** button. This will cause the backend application to launch dakota. When done the **RES** panel will be selected and the results will be displayed. The results show the values of the mean and standard deviation as before but now only for the one quantity of interest.

.. figure:: figures/shearRES-UO.png
:align: center
:alt: A screenshot of a statistical analysis software interface displaying a table under the tab "Summary." The table lists statistical values for an entity named "Node_4_Disp_1," with the mean value at 1.99797, standard deviation at 0.327398, skewness at 0.615724, and kurtosis at 3.88743. On the left side, a vertical menu with various options like UQ, GI, SIM, EVT, FEM, EDP, RV, and RES is partially visible. The RES option is highlighted in blue, suggesting it is the current selection.
:figclass: align-center


Expand All @@ -170,12 +183,14 @@ To perform a reliability analysis, the steps above would be repeated with the ex

.. figure:: figures/shearSensitivityUQ.png
:align: center
:alt: Screenshot of a user interface for an UQ (Uncertainty Quantification) Engine, specifically displaying the adaptation for the Dakota engine. There are dropdown menus for 'Dakota Method Category' with 'Sensitivity Analysis' selected and 'Method' with 'LHS' selected. Below the dropdown menus are input fields for 'Number of Samples' set to 1000 and 'Seed' set to 20. On the left side, there is a vertical navigation bar with various acronyms such as UQ, GI, SIM, EVT, FEM, EDP, RV, and RES, indicating different sections of the software. The rest of the graphical user interface elements are minimally displayed and the overall color scheme is a combination of light and dark blue with white text.
:figclass: align-center

After the user fills in the rest of the tabs as per the previous section, the user would then press the **RUN** button. The application (after spinning for a while with the wheel of death) will present the user with the results.

.. figure:: figures/shearSensitivityRES.png
:align: center
:alt: Screenshot of a software interface displaying a table titled "Node_4_Disp_1_Sobol' indices:" with columns for Random Variable, Main, and Total. The Random Variable column lists four items: wR, w, k, and factorEC, each with corresponding numerical values in the Main and Total columns. The interface has tabs labeled Summary and Data Values at the top and a sidebar on the left with options UQ, GI, SIM, EVT, FEM, EDP, RV, and RES highlighted in teal.
:figclass: align-center

The results showing that the earthquake factor has the largest influence on the response followed by the stiffness value k, as the results graphically would indicate.
Expand All @@ -188,12 +203,14 @@ If the user is interested in the probability that certain response measures will

.. figure:: figures/shearReliabilityUQ.png
:align: center
:alt: Screenshot of a software interface for uncertainty quantification (UQ) featuring the UQ Engine section. The selected engine is "Dakota" with a "Reliability Analysis" Dakota Method Category. Below, the "Reliability Method" is set to "Global Reliability," the "GP Approximation" is chosen as "x_gaussian_process," "Response Levels" has a value of 2.50, and "Seed" is set to 48. The sidebar contains abbreviations like GI, SIM, EVT, FEM, EDP, RV, and RES, each indicating different sections of the software interface.
:figclass: align-center

After the user fills in the rest of the tabs as per the previous section, the user would then press the **RUN** button. The application (after spinning for a while with the wheel of death) will present the user with the results, which as shown below, indicate that the probability is **91.5%**.

.. figure:: figures/shearReliabilityRes.png
:align: center
:alt: A screenshot of a software interface displaying a graph with a single data point plotted. The horizontal axis is labeled from 2.25 to 2.75 and the vertical axis is labeled 'Probability' from 0.00 to 1.00. The data point is located around 2.50 on the horizontal axis and approximately 0.92 on the vertical axis. Below the graph, there is a table with numerical data corresponding to the plotted point, showing a value of approximately 0.92, and a second value aligned with the position on the horizontal axis labeled "2.5000000000e+00". The interface includes menu options on the left, but the labels are not completely visible, with only the leftmost portion of each label shown, such as "UQ", "GI", "SIM", and so on. A blue tab labeled "RES" is highlighted on the left side menu and there are text boxes or indicators for "Node_4_Disp:1" above and below the plot which suggest the graph relates to some node displacement measurement.
:figclass: align-center

.. warning::
Expand Down
Loading

0 comments on commit a900d78

Please sign in to comment.