Developers - opensha/opensha-commons GitHub Wiki
OpenSHA has an active and growing developer community. It's use by various groups ranging from the WGCEP to GEM has brought together developers from all over the world. Code contributions related to these projects, as well as those by individuals in the public, academic, and private sector have been significant. As an open source project, OpenSHA welcomes any additional involvement and contributions.
Getting the Source
OpenSHA source code is hosted on GitHub. The starting point for documentation is the opensha-commons README. Once you have downloaded the source, you can compile the project or build jar files for use in external projects. We typically develop OpenSHA code with Eclipse.
If, at some future time, you have made changes or enhancements that warrant inclusion in the project, please submit a pull request, or contact the project to see about getting them integrated.
OpenSHA Project Structure
OpenSHA is split into multiple projects with the following dependencies:
Name | Depends On | Description |
---|---|---|
commons | - | Base commons library |
core | commons | Core OpenSHA library with calculators and models |
ucerf3 | core | UCERF3 model code and data |
apps | ucerf3 | GUI applications |
dev | apps | Development sandbox for shared prototyping |
cybershake | dev | CyberShake interface code and calculators |
The 'releases' pages of the above repositories (except 'dev' and 'cybershake') contain pre-built jar files which can be referenced from external projects.
Bugs? Technical issues?
You can submit a ticket on the 'Issues' page of each OpenSHA sub-project. For example, to submit a bug related to our applications, go here.
Nightly Builds
The latest nightly builds of OpenSHA applications and libray jar files can be downloaded here. These versions are less stable and may also include models which are under development in applications. Prior nightly builds can be found here.