Uniform Hazard Spectra

Discover models that provide uniform hazard spectra

User query

Which hazard models provide uniform hazard spectra for the site of my interest?

Request format

[base-url]/spectra?lat=[latitude]&lon=[longitude]

Request example

http://appsrvr.share-eu.org:8080/share/spectra?lon=7.6&lat=42.5

Response example

<models>
    <model>
        <id>57</id>
        <name>SHARE_201208.AsModel</name>
    </model>
    <model>
        <id>58</id>
        <name>SHARE_201208.FsFbModel</name>
    </model>
    <model>
        <id>60</id>
        <name>SHARE_201211.AsModelBranch01</name>
    </model>
    <model>
        <id>61</id>
        <name>SHARE_201211.AsModelBranch02</name>
    </model>
    <model>
        <id>59</id>
        <name>test</name>
    </model>
</models>

Select spectral ground motion measurement types

User query

Which are the intensity measurement types (IMT) for which response spectra are available from a selected model at my location of interest?

Potential measurement types are spectral acceleration (SA), spectral velocity (SV), and spectral displacement (SD)

Request format

[base-url]/spectra?lat=[latitude]&lon=[longitude]&id=[modelID]

Request example

http://appsrvr.share-eu.org:8080/share/spectra?lon=7.6&lat=42.5&id=57

Response example

<imtcodes>
    <imtcode>
        <code>SA</code>
        <imunittype>m/s/s</imunittype>
        <imunitdescr>spectral acceleration<imunitdescr>
    </imtcode>
    <imtcode>
        <code>SV</code>
        <imunittype>m/s</imunittype>
        <imunitdescr>spectral velocity</imunitdescr>
    </imtcode>
    <imtcode>
        <code>SD</code>
        <imunittype>m</imunittype>
        <imunitdescr>spectral displacement</imunitdescr>
    </imtcode>
</imtcodes>

Explore probabilities of exceedance and timespan

User query

For which probability of exceedance and what time span are response spectra are available a selected model and IMT at my location of interest? Note that from SHARE calculations, spectra are always provided in annual probability of exceedance.

Request format

[base-url]/spectra?lat=[latitude]&lon=[longitude]&id=[modelID]&imt=[SA|SV|SD]

Request example

http://appsrvr.share-eu.org:8080/share/spectra?lon=7.6&lat=42.5&id=57&imt=SA

Response example

<exceedances>
    <exceedance>
        <hmapexceedprob>0.01</hmapexceedprob>
        <hmapexceedyears>1</hmapexceedyears>
    </exceedance>
    <exceedance>
        <hmapexceedprob>0.005</hmapexceedprob>
        <hmapexceedyears>1</hmapexceedyears>
    </exceedance>
    <exceedance>
        <hmapexceedprob>0.001</hmapexceedprob>
        <hmapexceedyears>1</hmapexceedyears>
    </exceedance>
</exceedances>

For which site classes do spectra apply?

User query

For which soil classes /surface geology conditions are uniform hazard spectra available from the model of my interest, describing the hazard in the units of my interest at the site of my interest?

Note that all SHARE hazard data is provided for standard rock sites.

Request format

[base-url]/spectra?lat=[latitude]&lon=[longitude]&modelid=57&imt=PGA

Request example

http://appsrvr.share-eu.org:8080/share/spectra?lat=47.0&lon=6.0&modelid=57&imt=PGA

Response example

<soiltype>
    <type>rock</type>
</soiltype>

Aggregation of hazard spectra from logic tree models

User query

Given a model, an IMT, and a soil type, how was the uniform hazard spectrum of a multi-branch logic tree model aggregated for the available curves? Answers are arithmetic mean (arithmetic aggregation at a 0.5 level), quantiles (ordinal aggregation with levels from 0 … 1), or “single” for single branch models without model branch aggregation.

Request format

[base-url]/spectra?id= lat=[latitude]&lon=[longitude]&[model-id]&IMT=[IMT]&soiltype=[soiltype]

Request example

http://appsrvr.share-eu.org:8080/share/spectra?lat=47.5&lon=7.6&modelid=57&imt=PGA&soiltype=rock

Response example

<hazardspectratypes>
    <hazardspectratype>
        <aggregationtype>ordinal</aggregationtype>
        <aggregationlevel>0.25</aggregationlevel>
    </hazardspectratype>
    <hazardspectratype>
        <aggregationtype>ordinal</aggregationtype>
        <aggregationlevel>0. 5</aggregationlevel>
    </hazardspectratype>
    <hazardspectratype>
        <aggregationtype>ordinal</aggregationtype>
        <aggregationlevel>0.75</aggregationlevel>
    </hazardspectratype>
</hazardspectratypes>

Retrieve an uniform hazard spectrum

User query

Given all previously selected parameters, retrieve a uniform hazard spectrum.

Request format

[base-url]/spectra?id= lat=[latitude]&lon=[longitude]&[model-id]&IMT=[IMT]&soiltype=[soiltype]&aggregationtype=[arithmetic|ordinal]&aggregationlevel=[0..1]

Request example

http://appsrvr.share-eu.org:8080/share/spectra?lat=42.5&lon=7.6&id=57&imt=SA&poe=0.02&timespanpoe=50&soiltype=rock&aggregationtype=arithmetic&aggregationlevel=0.5

Response example

The return format for hazard spectra is structurally an exact analogon to the format for hazard curves:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:nrml xmlns:ns2="http://openquake.org/xmlns/nrml/0.3" xmlns:ns1="http://www.opengis.net/gml" xmlns:ns4="http://www.w3.org/1999/xlink" xmlns:ns3="http://quakeml.org/xmlns/quakeml/1.1">
    <ns2:hazardResult ns1:id="gml_id_8">
        <ns2:config>
            <ns2:hazardProcessing IMT=SA, saDamping="0.05" IDmodel="SHARE_201208.AsModel" investigationTimeSpan="50.0"/>
        </ns2:config>
        <ns2:hazardSpectraField quantileValue="0.5" statistics="mean" ns1:id="gml_id_9">
            <ns2:SpectraPeriodList>0.1 0.3 0.1 3 10 </ns2:SpectraPeriodList>
            <ns2:HSNode ns1:id="gml_id_10">
                <ns2:site>
                    <ns1:Point srsName="4326">
                        <ns1:pos>7.7821339 47.5</ns1:pos>
                    </ns1:Point>
                </ns2:site>
                <ns2:hazardSpectrum>
                    <ns2:poE>0.911 0.615 0.288 0.103 0.0202</ns2:poE>
                </ns2:hazardSpectrum>
            </ns2:HSNode>
        </ns2:hazardSpectraField>
    </ns2:hazardResult>
</ns2:nrml>