ESM REXEL-disaggregation-values 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-disaggregation-values/1/query?spectral_parameter=pga&distribution_mode=1&return_period=356
  • https://esm-db.eu/esmws/rexel-disaggregation-values/1/query?latitude=38.917&longitude=16.585&spectral_parameter=all&distribution_mode=all
  • https://esm-db.eu/esmws/rexel-disaggregation-values/1/query?spectral_parameter=sa_t1_500&distribution_mode=all

    • Examples with HTTP-POST method:

  • curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/esmws/rexel-disaggregation-values/1/query?spectral_parameter=pga&distribution_mode=1&return_period=356" -o outputfile-disaggregation-values.json
  • curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/esmws/rexel-disaggregation-values/1/query?latitude=38.917&longitude=16.585&spectral_parameter=all&distribution_mode=all" -o outputfile-disaggregation-values.json
  • curl -X POST -F "message=@path/to/token.txt" "https://esm-db.eu/esmws/rexel-disaggregation-values/1/query?spectral_parameter=sa_t1_500&distribution_mode=all" -o outputfile-disaggregation-values.json

    • 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
    latitude Latitude value in decimal degrees (valid for Italian sites only). 40.8279365
    longitude Longitude value in decimal degrees (valid for Italian sites only). 14.1857001
    distribution_mode {1,2,all}
    1 = first mode of the probability distribution; 2 = second mode of the probability distribution    		 1
    return_period Each entered value is rounded to the nearest return period among those for which the Italian hazard map is defined (50,475,975,2475) 475
    spectral_parameter {'pga', 'sa_t0_500', 'sa_t1_000', 'sa_t1_500', 'all'}
    Ground motion parameters: peak ground acceleration (pga) and elastic pseudo-acceleration response spectrum (SA - 5% damped) at three vibration periods at 0.5s (sa_t0_500), 1s (sa_t1_000), and 1.5s (sa_t1_500)     		all
    tolerance_magnitude Tolerance +/- for magnitude 0.75
    tolerance_epidistance Tolerance +/- for epicentral distance (km) 10
    indent {true,false} Prettifies output setting a 4 spaces indentation style. Valid only in combination with 'json' format false

     

    Backend Python software used by this web service is developed and maintained by Felicetta C. and Russo E.