hazard

Compute probabilisitic seismic hazard curves at a site of interest.

Formats

  • https://earthquake.usgs.gov/nshmp-haz-ws/hazard/edition/region/longitude/latitude/imt/vs30
  • https://earthquake.usgs.gov/nshmp-haz-ws/hazard?edition=value&region=value&longitude=value&latitude=value&imt=value&vs30=value

Parameters

  • edition [E2008, E2014]
  • region [COUS, WUS, CEUS]
  • longitude (-360..360) °
  • latitude [-90..90] °
  • imt (intensity measure type) [PGA, SA0P2, SA1P0]
  • vs30 [180, 259, 360, 537, 760, 1150, 2000] m/s
For the slash delimited format, multiple, comma-delimited IMTs may be supplied. Alternatively, "any" may be supplied as the IMT id and the service will return curves for all supported IMTs. For the name-value pair format, one may use multiple IMT name-value pairs, or omit the IMT argument altogether to return curves for all supported IMTs
See usage for parameter dependencies

Examples

https://earthquake.usgs.gov/nshmp-haz-ws/hazard/E2008/WUS/-118.25/34.05/PGA/760
https://earthquake.usgs.gov/nshmp-haz-ws/hazard?edition=E2008&region=WUS&longitude=-118.25&latitude=34.05&imt=PGA&vs30=760

deagg

Deaggregate seismic hazard.

Formats

  • https://earthquake.usgs.gov/nshmp-haz-ws/deagg/edition/region/longitude/latitude/imt/vs30/returnperiod
  • https://earthquake.usgs.gov/nshmp-haz-ws/deagg?edition=value&region=value&longitude=value&latitude=value&imt=value&vs30=value&returnperiod=value

Parameters

  • edition [E2008, E2014]
  • region [COUS, WUS, CEUS]
  • longitude (-360..360) °
  • latitude [-90..90] °
  • imt (intensity measure type) [PGA, SA0P2, SA1P0]
  • vs30 [180, 259, 360, 537, 760, 1150, 2000] m/s
  • returnperiod [1..4000] years
The deaggregation service only supports calculations for a single IMT, which must be specified
See usage for parameter dependencies

Examples

https://earthquake.usgs.gov/nshmp-haz-ws/deagg/E2008/WUS/-118.25/34.05/PGA/760/2475
https://earthquake.usgs.gov/nshmp-haz-ws/deagg?edition=E2008&region=WUS&longitude=-118.25&latitude=34.05&imt=PGA&vs30=760&returnperiod=2475

rate

Compute the annual rate of earthquakes at a site of interest.

Formats

  • https://earthquake.usgs.gov/nshmp-haz-ws/rate/edition/region/longitude/latitude/distance
  • https://earthquake.usgs.gov/nshmp-haz-ws/rate?edition=value&region=value&longitude=value&latitude=value&distance=value

Parameters

  • edition [E2008, E2014]
  • region [COUS, WUS, CEUS]
  • longitude (-360..360) °
  • latitude [-90..90] °
  • distance [0.01..1000] km
See usage for parameter dependencies

Examples

https://earthquake.usgs.gov/nshmp-haz-ws/rate/E2008/WUS/-118.25/34.05/20
https://earthquake.usgs.gov/nshmp-haz-ws/rate?edition=E2008&region=WUS&longitude=-118.25&latitude=34.05&distance=20

probability

Compute the Poisson probability of earthquake occurrence at a site of interest.

Formats

  • https://earthquake.usgs.gov/nshmp-haz-ws/probability/edition/region/longitude/latitude/distance
  • https://earthquake.usgs.gov/nshmp-haz-ws/probability?edition=value&region=value&longitude=value&latitude=value&distance=value&timespan=value

Parameters

  • edition [E2008, E2014]
  • region [COUS, WUS, CEUS]
  • longitude (-360..360) °
  • latitude [-90..90] °
  • distance [0.01..1000] km
  • timespan [1..10000] years
See usage for parameter dependencies

Examples

https://earthquake.usgs.gov/nshmp-haz-ws/probability/E2008/WUS/-118.25/34.05/20/50
https://earthquake.usgs.gov/nshmp-haz-ws/probability?edition=E2008&region=WUS&longitude=-118.25&latitude=34.05&distance=20&timespan=50

gmm/spectra

Compute determinisitic reponse spectra.

Formats

  • https://earthquake.usgs.gov/nshmp-haz-ws/gmm/spectra?gmm=value&Mw=value&rjb=value&rrup=value&rx=value&dip=value&width=value&ztop=value&zhyp=value&rake=value&vs30=value&vsinf=boolean&z2p5=value&z1p0=value

Parameters

  • gmm [AS_97, ZHAO_16_UPPER_MANTLE]
  • Mw [-2, 9.7]
  • rjb [0, 1000] km
  • rrup [0, 1000] km
  • rx [0, 1000] km
  • dip [0, 90] °
  • width [0, 60] km
  • ztop [0, 700] km
  • zhyp [0, 700] km
  • rake [-180, 180] °
  • vs30 [150, 2000] m/s
  • vsinf boolean
  • z1p0 [0, 5] km
  • z2p5 [0, 10] km
Not all parameters are used by every ground motion model (gmm). At least one "gmm" must be specified. Default values will be used for any parameters not specified.
See usage for parameter dependencies

Examples

https://earthquake.usgs.gov/nshmp-haz-ws/gmm/spectra?gmm=AB_06_PRIME&gmm=CAMPBELL_03&gmm=FRANKEL_96&mw=8.7&rjb=10.0&rrup=23.0&rx=32.0&dip=30.0&width=25.0&ztop=10.0&zhyp=20.0&rake=90.0&vs30=760.0&vsinf=true&z2p5=NaN&z1p0=NaN

gmm/distance

Compute ground motion Vs. distance.

Formats

  • https://earthquake.usgs.gov/nshmp-haz-ws/gmm/distance?gmm=value&Mw=value&imt=value&dip=value&width=value&ztop=value&vs30=value&vsinf=boolean&rMin=value&rMax=value&z2p5=value&z1p0=value

Parameters

  • gmm [AS_97, ZHAO_16_UPPER_MANTLE]
  • Mw [-2, 9.7]
  • imt (intensity measure type) [PGA, SA10P0]
  • dip [0, 90] °
  • width [0, 60] km
  • ztop [0, 700] km
  • vs30 [150, 2000] m/s
  • vsinf boolean
  • rMin 0.001 km
  • rMax 300 km
  • z1p0 [0, 5] km
  • z2p5 [0, 10] km
Not all parameters are used by every ground motion model (gmm). At least one "gmm" must be specified. Default values will be used for any parameters not specified.
See usage for parameter dependencies

Examples

https://earthquake.usgs.gov/nshmp-haz-ws/gmm/distance?gmm=AB_06_PRIME&gmm=CAMPBELL_03&gmm=FRANKEL_96&imt=PGA&Mw=6.5&zTop=0.5&dip=90&width=14&vs30=760&vsInf=true&z1p0=&z2p5=&rMin=0.001&rMax=300

gmm/hw-fw

Compute ground motion Vs. distance.

Formats

  • https://earthquake.usgs.gov/nshmp-haz-ws/gmm/hw-fw?gmm=value&Mw=value&imt=value&dip=value&width=value&ztop=value&vs30=value&vsinf=boolean&rMin=value&rMax=value&z2p5=value&z1p0=value

Parameters

  • gmm [AS_97, ZHAO_16_UPPER_MANTLE]
  • Mw [-2, 9.7]
  • imt (intensity measure type) [PGA, SA10P0]
  • dip [0, 90] °
  • width [0, 60] km
  • ztop [0, 700] km
  • vs30 [150, 2000] m/s
  • vsinf boolean
  • rMin -20 km
  • rMax 70 km
  • z1p0 [0, 5] km
  • z2p5 [0, 10] km
Not all parameters are used by every ground motion model (gmm). At least one "gmm" must be specified. Default values will be used for any parameters not specified.
See usage for parameter dependencies

Examples

https://earthquake.usgs.gov/nshmp-haz-ws/gmm/hw-fw?gmm=AB_06_PRIME&gmm=CAMPBELL_03&gmm=FRANKEL_96&imt=PGA&Mw=6.5&zTop=0.5&dip=90&width=14&vs30=760&vsInf=true&z1p0=&z2p5=&rMin=-20&rMax=70