fmk - updating to latest for 3.2 release

NHERI-SimCenter · Mar 12, 2024 · 1445616 · 1445616
1 parent 394f033
commit 1445616
Show file tree

Hide file tree

Showing 445 changed files with 86,121 additions and 1,892 deletions.
diff --git a/docs/.buildinfo b/docs/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: ee4a8c4ea9f2855d1a46c84d277de048
+config: dfe7311502e66a5e1a89ccacdc216591
 tags: b812aa65388374b20f6c919e0a750ea9
diff --git a/docs/.doctrees/common/front-matter/cite.doctree b/docs/.doctrees/common/front-matter/cite.doctree
diff --git a/docs/.doctrees/common/user_manual/examples/desktop/examples.doctree b/docs/.doctrees/common/user_manual/examples/desktop/examples.doctree
diff --git a/docs/.doctrees/common/user_manual/examples/desktop/weuq-0015/README.doctree b/docs/.doctrees/common/user_manual/examples/desktop/weuq-0015/README.doctree
diff --git a/docs/.doctrees/common/user_manual/installation/desktop/install_macOS.doctree b/docs/.doctrees/common/user_manual/installation/desktop/install_macOS.doctree
diff --git a/docs/.doctrees/common/user_manual/releases/pbeCapabilities.doctree b/docs/.doctrees/common/user_manual/releases/pbeCapabilities.doctree
diff --git a/docs/.doctrees/common/user_manual/releases/pbePlans.doctree b/docs/.doctrees/common/user_manual/releases/pbePlans.doctree
diff --git a/docs/.doctrees/common/user_manual/releases/pbeReleaseNotes.doctree b/docs/.doctrees/common/user_manual/releases/pbeReleaseNotes.doctree
diff --git a/docs/.doctrees/common/user_manual/releases/weCapabilities.doctree b/docs/.doctrees/common/user_manual/releases/weCapabilities.doctree
diff --git a/docs/.doctrees/common/user_manual/releases/wePlans.doctree b/docs/.doctrees/common/user_manual/releases/wePlans.doctree
diff --git a/docs/.doctrees/common/user_manual/releases/weReleaseNotes.doctree b/docs/.doctrees/common/user_manual/releases/weReleaseNotes.doctree
diff --git a/docs/.doctrees/common/user_manual/troubleshooting/desktop/troubleshootingRunning.doctree b/docs/.doctrees/common/user_manual/troubleshooting/desktop/troubleshootingRunning.doctree
diff --git a/docs/.doctrees/common/user_manual/usage/desktop/UQ.doctree b/docs/.doctrees/common/user_manual/usage/desktop/UQ.doctree
diff --git a/docs/.doctrees/common/user_manual/usage/desktop/usage.doctree b/docs/.doctrees/common/user_manual/usage/desktop/usage.doctree
diff --git a/docs/.doctrees/common/user_manual/usage/desktop/wind/EmptyDomainCFD.doctree b/docs/.doctrees/common/user_manual/usage/desktop/wind/EmptyDomainCFD.doctree
diff --git a/docs/.doctrees/common/user_manual/usage/desktop/wind/IsolatedBuildingCFD.doctree b/docs/.doctrees/common/user_manual/usage/desktop/wind/IsolatedBuildingCFD.doctree
diff --git a/docs/.doctrees/common/user_manual/usage/desktop/wind/tools.doctree b/docs/.doctrees/common/user_manual/usage/desktop/wind/tools.doctree
diff --git a/docs/.doctrees/environment.pickle b/docs/.doctrees/environment.pickle
diff --git a/docs/.doctrees/index.doctree b/docs/.doctrees/index.doctree
diff --git a/docs/_images/WEUQ_empty_domain_workflow.png b/docs/_images/WEUQ_empty_domain_workflow.png
diff --git a/docs/_images/empty_domain_bc_profile.svg b/docs/_images/empty_domain_bc_profile.svg
diff --git a/docs/_images/empty_domain_bc_tab.svg b/docs/_images/empty_domain_bc_tab.svg
diff --git a/docs/_images/empty_domain_dialog_window.svg b/docs/_images/empty_domain_dialog_window.svg
diff --git a/docs/_images/empty_domain_geometry_tab.svg b/docs/_images/empty_domain_geometry_tab.svg
diff --git a/docs/_images/empty_domain_mesh_tab.svg b/docs/_images/empty_domain_mesh_tab.svg
diff --git a/docs/_images/empty_domain_result_display.svg b/docs/_images/empty_domain_result_display.svg
diff --git a/docs/_images/empty_domain_result_monitoring.svg b/docs/_images/empty_domain_result_monitoring.svg
diff --git a/docs/_images/empty_domain_result_sample.svg b/docs/_images/empty_domain_result_sample.svg
diff --git a/docs/_images/empty_domain_start_tab.svg b/docs/_images/empty_domain_start_tab.svg
diff --git a/docs/_images/open_empty_domain_from_menu_bar.svg b/docs/_images/open_empty_domain_from_menu_bar.svg
diff --git a/docs/_images/we14_CFD_Results1.svg b/docs/_images/we14_CFD_Results1.svg
diff --git a/docs/_images/we14_EDP_panel1.svg b/docs/_images/we14_EDP_panel1.svg
diff --git a/docs/_images/we14_EVT_BoundaryConditions1.svg b/docs/_images/we14_EVT_BoundaryConditions1.svg
diff --git a/docs/_images/we14_EVT_Geometry_tab1.svg b/docs/_images/we14_EVT_Geometry_tab1.svg
diff --git a/docs/_images/we14_EVT_Import_stl1.svg b/docs/_images/we14_EVT_Import_stl1.svg
diff --git a/docs/_images/we14_EVT_Mesh_EdgeRefinement_tab1.svg b/docs/_images/we14_EVT_Mesh_EdgeRefinement_tab1.svg
diff --git a/docs/_images/we14_EVT_Mesh_PrismLayers_tab1.svg b/docs/_images/we14_EVT_Mesh_PrismLayers_tab1.svg
diff --git a/docs/_images/we14_EVT_Mesh_RegionalRefinement_tab1.svg b/docs/_images/we14_EVT_Mesh_RegionalRefinement_tab1.svg
diff --git a/docs/_images/we14_EVT_Mesh_SurfaceRefinement_tab1.svg b/docs/_images/we14_EVT_Mesh_SurfaceRefinement_tab1.svg
diff --git a/docs/_images/we14_EVT_Mesh_View1.svg b/docs/_images/we14_EVT_Mesh_View1.svg
diff --git a/docs/_images/we14_EVT_Mesh_tab1.svg b/docs/_images/we14_EVT_Mesh_tab1.svg
diff --git a/docs/_images/we14_EVT_Monitoring1.svg b/docs/_images/we14_EVT_Monitoring1.svg
diff --git a/docs/_images/we14_EVT_NumericalSetup1.svg b/docs/_images/we14_EVT_NumericalSetup1.svg
diff --git a/docs/_images/we14_EVT_Start_tab1.svg b/docs/_images/we14_EVT_Start_tab1.svg
diff --git a/docs/_images/we14_FEM_panel1.svg b/docs/_images/we14_FEM_panel1.svg
diff --git a/docs/_images/we14_GI_panel1.svg b/docs/_images/we14_GI_panel1.svg
diff --git a/docs/_images/we14_RES_DataValues1.svg b/docs/_images/we14_RES_DataValues1.svg
diff --git a/docs/_images/we14_RES_Summary1.svg b/docs/_images/we14_RES_Summary1.svg
diff --git a/docs/_images/we14_RV_panel1.svg b/docs/_images/we14_RV_panel1.svg
diff --git a/docs/_images/we14_RunJob1.svg b/docs/_images/we14_RunJob1.svg
diff --git a/docs/_images/we14_SIM_panel1.svg b/docs/_images/we14_SIM_panel1.svg
diff --git a/docs/_images/we14_UQ_panel1.svg b/docs/_images/we14_UQ_panel1.svg
diff --git a/docs/_images/we14_study_building1.svg b/docs/_images/we14_study_building1.svg
diff --git a/docs/_sources/common/front-matter/cite.rst.txt b/docs/_sources/common/front-matter/cite.rst.txt
@@ -11,9 +11,9 @@ How To Cite
 
 .. only:: PBE_app
 
-   1. Adam Zsarnoczay, Frank McKenna, Kuanshi Zhong, Charles Wang, Stevan Gavrilovic, Michael Gardner, & Wael Elhaddad. (2023).
-      NHERI-SimCenter/PBE: Version 3.2.0 (v3.2.0).
-      Zenodo. `DOI: 10.5281/zenodo.8396131 <https://doi.org/10.5281/zenodo.8396131>`_
+   1. Adam Zsarnoczay, Frank McKenna, Charles Wang, Stevan Gavrilovic, Kuanshi Zhong, Michael Gardner, Sang-ri Yi, Aakash B. Satish & Wael Elhaddad. (2024).
+      NHERI-SimCenter/PBE: Version 3.3.0 (v3.3.0).
+      Zenodo. `DOI: 10.5281/zenodo.8396131 <https://doi.org/10.5281/zenodo.10448044>`_
 
 .. only:: EEUQ_app
 

diff --git a/docs/_sources/common/user_manual/examples/desktop/weuq-0015/README.rst.txt b/docs/_sources/common/user_manual/examples/desktop/weuq-0015/README.rst.txt
diff --git a/docs/_sources/common/user_manual/installation/desktop/install_macOS.rst.txt b/docs/_sources/common/user_manual/installation/desktop/install_macOS.rst.txt
@@ -105,8 +105,8 @@ Make sure you see a message that confirms the successful installation of the nhe
    To install OpenFOAM-10 on macOS, follow the instructions in `OpenFOAM for macOS <https://openfoam.org/download/10-macos/>`_ .
 
 
-Download the Application
-^^^^^^^^^^^^^^^^^^^^^^^^
+Download the Application & Move it from the DMG image
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 To download the |app|, navigate to the |appLink| page which should resemble |figDownload|. The download page contains a list of downloadable files and directories.
 
@@ -173,11 +173,12 @@ To download the |app|, navigate to the |appLink| page which should resemble |fig
 
       HydroUQ tool download page.
 
-Click on the file with a name ending with **Mac_Download.dmg** to download the |app|. In the pop-up window, click on the **Download** button in the bottom right corner. After the download is completed, open the dmg file and copy the |short tool name| application to a location in your filesystem.
+Click on the file with a name ending with **Mac_Download.dmg** to download the |app|. In the pop-up window, click on the **Download** button in the bottom right corner. After the download is completed, open the dmg file and **MOVE** the |short tool name| application by dragging on it to a location in your filesystem. After the application has been copied to a location outside the dmg, the dmg can be deleted and the application run.
 
-.. note::
+.. warning::
 
-   We suggest copying the application to your Desktop. After copying the application, you can move the dmg file to the trash or eject it.
+   The application must be copied to a location on your filesystem outside of the DMG image. If you run the |short tool name| from within the dmg, i.e. if you open the dmg and then start the application from the window that pops up, it will **FAIL** when you try to run any workflow. 
+
 
 Test the Installation
 ^^^^^^^^^^^^^^^^^^^^^

diff --git a/docs/_sources/common/user_manual/releases/pbeCapabilities.rst.txt b/docs/_sources/common/user_manual/releases/pbeCapabilities.rst.txt
@@ -5,7 +5,7 @@
 Capabilities
 ************
 
-The following functionality is available in **version 3.2** of the |app| that was released on **Oct 09, 2023**.
+The following functionality is available in **version 3.3** of the |app| that was released on **Jan 1, 2024**.
 
 Structural Response
 ===================

diff --git a/docs/_sources/common/user_manual/releases/pbePlans.rst.txt b/docs/_sources/common/user_manual/releases/pbePlans.rst.txt
@@ -8,21 +8,19 @@ Release Plans
 
 The following features are planned to be developed for upcoming releases of |app|. We are actively working on the features in the next release. Farther development priorities may change depending on feedback from the community. If you have any suggestions, we encourage you to contribute and contact us through the SimCenter Forum.
 
-Oct 2023
+Apr 2024
 --------
 
     #. Facilitate wind damage and loss calculations by adding relevant vulnerability and loss components. The building-level components from the Hazus Hurricane Methodology will be complemented by components from recent research that supports higher resolution analyses. (1.3.5.1)
 
-Jan 2024
---------
-
-    #. Integrate additional functional recovery simulation engines, including the ATC 138 methodology, TREADS, and F-Rec. This will enable benchmarking and further development of these methods
+    #. Integrate additional functional recovery simulation engines, starting with the ATC 138 methodology. TREADS, and F-Rec are planned for the second half of 2024. This will enable benchmarking and further development of these methods
 
 
-March 2024
+Sept 2024
 ----------
 
    #. Facilitate water damage and loss calculation by adding relevant vulnerability and loss components. The building-level components from the Hazus Flood Methodology will be complemented by components from recent research that supports higher resolution analyses (1.3.5.2)
+
    #. Automatic access to physics-based ground motion simulation results (1.1.1.3)
 
  .. note::

diff --git a/docs/_sources/common/user_manual/releases/pbeReleaseNotes.rst.txt b/docs/_sources/common/user_manual/releases/pbeReleaseNotes.rst.txt
@@ -8,7 +8,26 @@ Release Notes
 Version 3
 =========
 
-   .. dropdown::    Version 3.2 (:blue:`Current`)
+   .. dropdown::    Version 3.3 (:blue:`Current`)
+      :open:
+
+      **Release date:** Jan 2024
+
+      **Major updates:**
+
+      - Allow multiple definitions of the same component type at the same location and direction in the asset model. (If needed, we can later add a feature to propagate these as separate instances to model, e.g., components used by various tenants.)
+
+      - Update JSON outputs to follow new standard SimCenter output format
+
+      - Include unit information in every CSV and JSON output file.
+
+      - Several minor efficiency improvements that lead to faster runtimes - major improvments in that area are coming in the next minor release
+
+      - Several error and warning messages added to provide more meaningful information when something goes wrong in a simulation.
+
+      - A lot of minor bugs fixed and robustness of the Pelicun engine ensured by bringing back continuous integration.
+
+   .. dropdown::    Version 3.2
       :open:
 
       **Release date:** Sept 2023

diff --git a/docs/_sources/common/user_manual/releases/weCapabilities.rst.txt b/docs/_sources/common/user_manual/releases/weCapabilities.rst.txt
@@ -5,7 +5,7 @@
 Capabilities
 ************
 
-**Version 3.1.0** of |app| was released **October 2023**. The following lists the functionality available in this current version. (Note: New features and fixes in this release are marked :blue:`blue` in the following list of features.)
+**Version 3.2.0** of |app| was released **March 2024**. The following lists the functionality available in this current version. (Note: New features and fixes in this release are marked :blue:`blue` in the following list of features.)
 
 
 Structural Information Model
@@ -26,7 +26,7 @@ Applications used to specify/select wind loading for the structure.
 
 #.  Stochastic Wind: simulating stochastic wind speed using spectral method
 #.  CFD-Digital Wind Tunnel: CFD simulation of boundary layer wind tunnel
-#.  :blue:`CFD-Wind Load on Isolated Buildings: CFD-based wind load simulation for isolated buildings with complex geometry`
+#.  CFD-Wind Load on Isolated Buildings: CFD-based wind load simulation for isolated buildings with complex geometry
 #.  DEDM_HRP: database-enabled design framework based on wind-tunnel data for high-rise buildings 
 #.  LowRiseTPU: extracting aerodynamics loads based on TPU database for low-rise buildings
 #.  Wind Tunnel Experiment: uses pressure tap measurements from building in wind tunnel experiment
@@ -88,3 +88,8 @@ Applications to perform the uncertainty quantification for the response paramete
 
         #. Surrogate modeling using Probabilistic Learning on Manifolds (PLoM)
 
+Addition Tools 
+===============
+
+#. :blue:`Empty Domain CFD Simulation`:
+   Capability to perform empty domain simulation to characterize Atmospheric Boundary Layer (ABL) flows using large-eddy simulation (LES). This added feature uses the Turbulence Inflow Tool (TInF) tool for calibrating ABL flows for a subsequent wind load evaluation study. 
diff --git a/docs/_sources/common/user_manual/releases/wePlans.rst.txt b/docs/_sources/common/user_manual/releases/wePlans.rst.txt
@@ -7,15 +7,13 @@ Release Plans
 *************
 
 The following features are intended to be included in |app|  in upcoming releases. These may change, depending on feedback and changing priorities, though the ones closest out are things we are actively working and will be delivered. If you have any suggestions or wish to contribute, please contact us through the SimCenter Forum.
-
 
-Dec 2023
+Mar 2024
 ----------
-   #. Digital Wind Tunnel (1.2.5.2) - CFD models for empty domain simulation with synthetic inflow turbulence. 
    #. Aerodynamic Database (1.1.1.4) - Develop an aerodynamic database integrating CFD simulation and experimental measurements.
 
 
-Mar 2024
+Apr 2024
 ----------
    #. Digital Wind Tunnel (1.2.5.2) - CFD models for a complex-shaped building with explicitly modeled surrounding buildings. 
    #. Surrogate support for regional assessment (1.3.6.1) - Extend surrogates developed in EE-UQ that can be utilized in R2D for wind hazard simulation.

diff --git a/docs/_sources/common/user_manual/releases/weReleaseNotes.rst.txt b/docs/_sources/common/user_manual/releases/weReleaseNotes.rst.txt
@@ -5,7 +5,23 @@
 Release Notes
 *************
 
-Version 3.1 (Current)
+Version 3.2 (Current)
+-----------------------
+
+**Release date:** Mar. 2024
+
+**Highlights**
+
+#. Implemented a new capability to characterize Atmospheric Boundary Layer (ABL) flows using large-eddy simulation (LES).
+#. Added advanced options for pre-processing, monitoring and postprocessing CFD simulation.
+#. Integrated a new method to Turbulence Inflow Tool (TInF) tool for wind loading simulation.
+#. Supports visualization of the simulation data using Paraview on local machine. 
+#. Addressed bugs in the prior release 
+#. Created a new example to demonstrate the recently added CFD features. 
+
+
+
+Version 3.1
 -----------------------
 
 **Release date:** Oct. 2023

diff --git a/...urces/common/user_manual/troubleshooting/desktop/troubleshootingRunning.rst.txt b/...urces/common/user_manual/troubleshooting/desktop/troubleshootingRunning.rst.txt
@@ -17,6 +17,9 @@ Common causes of failure include incorrect setup, non-functioning or poorly func
 
 The following is a list of issues we have observed when the user interface informs the user of a failure and steps you can take to fix them:
 
+#. ** RUNNING DAKOTA ERROR: dakota command not found**. If you are on a Mac computer you need to make sure you are not running the application from inside the dmg file. It needs to be copied to a seperate location and the dmg file deleted. We ask you to delete the dmg file to ensure you do not run from inside it. If it still fails to run a Workflow check Prefernces and the path to the dakota executane, if it has /Volumes in the start of the path, hit the **Reset** button.
+
+
 #.  **Could not create working dir**: The user does not have permission to create the ``tmp.SimCenter`` folder in the working directory. Change the **Local Jobs Directory** and the **Remote Jobs Directory** in the application's **Preferences** menu option.
 
 #. **No Script File**: The application cannot find the main Python scripts (rWHALE.py, sWHALE.py, or qWHALE.py) that run the workflow using our backend engine. You might have changed the Local Applications directory location in Preferences, or modified the applications folder that accompanies the installation. Make sure the Local Applications points to the correct directory location. If that does not help, re-install the tool to fix a corrupted applications folder.

diff --git a/docs/_sources/common/user_manual/usage/desktop/usage.rst.txt b/docs/_sources/common/user_manual/usage/desktop/usage.rst.txt
@@ -199,7 +199,6 @@ The main window of the UI is made up from the following areas:
 
       .. note:: You can check the status of a remote run by clicking on the **GET from DesignSafe** button. If the analysis status shows FAILED,  log into your DesignSafe account to view the detailed output of the run. First, log in with your credentials on the `DesignSafe <https://www.designsafe-ci.org/help/new-ticket/>`_ webpage. Next, use the menu to navigate to **Workspace** -> **Tools & Applications** -> **Job Status** and then select a job and click on **More info** to view the status of that job.
 
-
 .. only:: R2D_app
 
    6. **Main Menu**
Original file line number	Diff line number	Diff line change
Expand Up		@@ -199,7 +199,6 @@ The main window of the UI is made up from the following areas:

		.. note:: You can check the status of a remote run by clicking on the GET from DesignSafe button. If the analysis status shows FAILED, log into your DesignSafe account to view the detailed output of the run. First, log in with your credentials on the `DesignSafe <https://www.designsafe-ci.org/help/new-ticket/>`_ webpage. Next, use the menu to navigate to Workspace -> Tools & Applications -> Job Status and then select a job and click on More info to view the status of that job.


		.. only:: R2D_app

		6. Main Menu
Expand Down