Repository files navigation

PrimaryOpenSHA code repository

This tests for compile errors on the master branch	This runs our standard test suite on the master branch	This runs every 6 hours and tests that our servers at opensha.usc.edu and globus.org CARC is accessible and web services are working

This repository contains OpenSHA code and model implementations. This project is intended for the core APIs and stable models. Exploratory code or one-off tests should instead go in our development sandbox,opensha-dev, which has this project as a dependency.

• Java 11 JDK or later, 64-bit:AdoptOpenJDK orOpenJDK
• Git
  • Git is included in the macOSdeveloper tools.
  • Windows users may want to considerGit for Windows, which includes a linux-like terminal (Git BASH) in which subsequent commands listed here will work.

Other dependencies are managed withGradle, which does not require a separate installation. Gradle is clever about finding Java, but some users may have to explicitly define aJAVA_HOME environment variable.

To clone this project in a terminal (simplest and quickest for most users):

cd~/git# create this directory or navigate an alternative directory of your choosinggit clone https://github.com/opensha/opensha.git

OpenSHA uses Gradle to handle the build process from dependency management to compilation. You should compile OpenSHA from your lowest level project,opensha-dev for the example above.

cd opensha./gradlew assemble

This will build all source files in opensha. It will also build a jar file for each project, not including any dependencies. You can build a "fat jar" which includes dependent libraries as follows:

cd opensha./gradlew fatJar

Most active OpenSHA development is done throughEclipse. You will need the Eclipse IDE for Java Developers.

NOTE: The following instructions assume that you have already cloned the OpenSHA projects on a terminal, though you can clone them through Eclipse. If you chose to go this route, be sure to leave the "Import all existing Eclipse projects after clone finishes" check-boxUNSELECTED, as this feature will cause issues with gradle.

Once you have eclipse installed and running, do the following:

• File > Import
• SelectGradle > Existing Gradle Project and hitNext
• Browse to the location ofopensha underProject root directory
• HitFinish

You can either use Eclipse's built in Git tools, or the Git command line client to pull/push changes. Any time any of the.gradle files are modified, or you see many unexpected compilation errors, right click on the project within eclipse and selectGradle > Refresh Gradle Project.

OpenSHA has been in active development since the early 2000's. It was originally in CVS version control, and was ported tothis SVN repository circa 2008. In 2017, it was migrated to GitHub and split into a number of sub-projects. History from the SVN repository was not retained, but it isarchived here. The main codebase, which was re-unified into this repository in 2021, was previously stored in the now-archivedopensha-commons,opensha-core,opensha-ucerf3, andopensha-apps.

A development sandbox, with which we're more relaxed with write-permissions, can be foundhere. Otherwise, outside contributions should come in the form of pull requests on this repository.