Applications - opensha/opensha-commons GitHub Wiki
OpenSHA desktop applications are available at the opensha-apps release page HERE. Information on nightly development builds, which may include additional models and features, can be found 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.
Requirements
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:
- Java 8 (aka 1.8) or above
- 64-bit version of Java
- At least 4 GB of RAM (8 GB or greater recommended)
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 opensha.usc.edu.
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.