Hazard Map Data

Model discovery service

User query

a)    Which hazard models provide hazard maps covering my site of interest?

b)    Which hazard models provide hazard maps covering my area of interest? The area is defined by a set of points. The response contains all models, of which the boundary polygon comprises all control points.

Request format

a)    [base-url]/map?lat=[latitude]&lon=[longitude]

b)    [base-url]/map?coordinates=[[latitude1, longitude1], [latitude2, longitude2], … [latitudeN, longitudeN]]

Request example

a)      http://appsrvr.share-eu.org:8080/share/map?lat=47.0&lon=6.0

b)      http://appsrvr.share-eu.org:8080/share/map?coordinates=[[-9,36],[-9,62],[30,62],[30,36]]

Response example

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

Discovering intensity measurement types of a model

User query

Given a model, for which intensity measurement types (IMT) or ground motion types are hazard maps available?

Request format

[base-url]/map?id=[model-id]

Request example

http://appsrvr.share-eu.org:8080/share/map?id=57

Response example

<imtcodes>
    <imtcode>
        <code>PGA</code>
        <imunittype>gravity, 1g = 980.5 cm/s/s </imunittype>
        <imunitdescr>g</imunitdescr>
    </imtcode>
    <imtcode>
        <code>SA0.2sec</code>
        <imunittype>gravity, 1g = 980.5 cm/s/s </imunittype>
        <imunitdescr>g</imunitdescr>
    </imtcode>
    <imtcode>
        <code>SA0.1sec</code>
        <imunittype>gravity, 1g = 980.5 cm/s/s </imunittype>
        <imunitdescr>g</imunitdescr>
    </imtcode>
    <imtcode>
        <code>SA2sec</code>
        <imunittype>gravity, 1g = 980.5 cm/s/s </imunittype>
        <imunitdescr>g</imunitdescr>
    </imtcode>
    <imtcode>
        <code>SA1sec</code>
        <imunittype>gravity, 1g = 980.5 cm/s/s </imunittype>
        <imunitdescr>g</imunitdescr>
    </imtcode>
    <imtcode>
        <code>SA3sec</code>
        <imunittype>gravity, 1g = 980.5 cm/s/s </imunittype>
        <imunitdescr>g</imunitdescr>
    </imtcode>
    <imtcode>
        <code>SA4sec</code>
        <imunittype>gravity, 1g = 980.5 cm/s/s </imunittype>
        <imunitdescr>g</imunitdescr>
    </imtcode>
</imtcodes>

Discover probabilities of exceedance and timespans

User query

For which probabilities of exceedance, and time spans are hazard maps for a given model, and IMT available?

Request format

[base-url]/map?id=[model-id]&IMT=[IMT]

Request example

http://appsrvr.share-eu.org:8080/share/map?id=57&IMT=PGA

Response example

<exceedances>
    <exceedance>
        <hmapexceedprob>0.02</hmapexceedprob>
        <hmapexceedyears>50</hmapexceedyears>
    </exceedance>
    <exceedance>
        <hmapexceedprob>0.01</hmapexceedprob>
        <hmapexceedyears>50</hmapexceedyears>
    </exceedance>
    <exceedance>
        <hmapexceedprob>0.1</hmapexceedprob>
        <hmapexceedyears>50</hmapexceedyears>
    </exceedance>
</exceedances>

For which site classes do hazard results apply?

User query

Given a model, an IMT, and a probability of exceedance for a time span, for which site classes (or surface geology types) are hazard maps available?

Request format

[base-url]/map?id=[model-id]&IMT=[IMT]

Request example

http://appsrvr.share-eu.org:8080/share/map?id=57&IMT=PGA

Response example

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

Hazard aggregation strategies in logic tree models

User query

Given a model, an IMT, and a probability of exceedance for a time span, and a soil type, how was the hazard of a multi-branch logic tree model aggregated for the available hazard maps? Potential 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]/map?id=[model-id]&IMT=[IMT]&poe=[probability of exceedance, 0..1]&timespanpoe=[timespan in years]&soiltype=[soiltype]

Request example

http://appsrvr.share-eu.org:8080/share/map?id=57&imt=PGA&poe=0.02&timespanpoe=50&soiltype=rock

Response example

<fractiles>
    <fractile>
        <aggregationtype>arithmetic</aggregationtype>
        <aggregationlevel>0.5</aggregationlevel>
    </fractile>
</fractiles>

Retrieve a map identifier for WMS, shp, and ascii data access

User query

Which is the identity, and WMS layer name, of the hazard map corresponding to all above selection criteria

Request format

[base-url]/map?id=[model-id]&IMT=[IMT]&poe=[probability of exceedance, 0..1]&timespanpoe=[timespan in years]&soiltype=[soiltype]&aggregationtype=[arithmetic | ordinal | single]&aggregationlevel=[0..1]

Request example

http://appsrvr.share-eu.org:8080/share/model?id=57&imt=PGA&hmapexceedprob=0.02&hmapexceedyears=50&soiltype=rock&aggregationtype=arithmetic&aggregationlevel=0.5

Response example

<hazardmaplocation>
    <hmapid>301</hmapid>
    <hmapwms>hmap301</hmapwms>
</hazardmaplocation>

The hmapwms identifier allows a twofold access to the entire hazard map:

a) WMS service

Web map services following OGC standards allow to integrate live hazard maps as a layer for viewing in many modern GIS packages.

Request example

http://efehrmaps.ethz.ch/cgi-bin/mapserv?MAP=/var/www/mapfile/sharehazard.01.map&LAYERS=hmap301&SERVICE=WMS&VERSION=1.1.1&REQUEST=GetMap

b) Download

Download the entire map as a zip-compressed ESRI shape file

Request example

http://efehrmaps.ethz.ch/cgi-bin/mapserv?MAP=/var/www/mapfile/sharehazard.01.map&LAYERS=hmap301&SERVICE=WMS&VERSION=1.1.1&REQUEST=GetMap

 

Alternative data access: get the data of a specified map area in ascii format

User query

Provide the data of a user-defined sub-area (square defined by lower left and upper right coordinates) of a specific hazard map in ASCII format

Request format

[base-url]/map?id=[hazardModelID]&lon1=[lowerLeftLongitude]&lat1=[lowerLeftLatitude]&lon2=[upperRightLongitude]&lat2=[UpperRightLatitude]&imt=[IntensityMeausreType]&hmapexceedprob=[probability of exceedance]&hmapexceedyears =[timespan]&soiltype=[soil type] &aggregationtype =[arithmetic|ordinal] &aggregationlevel=[aggregation level]

Request example

http://appsrvr.share-eu.org:8080/share/map?id=68&lon1=9&lat1=51&lon2=8&lat2=52&imt=PGA&hmapexceedprob=0.02&hmapexceedyears=50&soiltype=rock&aggregationtype=arithmetic&aggregationlevel=0.5

Response example

# longitude; latitude; PGA

8.2821339; 51.2; 0.04202779014472185

8.2821339; 51.3; 0.0388970151615721

8.5821339; 51.2; 0.036568980015480555

8.4821339; 51.3; 0.036326226462101756

8.3821339; 51.3; 0.03721882843748435

8.5821339; 51.3; 0.035329551757294415

8.4821339; 51.2; 0.03748374369234045

8.1821339; 51.3; 0.04114214891532444

8.3821339; 51.2; 0.03976248251260659

8.1821339; 51.2; 0.04410048195059834

8.0821339; 51.3; 0.043218589367995046

8.0821339; 51.2; 0.04602245035525927

[…]