To allow the comparison of the hazard spectrum predicted by a hazard model with the Eurocode 8 design spectra, we provide a service that computes the EC8 elastic response spectrum Se(T) (EN 1998-1:2004) at a site for a given design ground acceleration, spectrum type and ground type.
Calculations follow Doğangün, A. and Livaoğlu, R. (2006): A comparative study of the design spectra defined by Eurocode 8, UBC, IBC and Turkish Earthquake Code on R/C sample buildings. Journal of Seismology 10, pp. 335–351.
The service is available through the EFEHR REST API under the base URL https://efehr-services.ethz.ch/api/v1. It uses HTTP GET and returns JSON by default; add format=nrml to receive NRML instead. The complete, interactive reference is available at efehr-services.ethz.ch/api/docs.
| User query | Provide the EC8 elastic design spectrum for a given design ground acceleration, event type (Type 2 for earthquakes with magnitude smaller than 5.5, Type 1 for larger ones) and ground type. |
|---|---|
| Request format | /v1/design-spectra/elastic-ec?lat=[latitude]&lon=[longitude]&design-acceleration=[ag]&spectratype=[smallmag | largemag]&soiltype=[A | B | C | D | E]&damping=[%] |
| Parameters |
|
| Request example | https://efehr-services.ethz.ch/api/v1/design-spectra/elastic-ec?lat=47.5&lon=7.6&design-acceleration=0.15&spectratype=largemag&soiltype=B |
| Response example |
{
"spectrum": {
"lon": 7.6,
"lat": 47.5,
"imt": "SA",
"design_acceleration": 0.15,
"spectra_type": "largemag",
"soil_type": "B",
"damping": 5.0,
"standard": "EN 1998-1:2004",
"points": [
{
"period": 0.0,
"acceleration": 0.18
},
{
"period": 0.05,
"acceleration": 0.27
},
{
"period": 0.1,
"acceleration": 0.36
},
{
"period": 0.15,
"acceleration": 0.45
},
{
"period": 0.2,
"acceleration": 0.45
},
{
"period": 0.25,
"acceleration": 0.45
},
{
"period": 0.3,
"acceleration": 0.45
},
{
"period": 0.4,
"acceleration": 0.45
},
{
"period": 0.5,
"acceleration": 0.45
},
{
"period": 0.6,
"acceleration": 0.375
},
{
"period": 0.7,
"acceleration": 0.321429
},
{
"period": 0.8,
"acceleration": 0.28125
},
{
"period": 0.9,
"acceleration": 0.25
},
{
"period": 1.0,
"acceleration": 0.225
},
{
"period": 1.25,
"acceleration": 0.18
},
{
"period": 1.5,
"acceleration": 0.15
},
{
"period": 2.0,
"acceleration": 0.1125
},
{
"period": 2.5,
"acceleration": 0.072
},
{
"period": 3.0,
"acceleration": 0.05
},
{
"period": 4.0,
"acceleration": 0.028125
}
]
},
"metadata": {
"source": "EFEHR Services FastAPI",
"note": "Values computed from EN 1998-1:2004 (EC8). Verify against standard before use."
}
}
|