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.
Some features (e.g., ShakeMap, Disaggregation, site data web services) require an internet connection; make sure that your firewall allows connections to ports
opensha.usc.edu. We run an automated test every 6 hours to ensure that our server is up and working, current results of that test can be seen below. If the badge below says “failing” then we have already been notified and will correct the issue as soon as possible, in which case please try again later.
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).
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, or search for ‘increase java heap space’ for more information and alternative methods. For example, to run with 4 GB of memory:
java -Xmx4G -jar HazardCurveGUI-1.5.0.jar
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.
Generate a GMT image map for URL-accessible data.
Compute and plot hazard curves for a specified IMT, IMR, ERF, and Site. See the tutorial here.
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).
Use this application to compute and plot Scenario ShakeMaps for a chosen IMR , Earthquake Rupture, and Geographic Region. See the tutorial here.
Download and plot data and maps for site related data such as Vs30 and Basin Depth.
Copyright ©2022 University of Southern California. All rights reserved. License—Disclaimer