Open-Source Seismic Hazard Analysis (OpenSHA)


OpenSHA desktop applications are available at the opensha-apps release page HERE.

Please use the following citation when publishing results generated using OpenSHA:

Field, E.H., T.H. Jordan, and C.A. Cornell (2003), OpenSHA: A Developing Community-Modeling Environment for Seismic Hazard Analysis, Seismological Research Letters, 74, no. 4, p. 406-419.

Note that all applications are being continually developed and that the project provides no guarantees as to their serviceability.

If you encounter an issue with our applications, please submit a ticket here.


Our apps are written in Java and are cross-platform. The OpenSHA developers use Linux and Mac OSX, but apps should run on Windows as well. Basic requirements are as follows:

Check that you have the correct version installed with the java -version command in a terminal (make sure that it says ‘64-Bit’ and that the version is appropriate).

Launching applications

First download the jar file[s] of interest from the latest release (expand the ‘assets’ section to see a list of application jar files). 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.0.jar and want to run it:

java -jar HazardCurveGUI-1.5.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), you’ll need to allocate more memory to java. You can do this most easily with the -Xmx argument which is detailed here. For example, to run with 4 GB of memory:

java -Xmx4G -jar HazardCurveGUI-1.5.0.jar

Firewall information: Some of the applications need to access remote servers. For ShakeMap, Disaggregation, and site data capabilities, make sure that your firewall allows connections to port 8080 on

Application Descriptions

Attenuation Relationship Plotter

Plot Attenuation Relationship curves. Specifically, plot the mean, standard deviation, and probability of exceeding a given IML, or the IML that has a given probability of exceedance, (on the Y-axis) as a function of whatever independent parameters the Attenuation Relationship of interest depends upon. Any independent parameter that represents a numerical value can be used for the X axis. See the user guide here.

GMT Map Plotter

Generate a GMT image map for URL-accessible data.

Hazard Curve Calculator

Compute and plot hazard curves for a specified IMT, IMR, ERF, and Site. See the tutorial here.

Hazard Spectrum Calculator

Use this application to compute and plot hazard spectra. This can be done for either probabilistic spectra (for a specified IMR, ERF, and Site), or for deterministic spectra (for a specified IMR, Source, and Site).

Scenario ShakeMap

Use this application to compute and plot Scenario ShakeMaps for a chosen IMR , Earthquake Rupture, and Geographic Region. See the tutorial here.

Site Data Viewer/Plotter

Download and plot data and maps for site related data such as Vs30 and Basin Depth.

Copyright ©2020 and the University of Southern California. All rights reserved. License—Disclaimer

This website is generated automatically from the OpenSHA wiki on GitHub, and is powered by GitHub Pages and Jekyll