gov.usgs.earthquake.nshmp

Class ResponseSpectra

java.lang.Object

gov.usgs.earthquake.nshmp.ResponseSpectra

public class ResponseSpectra
extends Object

Entry point for computing deterministic response spectra.

In addition to a main() method, several utility methods are provided for different target users. For instance groundMotion(Gmm, Imt, GmmInput) and spectrum(Gmm, GmmInput) are convenient for use within Matlab as they return simple data container objects that are automatically converted to Matlab structs and arrays. spectra(Set, GmmInput, boolean) returns a more complex result and is for use with web services.

Author:

Peter Powers

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ResponseSpectra.MultiResult The result of calling spectra(Set, GmmInput, boolean).
static class	ResponseSpectra.Result The result produced by calling spectrum(Gmm, GmmInput).

Constructor Summary

Constructors

Constructor and Description
ResponseSpectra()

Method Summary

Modifier and Type	Method and Description
static double[]	groundMotion(Gmm model, Imt imt, GmmInput source) Compute the median ground motion and its standard deviation for a specified GroundMotionModel, intensity measure type (Imt ), and source and site parameterization (GmmInput).
static void	main(String[] args) Entry point for computing deterministic response spectra from the command line.
static ResponseSpectra.MultiResult	spectra(Set<Gmm> gmms, GmmInput input, boolean commonImts) Compute the spectra of ground motions and their standard deviations for multiple models and a source.
static ResponseSpectra.Result	spectrum(Gmm model, GmmInput input) Compute a spectrum of ground motions and their standard deviations for a specified GroundMotionModel and source and site parameterization ( GmmInput).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ResponseSpectra

public ResponseSpectra()

Method Detail

groundMotion

public static double[] groundMotion(Gmm model,
                                    Imt imt,
                                    GmmInput source)

Compute the median ground motion and its standard deviation for a specified GroundMotionModel, intensity measure type (Imt ), and source and site parameterization (GmmInput).

enum types are identified in matlab as e.g. Gmm.ASK_14.

Parameters:

model - to use

imt - intensity measure type (e.g. PGA, SA1P00)

source - and site parameterization

Returns:

a two-element double[] containing the natural log of the median ground motion and its standard deviation

spectrum

public static ResponseSpectra.Result spectrum(Gmm model,
                                              GmmInput input)

Compute a spectrum of ground motions and their standard deviations for a specified GroundMotionModel and source and site parameterization ( GmmInput). All spectral periods supported by the model are returned.

This method is intended for use with Matlab, which converts Result to a struct automatically.

enum types are identified in matlab as e.g. Gmm.ASK_14.

Parameters:

model - to use

input - source and site parameterization

Returns:

a Result

spectra

public static ResponseSpectra.MultiResult spectra(Set<Gmm> gmms,
                                                  GmmInput input,
                                                  boolean commonImts)

Compute the spectra of ground motions and their standard deviations for multiple models and a source. This method provides the option to compute ground motion values either for the set of common spectral accelerations supported by the Gmms specified, or for every spectral acceleration supported by each Gmm. PGA is included in the results with a spectral period of 0.001s.

Parameters:

gmms - GroundMotionModels to use

input - source and site parameterization

commonImts - true if only ground motions corresponding to the spectral accelerations common to all gmms should be computed; false if all spectral accelerations supported by each gmm should be used.

Returns:

a ResponseSpectra.MultiResult data container

main

public static void main(String[] args)

Entry point for computing deterministic response spectra from the command line. Quite a few arguments are required to specify the GroundMotionModel to use and parameterize the earthquake source and site of interest. Example usage:

 java -cp nshmp-haz.jar org.opensha.programs.DeterministicSpectra ...
   ... ASK_14 6.5 10.0 10.3 10.0 90.0 14.0 0.5 7.5 0.0 760.0 true NaN NaN
 

Parameters:

args - [Gmm mag rJB rRup rX dip width zTop zHyp rake vs30 vsInf z1p0 z2p5]