ITACA Processing Web-Service

Sample requests

The service must be queried using any program supporting the HTTP-POST method, e.g. CURL:

  • curl -X POST "https://itaca.mi.ingv.it/itaca40ws/processing/1/query?waveform=TV.MIR01..HN.IT-2012-0011.h5&psoft=old&procmd=__ca_10__cz_20__he_30.0__hn_30.0__hz_30.0&tmpdir=0987654321"
  • curl -X POST -F "parameters=@path/to/parameters.json" "https://itaca.mi.ingv.it/itaca40ws/processing/1/query?waveform=HL.IACM..HN.INT-20220713_0000061.h5&psoft=new&tmpdir=0987654321"
  • Restricted Data (authenticated users only)

    ITACA Administrators and users with special authorizations can access data intended for internal use and/or embargoed.

    HTTP-POST variables

    Option Description
    messageThe clearsign token obtained from the generate-signed-message authentication webservice.
    parametersParameters for waveform processing in a JSON file structured as the output from the waveform-details webservice. NOTES: needed only with 'psoft=new'; can also be provided as the BODY of the POST request.

    Query options

    Option Description Default
    waveformWaveform filename to process, e.g. 'CU.GTBY.20.HN.EMSC-20180217_0000003.h5'n/a
    psoftProcessing software to run. Available versions are 'old' and 'new'old
    ptargetSpecify processing action to perform; available types are: 'mp' (manually processed using Paolucci et al., 2011), 'ap' (automatically processed using Paolucci et al., 2011), 'ab' (automatically processed using Schiappapietra et al., 2021), and 'mb' (manually processed using Schiappapietra et al., 2021). NOTE: 'ab' and 'mb' can be used only with 'psoft=new'.mp
    procmdCommand string for the legacy processing software (to be used only with 'psoft=old'), e.g. '__ta_5__tz_5__ca_70.3__cz_171.1__he_40.0__hn_40.0__hz_40.0__le_0.15__ln_0.15__lz_0.15__fo_2__tr_NT'n/a
    tmpdirSpecify a subdirectory name to get data from. NOTES: It has to be the same specified in the previous steps of the processing workflow; only alphanumeric characters are allowed.n/a
    indent{true,false} Prettifies output setting a 4 spaces indentation style.false

     


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