1.1.1. Install on Windows 10

1.1.1.1. Install Java (JDK 17)

Note

Java is required only if you plan to use the OpenSHA-based regional seismic hazard feature in R2D app (Earthquake Event Simulation). If you do not need this feature, you can skip this section.

R2D 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.

1.1.1.4. Download the Application

Navigate to the R2D Download page, which should resemble Fig. 1.1.1.4.1, 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.

../../../../_images/R2DDownload.png

Fig. 1.1.1.4.1 R2D 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 R2D.exe to your Desktop for convenience.

Tip

Use an external compressor like 7-Zip for faster extraction than the default Windows function.

1.1.1.5. Test the Installation

After installation, perform basic checks by running the R2D.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 R2D app 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 Fig. 1.1.1.5.1. It’s recommended to run the r2dt-0006 to ensure proper operation.

../../../../_images/R2D-Startup.png

Fig. 1.1.1.5.1 R2D Tool on startup.

1.1.1.6. Troubleshooting

If the test example fails, refer to 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.