Hazard Curve Data

Discover hazard models that provide hazard curves

User query

Which hazard models provide hazard curves for the site of my interest?

Request format

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

Request example

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

Response example

<models>
    <model>
        <id>57</id>
        <name>SHARE_201208.AsModel</name>
    </model>
    <model>
        <id>65</id>
        <name>Test 2</name>
    </model>
    <model>
        <id>66</id>
        <name>Disagg Testdata 2012-12-12</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>

Which intensity measurement types are covered by a model?

User query

For which IMT are hazard curves available from the model of my interest, describing the site of my interest?

Request format

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

Request example

http://appsrvr.share-eu.org:8080/share/curve?lat=47.0&lon=6.0&modelid=71

Response example

<imtcodes>
  <imtcode>
    <code>SA[0.25s]</code>
    <imunittype>g</imunittype>
    <imunitdescr>gravity, 1g = 980.5 cm/s/s</imunitdescr>
  </imtcode>
  <imtcode>
    <code>SA[0.50s]</code>

    <imunittype>g</imunittype>
    <imunitdescr>gravity, 1g = 980.5 cm/s/s</imunitdescr>
  </imtcode>

....
</imtcodes>

For which site classes is data available?

Note: within SHARE, only hazard for rock sites have been calculated. However, this feature will allow in future to compare SHARE hazard to other hazard calculations.

User query

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

Request format

[base-url]/curve?lat=[latitude]&lon=[longitude]&modelid=[modelID]&imt=[IMT]

Request example

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

Response example

<soiltypes>

   <soiltype>

      <type>rock_vs30_800ms-1</type>

   </soiltype>

</soiltypes>

Hazard aggregation strategies from logic tree models

User query

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

Request format

[base-url]/curve?lat=[latitude]&lon=[longitude]&modelid=[modelID]&IMT=[IMT]&soiltype=[soiltype]

Request example

http://appsrvr.share-eu.org:8080/share/curve?lat=47.5&lon=7.6&modelid=71&imt=PGA&soiltype=rock_vs30_800ms-1

Response example

<hazardcurvetypes>
    <hazardcurvetype>
        <aggregationtype>arithmetic</aggregationtype>
        <aggregationlevel>0.5</aggregationlevel>
    </hazardcurvetype>
</hazardcurvetypes>

Finally...: Retrieving a fully defined hazard curve

Hazard curves are provided in NRML 0.3 format. Note that the NRML (Natural Risk Markup Language) is undergoing rapid development by the GEM openquake development team, with several moves in scope. This is documented here: https://github.com/gem/oq-nrmllib/tree/master/openquake/nrmllib/schema . For the time being, and in order to provide a stable service for data users SHARE is sticking to the 0.3 version, which is pure XML and has an adequate level of self-containedness .

User query

What is the hazard curve that provides all the above specifications?

Request format

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

Request example

http://appsrvr.share-eu.org:8080/share/curve?modelid=71&longitude=7.6821339&latitude=47.5&imt=PGA&soiltype=rock_vs30_800ms-1&aggregationtype=arithmetic&aggregationlevel=0.5

Response example

<?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 saDamping="0.05" saPeriod="0.1" IDmodel="SHARE_201208.AsModel" investigationTimeSpan="50.0"/>
        </ns2:config>
        <ns2:hazardCurveField quantileValue="0.5" statistics="mean" ns1:id="gml_id_9">
            <ns2:IML IMT="PGA">0.005 0.007 0.0098 0.0137 0.0192 0.0269 0.0376 0.0527 0.0738 0.103 0.145 0.203 0.284 0.397 0.556 0.556 0.778 1.09 1.09 1.52 2.13 2.85 3.45</ns2:IML>
            <ns2:HCNode ns1:id="gml_id_10">
                <ns2:site>
                    <ns1:Point srsName="4326">
                        <ns1:pos>7.7821339 47.5</ns1:pos>
                    </ns1:Point>
                </ns2:site>
                <ns2:hazardCurve>
                    <ns2:poE>0.911 0.841 0.738 0.615 0.491 0.380 0.288 0.212 0.151 0.103 0.0653 0.038 0.0202 0.00958 0.00398 0.00146 4.804E-4 1.507E-4 4.448E-5 1.452E-5 6.546E-6</ns2:poE>
                </ns2:hazardCurve>
            </ns2:HCNode>
        </ns2:hazardCurveField>
    </ns2:hazardResult>
</ns2:nrml>