.. _lblInstallWindows: Install on Windows 10 ===================== .. only:: R2D_app **Install Java (JDK 17)** ^^^^^^^^^^^^^^^^^^^^^^^^^ .. note:: Java is required only if you plan to use the OpenSHA-based regional seismic hazard feature in |app| (:ref:`ground_motion_tool`). If you do not need this feature, you can skip this section. |app| is tested with **Eclipse Temurin JDK 17**, the long-term-support (LTS) build of Java. We recommend this exact version: it matches what our Python-to-Java bridge (JPype) is officially tested against, so installing it gives you the smoothest experience. **Which installer should I download?** For virtually every Windows PC sold since the mid-2010s, the answer is the **Windows x64** installer. If you are unsure whether your machine is 64-bit, open **Settings → System → About** and look for **System type**. "64-bit operating system, x64-based processor" means you want the Windows x64 installer below. 1. Click this link to open the Adoptium download page, pre-filtered to the right installer: `Temurin JDK 17 — Windows x64 `_. 2. On that page, click the large download icon next to the MSI option. Your browser will download a file named something like ``OpenJDK17U-jdk_x64_windows_hotspot_17.0.X_Y.msi``. 3. Once the download finishes, double-click the ``.msi`` file. The Windows installer will open. Accept the defaults on each screen and click **Install**. You may see a User Account Control prompt asking for permission — click **Yes**. .. tip:: If you have already installed a different Java version, you do not need to remove it. Multiple Java versions coexist without conflict on Windows. .. note:: .. only:: WEUQ_app This version of the |app| uses *OpenFOAM* for pre-processing the CFD model. At the backend, the mesh generation and visualization in the GUI utilize *OpenFOAM-10* built-in meshing tools. .. note:: The packaged distribution of OpenFOAM is only available for Linux systems. To install OpenFOAM on Microsoft Windows 10, the user needs to use Windows Subsystem for Linux (WSL). WSL will provide a virtual environment for running Linux applications on Windows. Install OpenFOAM for Windows ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To install OpenFOAM-10 on Windows 10 or 11, follow the instructions below: 1. First, open *PowerShell* from the start menu and run it as an administrator. In the command window, type the following which will install all the necessary Linux features. For detailed instructions please follow `Install WSL `_. .. code:: bash wsl --install --distribution Ubuntu-22.04 .. figure:: figures/weuq_wsl_installation.png :align: center :width: 75% Installing WSL(Ubuntu) Subsystem. This will install Ubuntu distribution and launch a new linux terminal to configure the installation. Then, input your username and password to set up the system as shown below. .. figure:: figures/weuq_wsl_configuration.png :align: center :width: 75% Configuring WSL(Ubuntu) Subsystem. 2. Then, open WSL from the start menu and execute the following commands line by line on the opened terminal window. .. code:: bash sudo sh -c "wget -O - http://dl.openfoam.org/gpg.key | apt-key add -" sudo add-apt-repository http://dl.openfoam.org/ubuntu sudo apt-get update sudo apt-get install openfoam10 .. figure:: figures/weuq_openfoam_installation.png :align: center :width: 75% Installing OpenFOAM-10 on WSL. .. note:: To verify that **OpenFOAM** has been installed correctly for **WE-UQ**, follow these steps: Once WE-UQ is installed, open the application. From the **Examples** pull-down menu, select **Example E5**. When this example loads, WE-UQ calls OpenFOAM in the background to create a mesh of the model. If the mesh does not display, OpenFOAM is not functioning correctly for your setup. There are a few possible causes: 1. **Missing .bashrc entry** During OpenFOAM installation, you are instructed to edit your ``.bashrc`` file. If you have not done so, add the following line to the file: ``. /opt/openfoam10/etc/bashrc`` You can edit the file using a text editor such as **nano** or **vi**. 2. **Different default shell** If you have already added the above line, your Ubuntu system may be configured to use a shell other than the default **bash** shell. In that case, try replacing the previous line with: ``source /opt/openfoam10/etc/bashrc`` 3. WE-UQ sets the path to it's backend applications the first time the application starts. If you move the application subsequent to this or download the application again, you need to **reset** these paths. To do this go to **File**, **Preferences** and press the **Reset** and **Save** buttons. .. only:: HydroUQ_app This version of the |app| uses *OpenFOAM* for pre-processing the CFD model. Backend mesh generation and visualization, which the GUI relies on, are powered by *OpenFOAM-10* and *OpenFOAM-7*'s built-in meshing tools. .. note:: The packaged distribution of OpenFOAM is only available for Linux systems. To install OpenFOAM on Microsoft Windows 10, the user needs to use Windows Subsystem for Linux (WSL). WSL will provide a virtual environment for running Linux applications on Windows. Install OpenFOAM for Windows ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To install OpenFOAM-10 and OpenFOAM-7 on Windows 10, follow the instructions below: #. First, open *PowerShell* from the start menu and run it as an administrator. Then, in the command window type ``wsl --install`` which will install all the necessary Linux features. For detailed instructions please follow `Install WSL `_. #. Open WSL from the start menu and run the following commands on the opened terminal window. .. code:: bash sudo sh -c "wget -O - http://dl.openfoam.org/gpg.key | apt-key add -" sudo add-apt-repository http://dl.openfoam.org/ubuntu sudo apt-get update sudo apt-get install openfoam10 sudo apt-get install openfoam7 Further instructions can be found in `OpenFOAM.org `_. **Download the Application** ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Navigate to the |appLink| page, which should resemble |figDownloadWin|, for a list of downloadable files and directories. Click the **Windows_Download.zip** file and select **Download** in the pop-up window's bottom right. .. only:: R2D_app .. _figDownloadWin-R2D: .. figure:: figures/R2DDownload.png :align: center :figclass: align-center R2D Tool download page. .. only:: PBE_app .. _figDownloadWin-PBE: .. figure:: figures/pbeDownload.png :align: center :figclass: align-center PBE download page. .. only:: EEUQ_app .. _figDownloadWin-EE: .. figure:: figures/eeDownload.png :align: center :figclass: align-center EE-UQ download page. .. only:: WEUQ_app .. _figDownloadWin-WE: .. figure:: figures/weDownload.png :align: center :figclass: align-center WE-UQ download page. .. only:: quoFEM_app .. _figDownloadWin-quoFEM: .. figure:: figures/quoFEMDownload.png :align: center :figclass: align-center quoFEM download page. .. only:: HydroUQ_app .. _figDownloadWin-HydroUQ: .. figure:: figures/H20Download.png :alt: HydroUQ tool download page :align: center :figclass: align-center HydroUQ tool download page. After downloading, extract the zip file to your preferred location, such as **C:/SimCenter/**. You can create and move a shortcut of the |short tool id|.exe to your Desktop for convenience. .. tip:: Use an external compressor like `7-Zip `_ for faster extraction than the default Windows function. **Test the Installation** ^^^^^^^^^^^^^^^^^^^^^^^^^ After installation, perform basic checks by running the |short tool id|.exe from the installation directory. .. note:: Since the SimCenter is not registered as a Windows vendor, our applications may trigger a warning about unsigned applications from unknown sources when you start the |short tool name| for the first time. It is safe to bypass this warning for SimCenter applications. Launch the application to view the user interface as shown in |figWinUI|. It's recommended to run the |test example| to ensure proper operation. .. only:: R2D_app .. _figWinUI-R2D: .. figure:: figures/R2D-Startup.png :align: center :figclass: align-center R2D Tool on startup. .. only:: PBE_app .. _figWinUI-PBE: .. figure:: figures/PBE_startup.png :align: center :figclass: align-center PBE application on startup. .. only:: EEUQ_app .. _figWinUI-EE: .. figure:: figures/EE-UQ.png :align: center :figclass: align-center EE-UQ application on startup. .. only:: WEUQ_app .. _figWinUI-WE: .. figure:: figures/WE-UQ.png :align: center :figclass: align-center WE-UQ application on startup. .. only:: quoFEM_app .. _figWinUI-quoFEM: .. figure:: figures/quoFEM.png :align: center :figclass: align-center quoFEM application on startup. .. only:: HydroUQ_app .. _figWinUI-HydroUQ: .. figure:: figures/HydroWin.png :align: center :figclass: align-center HydroUQ tool on startup in Windows 10 **Troubleshooting** ^^^^^^^^^^^^^^^^^^^^^ If the test example fails, refer to :ref:`troubleshooting`. .. note:: Analysis failure may be due to the **local working directory** path defined in the preference menu. Check for: - Avoid setting the local working directory under cloud-synced folders like OneDrive or Box, which may cause file-not-found errors. - Avoid including non-alphabetic characters or spaces in the path, which may potentially lead to encoding or file-not-found errors. - Avoid setting the local working directory on a different drive than the app executable (.exe), which may result in permission errors, e.g. the executable is under the C drive, and the working directory is under the E drive.