|Detailed Descriptions of submission data
||Waveforms can be requested for a SNCL and time window as well as events. Phase information can be requested for events.
||Output formats supported are miniSEED, SAC, ASCII, INT32, FLT32, COSMOS-V0, COSMOS-V1.
Output will be returned as a .tar.gz file, named webstp_yyyy-mm-ddThh-mm-ss.tar.gz. It contains the following :
- citation.txt, contains the DOI for proper accreditation to SCEDC
- request_query_params.txt, the request parameters that were used for the query
- One or more files containing the output from STP in requested output format
||May specify multiple request lines.
Each line in the selection list has the format:
<network-code> <station-code> <channel-code> <location-code> <start-time> <end-time>;
A few examples:
- End each request line with a semi-colon.
- Use '--' for empty location codes.
- Time Formats: YYYY/MM/DD,hh:mm:ss[.sss] or
For e.g. 1997-01-31T12:04:32.123.
- End-time can also be expressed as an increment of start-time. Possible increments are s(seconds), m(minutes), h(hours) and d(days).
For e.g. +1h or +2.5d.
- Wildcards (%) and letters (_) can be used for network, station, location and channel codes.
CI BAK BHE -- 2016/01/01,00:00:00 2016/01/01,01:00:00
CI PASC HHE 00 2016/02/02,22:00:00 2016/02/02,23:00:00
CI PASC HNE 00 2016/02/02,22:00:00 +1.5d
Using webstp programatically
Webstp uses HTTP GET to get data back from the server. This allows the user to build a URL with parameters and then use any programming language's HTTP library to acess the data.
The following parameters are available:
- outputformat: Specify output format. Choose from miniseed, sac, int32, flt32, ascii, cosmos-v0, cosmos-v1
- swapbyteorder: Toggles byte order. Boolean. True indicates the byte order of the STP server's processor, False indicates the opposite byte order
- gaincorrection: Apply station gain to the seismograms. Boolean. True indicates station gain correction is applied.
- truestarttime: Toggles the use of true start time in file headers. The actual start time of the data may differ from user requested start time because of STP's algorithm for parsing waveform data files. Boolean. True indicates the seismograms have actual start time, False indicates they have user requested start time.
- zerofilloff: Toggles the use of padding by STP to fill in gaps in the seismograms. True indicates gaps will be filled with zeros, False indicates no fill.
- sortoff: Toggles the use of sorting of data blocks based on time of arrival. By default, sorting is on i.e. data blocks are sorted by STP server before being served out.
- requesttype: The type of STP request. Choose from continuous, triggered and phase.
- selection: A list of continuous request windows, one per line. See format and example above.
- eventselection: A list of events, one per line.
Mentioned below are some examples using curl and wget.
curl 'https://service.scedc.caltech.edu/webstp/query?outputformat=ascii&requesttype=phase&eventselection=11328922&Submit=Submit' -o out.tar.gz
wget "https://service.scedc.caltech.edu/webstp/query?outputformat=ascii&requesttype=phase&eventselection=11328922&Submit=Submit" -O out.tar.gz
Valid request time windows
Requested time windows that don't fit this formula will return no data.
(timewindow * sr + 100) <= 400 * 1024 * 1024 / 4
where timewindow is end-start in seconds, sr is sample rate of the channel.