OpenSHA Version 25.4.2

The latest OpenSHA applications as of May 21 2025 are available for download here. We will only officially support the latest major release (v25.4.X) and the previous release (v1.5.2). OpenSHA servers for v1.5.2 may no longer be operational in the next major release.

To download the latest OpenSHA applications, scroll to the bottom of this release entry and download the Jar applications under the “Assets” section.

See the OpenSHA website for details on these applications and how to use them.

Note: A 64-bit version of Java 11 or above is required.

First download the jar file[s] of interest. Some users may be able to launch them by simply double clicking on the jar file in a file browser. If this doesn't work, you will need to launch it in a terminal:

java -jar /path/to/jarFile.jar

For example, if I'm in a directory containing HazardCurveGUI-25.4.2.jar and want to run it:

java -jar HazardCurveGUI-25.4.2.jar

If you see any error messages related to "OutOfMemoryException" or java "heap size", or the app stalls when loading a large model (e.g., UCERF3 or NSHM23), you'll need to allocate more memory to java. You can do this most easily with the -Xmx argument. For example, to run with 4 GB of memory:

java -Xmx4G -jar HazardCurveGUI-25.4.2.jar

Non-executable library jar files of builds of the OpenSHA code are also supplied:

• opensha.jar: Class files and resources from the opensha project, not including any upstream dependencies
• opensha-all.jar: 'Fat' jar file containing class files and resources from this and upstream projects, including all dependencies

Release Notes

New to 25.4.2

• Fix IMi distribution calculation failure in the GCIM module when changing the default IMR (#174). Previously a NullPointerException error was thrown.

Previous (25.4.1)

• Fix Mean UCERF3 ERF Complete Model Preset in HazardCurveApplication (#169). This model previously threw an error and would not compute. Now it computes the model the same as before major release v25.4.0.

OpenSHA Version 25.4.1

The latest OpenSHA applications as of May 5 2025 are available for download here. We will only officially support the latest major release (v25.4.X) and the previous release (v1.5.2). OpenSHA servers for v1.5.2 may no longer be operational in the next major release.

To download the latest OpenSHA applications, scroll to the bottom of this release entry and download the Jar applications under the “Assets” section.

See the OpenSHA website for details on these applications and how to use them.

Note: A 64-bit version of Java 11 or above is required.

First download the jar file[s] of interest. Some users may be able to launch them by simply double clicking on the jar file in a file browser. If this doesn't work, you will need to launch it in a terminal:

java -jar /path/to/jarFile.jar

For example, if I'm in a directory containing HazardCurveGUI-25.4.1.jar and want to run it:

java -jar HazardCurveGUI-25.4.1.jar

If you see any error messages related to "OutOfMemoryException" or java "heap size", or the app stalls when loading a large model (e.g., UCERF3 or NSHM23), you'll need to allocate more memory to java. You can do this most easily with the -Xmx argument. For example, to run with 4 GB of memory:

java -Xmx4G -jar HazardCurveGUI-25.4.1.jar

Non-executable library jar files of builds of the OpenSHA code are also supplied:

• opensha.jar: Class files and resources from the opensha project, not including any upstream dependencies
• opensha-all.jar: 'Fat' jar file containing class files and resources from this and upstream projects, including all dependencies

Release Notes

New to 25.4.1

• Fix Mean UCERF3 ERF Complete Model Preset in HazardCurveApplication (#169). This model previously threw an error and would not compute. Now it computes the model the same as before major release v25.4.0.

Previous (25.4.0)

• Added support for "NSHM23 Western US (crustal only, excl. Cascadia) Branch Averaged ERF" — the most recent USGS ERF for the Western U.S.. Note that this model only includes crustal sources and thus excludes Cascadia subduction interface and intraslab seismicity.

• Added support for “USGS NSHM23 Active Crustal GMM” — the weighted average model used in NSHM23, accessed via a wrapper to nshmp-haz.

• Included the "WGCEP UCERF3 Epistemic List ERF" — the expanded epistemic uncertainty version of UCERF3, enabling plotting of fractiles and curves.

• Generalized Conditional Intensity Measure (GCIM) distribution calculator has been added to the Hazard Curve Control Panel for use in ground motion selection. This was previously a separate application.

• Introduction of the GetFile framework for automated retrieval of versioned ERF data, now hosted independently of OpenSHA releases.

• UI refactoring for a more responsive and stable experience and fixed progress bars for ERF downloads.

• Calculation cancellation is now handled gracefully and won’t crash the HazardCurve and HazardSpectrum applications.

• Updated DistanceX calculation with improved accuracy at high latitudes (see #162).

• Updated interface for point-source approximations. Now part of individual ERF parameter lists for greater visibility. UCERF3, NSHM23-WUS, and other fault-system-solution ERFs now default to enabling point-source distance corrections for gridded seismicity.

• Support for super-sampling gridded seismicity models for NSHM23 and UCERF3. Spreads redistributes point-sources evenly across each gridded seismicity cell, rather then centering all of them at the cell center.

• Fault System Solution ERF now supports updated and simpler file formats.

• New source-filtering interface and implementations allowing for more complex (magnitude- or tectonic-regime-specific) source distance cutoffs. See the “Calculation Settings” control panel in the Hazard Curve and Spectrum applications.

• Fixed bugs with the UCERF2 ERF gridded seismicity implementation, see #133.

• Various improvements to disaggregation calculations and plots:

  • Plots are now generated locally, improving performance and no longer requiring access to an OpenSHA server.
  • For fault-system-solution ERFs (e.g., UCERF3 and NSHM23-WUS), a new consolidated source list view is available where the contribution is listed for each individual fault (rather than rupture).

OpenSHA Version 25.4.0

The latest OpenSHA applications as of April 23 2025 are available for download here. We will only officially support the latest release (v25.4.0) and the previous release (v1.5.2). OpenSHA servers for v1.5.2 may no longer be operational in the next release.

To download the latest OpenSHA applications, scroll to the bottom of this release entry and download the Jar applications under the “Assets” section.

See the OpenSHA website for details on these applications and how to use them.

Note: A 64-bit version of Java 11 or above is required.

First download the jar file[s] of interest. Some users may be able to launch them by simply double clicking on the jar file in a file browser. If this doesn't work, you will need to launch it in a terminal:

java -jar /path/to/jarFile.jar

For example, if I'm in a directory containing HazardCurveGUI-25.4.0.jar and want to run it:

java -jar HazardCurveGUI-25.4.0.jar

If you see any error messages related to "OutOfMemoryException" or java "heap size", or the app stalls when loading a large model (e.g., UCERF3 or NSHM23), you'll need to allocate more memory to java. You can do this most easily with the -Xmx argument. For example, to run with 4 GB of memory:

java -Xmx4G -jar HazardCurveGUI-25.4.0.jar

Non-executable library jar files of builds of the OpenSHA code are also supplied:

• opensha.jar: Class files and resources from the opensha project, not including any upstream dependencies
• opensha-all.jar: 'Fat' jar file containing class files and resources from this and upstream projects, including all dependencies

Release Notes

New to 25.4.0

• Added support for "NSHM23 Western US (crustal only, excl. Cascadia) Branch Averaged ERF" — the most recent USGS ERF for the Western U.S.. Note that this model only includes crustal sources and thus excludes Cascadia subduction interface and intraslab seismicity.

• Added support for “USGS NSHM23 Active Crustal GMM” — the weighted average model used in NSHM23, accessed via a wrapper to nshmp-haz.

• Included the "WGCEP UCERF3 Epistemic List ERF" — the expanded epistemic uncertainty version of UCERF3, enabling plotting of fractiles and curves.

• Generalized Conditional Intensity Measure (GCIM) distribution calculator has been added to the Hazard Curve Control Panel for use in ground motion selection. This was previously a separate application.

• Introduction of the GetFile framework for automated retrieval of versioned ERF data, now hosted independently of OpenSHA releases.

• UI refactoring for a more responsive and stable experience and fixed progress bars for ERF downloads.

• Calculation cancellation is now handled gracefully and won’t crash the HazardCurve and HazardSpectrum applications.

• Updated DistanceX calculation with improved accuracy at high latitudes (see #162).

• Updated interface for point-source approximations. Now part of individual ERF parameter lists for greater visibility. UCERF3, NSHM23-WUS, and other fault-system-solution ERFs now default to enabling point-source distance corrections for gridded seismicity.

• Support for super-sampling gridded seismicity models for NSHM23 and UCERF3. Spreads redistributes point-sources evenly across each gridded seismicity cell, rather then centering all of them at the cell center.

• Fault System Solution ERF now supports updated and simpler file formats.

• New source-filtering interface and implementations allowing for more complex (magnitude- or tectonic-regime-specific) source distance cutoffs. See the “Calculation Settings” control panel in the Hazard Curve and Spectrum applications.

• Fixed bugs with the UCERF2 ERF gridded seismicity implementation, see #133.

• Various improvements to disaggregation calculations and plots:

  • Plots are now generated locally, improving performance and no longer requiring access to an OpenSHA server.
  • For fault-system-solution ERFs (e.g., UCERF3 and NSHM23-WUS), a new consolidated source list view is available where the contribution is listed for each individual fault (rather than rupture).

Previous (1.5.2)

• Improved chances that out of memory exceptions are successfully caught and show a useful error message to users. Also added memory information to bug reports.

• Cleaned out some necessary data files

OpenSHA Version 1.5.2

OpenSHA application release. See the OpenSHA website for more information.

This release is copied over and is the final release from the old repository.

Note: A 64-bit version of Java 8 (aka 1.8) or above is required.

First download the jar file[s] of interest. Some users may be able to launch them by simply double clicking on the jar file in a file browser. If this doesn't work, you will need to launch it in a terminal:

java -jar /path/to/jarFile.jar

For example, if I'm in a directory containing HazardCurveGUI-1.5.2.jar and want to run it:

java -jar HazardCurveGUI-1.5.1.jar

If you see any error messages related to "OutOfMemoryException" or java "heap size", or the app stalls when loading a large model (e.g. UCERF3), you'll need to allocate more memory to java. You can do this most easily with the -Xmx argument. For example, to run with 4 GB of memory:

java -Xmx4G -jar HazardCurveGUI-1.5.1.jar

Non-executable library jar files of builds of the OpenSHA code are also supplied:

• opensha-apps.jar: Class files and resources from the opensha-apps project, not including any upstream dependencies
• opensha-apps-all.jar: 'Fat' jar file containing class files and resources from this and upstream projects, including all dependencies

Release notes:

New to 1.5.2:

• Improved chances that out of memory exceptions are successfully caught and show a useful error message to users. Also added memory information to bug reports.
• Cleaned out some necessary data files

Previous (1.5.1):

• Release is now from a maintenance branch in each repository: release-v<major.version>-<minor.version>
• Tomcat server preferences updated such that apps talk to servlets built at release time, rather than being built from master
• Bug reports now put the root cause of a stack track at the top, as long exceptions may be truncated
• UCERF3 ERFs now detect corrupted/truncated data files from failed earlier downloads, and prompt the user to delete and re-download (for #6)