ESM REXEL-target-spectrum Web-Service

Sample requests

Data can be obtained using any program supporting the HTTP-GET (e.g. your favourite web browser) or -POST method (e.g. CURL).

Examples with HTTP-GET method:

  • https://esm-db.eu/esmws/rexel-target-spectrum/1/query?seismic-code=EC8_eu&spectrum-type=1&soil-class=B&base-PGA=0.2
  • https://esm-db.eu/esmws/rexel-target-spectrum/1/query?seismic-code=NTC18&soil-class=C&nominal-life=100&topographic-class-ntc18=T2
  • https://esm-db.eu/esmws/rexel-target-spectrum/1/query?seismic-code=NTC18&nominal-life=10
  • Examples with HTTP-POST method:

  • curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/esmws/rexel-target-spectrum/1/query?seismic-code=EC8_eu&spectrum-type=1&soil-class=B&base-PGA=0.2" -o outputfile-target-spectrum.zip
  • curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/esmws/rexel-target-spectrum/1/query?seismic-code=NTC08&soil-class=C&nominal-life=100&topographic-class-ntc08=T2" -o outputfile-target-spectrum.zip
  • curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/esmws/rexel-target-spectrum/1/query?seismic-code=NTC08&nominal-life=10" -o outputfile-target-spectrum.zip
  • HTTP-POST variables (required)

    Option Description
    messageThe clearsign token obtained from the generate-signed-message authentication webservice or from EIDA authentication webpage.

    NOTE: Windows OS could require the option '--ssl-no-revoke'

    Query options

    URL format

    Option Description Default
    seismic-code{NTC18,EC8_it,EC8_eu,EC8_eu_EFEHR,EFEHR_UHS,USER_DEFINED}
    Reference seismic code: NTC18 (Itaian seismic code NTC2018); EC8_it (EC8 spectrum evaluated on MPS04 acceleration grid); EC8_eu (EC8 spectrum); EC8_eu_EFEHR (EC8 spectrum evaluated on ESHM acceleration grid); EFEHR_UHS (ESHM uniform hazard spectrum); USER_DEFINED
    NTC18
    spectrum-type{1,2}
    EC8 spectrum type: 1 = higher level of seismic action; 2 = lower level of seismic action. (if seismic-code = 'EC8_it', 'EC8_eu' or 'EC8_eu_EFEHR')
    1
    latitudeLAT Latitude (if seismic-code = 'NTC08', 'EC8_it', 'EC8_eu_EFEHR' or 'EFEHR_UHS')40.83
    longitudeLON Longitude (if seismic code = 'NTC08', 'EC8_it', 'EC8_eu_EFEHR' or 'EFEHR_UHS')14.19
    soil-class{A,B,C,D,E}
    NTC2018 or EC8 or soil category (if seismic-code = 'NTC08', 'EC8_it', 'EC8_eu' or 'EC8_eu_EFEHR')
    A
    topographic-class-ntc08{T1,T2,T3,T4}
    NTC2018 topographic category (if seismic-code = 'NTC08')
    T1
    topographic-class-ec8{T1X,T2X,T3X,T4X}
    EC8 topographic category (if seismic-code = 'EC8_it', 'EC8_ue' or 'EC8_eu_EFEHR')
    T1X
    base-PGAUser defined Peak Ground Acceleration (PGA) base factor [g] (if seismic-code = 'EC8_eu')0.16
    nominal-life{10,50,100}
    NTC2018 Nominal life [years] (if seismic-code = 'NTC08')
    50
    building-functional{1,2,3,4}
    NTC2018 Building functional type (if seismic-code = 'NTC08')
    2
    limit-state{SLO,SLD,SLV,SLC}
    NTC2018 Limit state probability (if seismic-code = 'NTC08')
    SLV
    aggregation-level{0.05,0.15,mean,median,0.85,0.95}
    (if seismic-code = 'EFEHR_UHS')
    mean
    probability-of-exceedance{0.01,0.02,0.05,0.1,0.39,0.5}
    Probability of exceedance in 50 years (POE) if seismic-code = 'EC8_eu_EFEHR' (e.g. 0.5 = 50% in 50 years, return period 73 years)
    0.5
    horizontal-user-spectrumUser defined spectrum for horizontal component (if seismic-code = 'USER_DEFINED'). Spectrum must be defined at least within the period range 0-4 seconds. String pattern: comma-separated periods plus a lowercase 'x' plus comma-separated spectral ordinates (no spaces allowed). Example: 0,0.5,1,2,4x0.1,0.25,0.25,0.08,0.050,10x0,0
    vertical-user-spectrumUser defined spectrum for vertical component (if seismic-code = 'USER_DEFINED'). Spectrum must be defined at least within the period range 0-4 seconds. String pattern: comma-separated periods plus a lowercase 'x' plus comma-separated spectral ordinates (no spaces allowed). Example: 0,0.5,1,2,4x0.1,0.25,0.25,0.08,0.050,10x0,0

     


    Backend Python software used by this web service was originally developed by Puglia R. and Sgobba S., and it is currently maintained by Felicetta C., Russo E., and Sgobba S.