|
|
|
# Sample input
|
|
|
|
## Sample input
|
|
|
|
|
|
|
|
Application input can be user-provided or drawn from the [USGS Hazard Curve Data files](http://earthquake.usgs.gov/hazards/products/). The following example incorporates the “Hazard Curve Data” file for “5Hz (0.2 Second)”; specifically the data for the coordinates (34.05, -118.25) in Los Angeles are used:
|
|
|
|
|
|
|
|
Spectral Response Acceleration Values (corresponding to the x-axis on a hazard curve):
|
|
|
|
### Spectral Response Acceleration Values (corresponding to the x-axis on a hazard curve):
|
|
|
|
0.005, 0.0075, 0.0113, 0.0169, 0.0253, 0.038, 0.057, 0.0854, 0.128, 0.192, 0.288, 0.432, 0.649, 0.973, 1.46, 2.190, 3.28, 4.92, 7.38
|
|
|
|
|
|
|
|
Annual Frequency of Exceedance Values (corresponding to the y-axis on a hazard curve):
|
|
|
|
### Annual Frequency of Exceedance Values (corresponding to the y-axis on a hazard curve):
|
|
|
|
0.5855, 0.5208, 0.4389, 0.3515, 0.2679, 0.1953, 0.1376, 0.09335, 0.06027, 0.03659, 0.02096, 0.01146, 0.005985, 0.002934, 0.001287, 0.0004781, 0.0001411, 0.00003023, 0.000003828
|
|
|
|
|
|
|
|
|
|
|
|
# Sample output
|
|
|
|
## Sample output
|
|
|
|
|
|
|
|
Output summary (yellow box)
|
|
|
|
### Output summary (yellow box)
|
|
|
|
This section provides the risk-targeted ground motion (RTGM) corresponding to a 1% probability of collapse in 50 years. The uniform hazard ground motion (UHGM) used as a starting point for the calculations is provided, as is the Risk Coefficient (RC) representing the ratio of RTGM to UHGM for the site of interest.
|
|
|
|
|
|
|
|
|
|
|
|
Five plots illustrating the step-by-step process of calculating the risk-targeted ground motion are briefly discussed below.
|
|
|
|
|
|
|
|
Hazard Curve
|
|
|
|
### Hazard Curve
|
|
|
|
This is simply a graphical representation of the Spectral Response Acceleration Values (x-axis) and Annual Frequency of Exceedance Values (y-axis) provided by the user. For more information on these values, users are referred to the Documentation for the 2008 Update of the United States National Seismic Hazard Maps (embedded link: http://pubs.usgs.gov/of/2008/1128/).
|
|
|
|
|
|
|
|
Fragility Curves
|
|
|
|
### Fragility Curves
|
|
|
|
These are generic fragility curves…
|
|
|
|
|
|
|
|
Derivative of Fragility Curves
|
|
|
|
### Derivative of Fragility Curves
|
|
|
|
These are simply the derivatives of each respective fragility curve. Provided as a reference for the next step in the calculation process.
|
|
|
|
|
|
|
|
Hazard Curve x Derivative of Fragility Curves
|
|
|
|
### Hazard Curve x Derivative of Fragility Curves
|
|
|
|
Combining the hazard curve for the site with each fragility curve produces a curve illustrating the annual collapse frequency density of a generic structure at the site of interest. Provided as a reference for the next step in the calculation process.
|
|
|
|
|
|
|
|
Cumulative Integral of Hazard Curve x Derivative of Fragility Curves
|
|
|
|
### Cumulative Integral of Hazard Curve x Derivative of Fragility Curves
|
|
|
|
Integrating the Hazard Curve x Derivatives of Fragility Curves produces the cumulative 50-year collapse probability of a generic structure at the site of interest.
|
|
|
|
|
|
|
|
|
|
|
|
API Documentation
|
|
|
|
This section describes… (then proceed with the currently provided documentation)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Risk Targeted Ground Motion - API Documentation
|
|
|
|
## API Documentation
|
|
|
|
|
|
|
|
This page describes the process for creating a request and also defines the terms used in the response output. Additionally some examples are provided to help get you started.
|
|
|
|
Request API
|
|
|
|
|
|
|
|
### Request API
|
|
|
|
|
|
|
|
http://earthquake.usgs.gov/hazards/apps/rtgm_calculator/service/x0,x1,...xN/y0,y1,...yN[/callback]
|
|
|
|
|
| ... | ... | @@ -54,7 +49,8 @@ callback |
|
|
|
Optional. If specified, the JSONP callback to call when the response is returned. This is useful for application developers. Note: If this parameter is specified, the response content-type header is changed from “application/json” to “text/javascript”
|
|
|
|
|
|
|
|
Note: All input hazard curve data must be adjusted with max-direction factors by the user before using the data in this application.
|
|
|
|
Response API
|
|
|
|
|
|
|
|
### Response API
|
|
|
|
|
|
|
|
{
|
|
|
|
status: Response Code,
|
| ... | ... | @@ -117,7 +113,7 @@ originalHCMax |
|
|
|
Number
|
|
|
|
The largest input spectral response acceleration value. This is useful for determining if a resulting spectral acceleration value in the upsampled hazard curve is based on extrapolation.
|
|
|
|
|
|
|
|
Examples
|
|
|
|
### Examples
|
|
|
|
|
|
|
|
Example 1: JSON request, no callback is specified. Note the content-type header in the response.
|
|
|
|
http://earthquake.usgs.gov/hazards/apps/rtgm_calculator/service/0.01,0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9,1,1.1,1.2,1.4,1.7,2/0.5696,0.088335,0.02925,0.01229725,0.00564925,0.00275075,0.001385175,0.000733875,0.0003984225,0.0002205625,0.0001235975,6.881825E-5,3.82493775E-5,1.13329875E-5,1.34645E-6,6.4884E-8
|
| ... | ... | |
| ... | ... | |