Uniform Hazard Spectra calculator

A Uniform Hazard Spectrum (UHS) is defined as a set of spectral acceleration amplitudes, for a given number of periods, corresponding to a given probability of exceedence.

The UHS calculators allows to compute UHS for a set of sites of interest.

The implementation of the UHS calculator requires the definition of a new CALCULATION_MODE = UHS

Given a region or a set of site where to compute UHS, the following new parameter must be defined:
PERIODS_FOR_UHS = list of periods, in ascending order, to be used for spectra calculations.
POES_FOR_UHS = list of probabilities of exceedence values to be used for spectra calculations.

The input for the UHS calculator is represented by a source model logic tree and a gmpe logic tree (represented by the keys SOURCE_MODEL_LOGIC_TREE_FILE and GMPE_LOGIC_TREE_FILE)

The parameters needed to compute the earthquake rupture forecast from a source model and to set the GMPE parameters must be also defined:

MINIMUM_MAGNITUDE
INVESTIGATION_TIME
MAXIMUM_DISTANCE
WIDTH_OF_MFD_BIN

COMPONENT
INTENSITY_MEASURE_LEVELS
GMPE_TRUNCATION_TYPE
TRUNCATION_LEVEL
STANDARD_DEVIATION_TYPE
REFERENCE_VS30_VALUE
REFERENCE_DEPTH_TO_2PT5KM_PER_SEC_PARAM
SADIGH_SITE_TYPE

INCLUDE_AREA_SOURCES
TREAT_AREA_SOURCE_AS
AREA_SOURCE_DISCRETIZATION
AREA_SOURCE_MAGNITUDE_SCALING_RELATIONSHIP

INCLUDE_GRID_SOURCES
TREAT_GRID_SOURCE_AS
GRID_SOURCE_MAGNITUDE_SCALING_RELATIONSHIP

INCLUDE_FAULT_SOURCE
FAULT_RUPTURE_OFFSET
FAULT_SURFACE_DISCRETIZATION
FAULT_MAGNITUDE_SCALING_RELATIONSHIP
FAULT_MAGNITUDE_SCALING_SIGMA
RUPTURE_ASPECT_RATIO
RUPTURE_FLOATING_TYPE

INCLUDE_SUBDUCTION_FAULT_SOURCE
SUBDUCTION_FAULT_RUPTURE_OFFSET
SUBDUCTION_FAULT_SURFACE_DISCRETIZATION
SUBDUCTION_FAULT_MAGNITUDE_SCALING_RELATIONSHIP
SUBDUCTION_FAULT_MAGNITUDE_SCALING_SIGMA
SUBDUCTION_RUPTURE_ASPECT_RATIO
SUBDUCTION_RUPTURE_FLOATING_TYPE

A prototype of the UHS calculator has been implemented and can be found here: https://github.com/monellid/shaCalcs/blob/master/src/UniformHazardSpectrumCalculator.java
A test class checking the scientific validity of the calculator is here:
https://github.com/monellid/shaCalcs/blob/master/src/UniformHazardSpectrumCalculatorTest.java

For each site of interest a UHS for each probability of exceedence set by the user must be calculated. Moreover, a UHS is calculated for each logic tree sample.

Aggregated results must be also produced. From the set of results produced by the logic tree sampling, the mean UHS must be computed and also the UHS corresponding to quantile levels.

===================
Notes from Lars Butler:

For POES_FOR_UHS, we could simply use the general POES parameter (which was a changed made at the beginning of the Disaggregation calculator work).
===================