Risk Targeted Documentation
This endpoint returns probabilistic risk-targeted spectral response accelerations that are spatially interpolated from a file of gridded values, for use in developing Risk-Targeted Maximum Considered Earthquake (MCER) ground motions for seismic design reference documents. The returned values are not scaled by maximum-direction factors.
This software is preliminary or provisional and is subject to revision.
It is being provided to meet the need for timely best science. The
software has not received final approval by the U.S. Geological Survey
(USGS). No warranty, expressed or implied, is made by the USGS or the
U.S. Government as to the functionality of the software and related
material nor shall the fact of release constitute any such warranty. The
software is provided on the condition that neither the USGS nor the U.S.
Government shall be held liable for any damages resulting from the
authorized or unauthorized use of the software.
Request Parameters
Required parameters
- referenceDocument
-
Seismic design reference document
Options:NEHRP-2020 - latitude
-
Latitude of site of interest, in decimal degrees
Example:34.05 - longitude
-
Longitude of site of interest, in decimal degrees
Example:-118.25 - siteClass (optional)
-
Site Class, as defined in Chapter 20
Examples:AorBorBCorCorCDorDorDEorE
Output
Web service response
- request
-
- url
- URL of request that returns this response
- parameters
-
- referenceDocument
-
Seismic design reference document
Options:NEHRP-2020 - latitude
-
Latitude of site of interest, in decimal degrees
Example:34.05 - longitude
-
Longitude of site of interest, in decimal degrees
Example:-118.25 - siteClass
-
Site Class, as defined in Chapter 20
Examples:AorBorBCorCorCDorDorDEorE
- date
- Timestamp, in format YYYY-MM-DDThh:mm:ssZ
- status
- Status of response to request, either “success” or “error”
- response
-
- data
-
- sart
- Probabilistic risk-targeted spectral response accelerations
-
- periods
- Array of spectral periods, in seconds
- ordinates
- Array of spectral response accelerations, in units of g
- metadata
-
- modelVersion
- Version of the underlying USGS National Seismic Hazard Model
- vs30
- v s30 , the average shear wave velocity used for the user-specified Site Class, in units of m/s
- scienceBaseUrl
- URL of the ScienceBase webpage where the files of gridded values are posted
- regionName
- Identifier for the geographic region of the gridded values
- gridSpacing
- Grid spacing of the gridded values, in decimal degrees
- spatialInterpolationMethod
- Identifier for the spatial interpolation method used to return values for the location of interest from the gridded values
Example
Request
…/risk-targeted.json?referenceDocument=NEHRP-2020&latitude=34.05&longitude=-118.25&siteClass=BC
Response
{
request:{
date:"2019-06-13T16:01:39.966Z",
referenceDocument:"NEHRP-2020",
status:"success",
url:"http://localhost:8000/ws/designmaps/risk-targeted.json?referenceDocument=NEHRP-2020&latitude=34.05&longitude=-118.25&siteClass=BC",
parameters:{
latitude:34.05,
longitude:-118.25,
siteClass:"BC"
}
},
response:{
data:{
sart:{
periods:[
0,
0.01,
0.02,
0.03,
0.05,
0.075,
0.1,
0.15,
0.2,
0.25,
0.3,
0.4,
0.5,
0.75,
1,
1.5,
2,
3,
4,
5,
7.5,
10
],
ordinates:[
0.7790619409740587,
0.7837234090457014,
0.8061698804316442,
0.9070753537669117,
1.190736997243009,
1.5480743003337807,
1.7679701865384585,
1.960005889947131,
1.8922310233022372,
1.7472906352588435,
1.6126254094578865,
1.3530633685467561,
1.1702150361348724,
0.8614120047680246,
0.6623131640631928,
0.42516856315222196,
0.30567806315027213,
0.1923377073262918,
0.13882941019360331,
0.1107589888804629,
0.07058385703494703,
0.04691252165666185
]
}
},
metadata:{
gridSpacing:0.1,
modelVersion:"v5.0.x",
regionName:"Geomean_RTSAs_siteClass_BC_vs30_760_v190621",
spatialInterpolationMethod:"linearloglinear",
vs30:760
}
}
}