Anglais - Français

logoresif

Webservice FDSN timeseries

This service provides access to the time series data of the RESIF seismic network. Optional signal processing may be applied and data may be returned in several formats. The time span may be up to 31 days. Only unrestricted data are available.

Signal processing options

Output format options

Query usage

/query? (channel-options) (date-range-options) (output-options) [filter-options] {plot-options}

where:

channel-options      ::  (net=<network> & sta=<station> & loc=<location> & cha=<channel>)
date-range-options   ::  (starttime=<date|duration>) & (endtime=<date|duration>)
output-options       ::  (format=<ascii|mseed|sac|slist|tspair|plot>)
plot-options         ::  {showtitle=<TRUE|false>} {showscale=<TRUE|false>} {monochrome=<true|FALSE>}
plot-options         ::  {width=<400-2000>} {height=<200-2000>}
filter-options       ::  [decimate=<2-16>]
filter-options       ::  [taper=<0.0-0.5,HANNING|hamming|cosine>]
filter-options       ::  [envelope=<true|FALSE>]
filter-options       ::  [lpfilter=<frequency>] [hpfilter=<frequency>] [bpfilter=<fmin-fmax>] {zerophase=<true|FALSE>}
filter-options       ::  [detrend=<true|FALSE>]
filter-options       ::  [diff=<true|FALSE>] [int=<true|FALSE>]
filter-options       ::  [scale=<number>] [divscale=<number>]
filter-options       ::  [correct=<true|FALSE>] {waterlevel=<number>} {freqlimits=<f1-f2-f3-f4>} {units=<AUTO|disp|vel|acc>}
filter-options       ::  [demean=<TRUE|false>]

(..) required
[..] optional
{..} optional, but complements another option
default values are uppercase

Sample Queries

http://ws.resif.fr/resifws/timeseries/1/query?net=RA&station=PYTO&cha=HN2&loc=02&demean&correct&start=2017-11-02T13:35:00&end=2017-11-02T13:40:00&format=ascii

http://ws.resif.fr/resifws/timeseries/1/query?net=RA&station=PYTO&cha=HN2&loc=02&demean&correct&start=2017-11-02T13:35:00&end=2017-11-02T13:40:00&format=plot

Detailed descriptions of each query parameter

Station code details

The four parameters (network, station, location, channel) determine channels of interest.

Parameters Examples Discussion
net[work] FR Seismic network name.
sta[tion] CIEL Station name.
loc[ation] 00 Location code. Use loc=-- for empty location codes.
cha[nnel] HHZ Channel Code.

Wildcards and Lists

For example, with channel codes: channel=EH?,BHZ

Date-range options

The definition of the time interval may take different forms:

Expressed as calendar dates

Parameters Examples Discussion
start[time] 2015-08-12T01:00:00 Start time expressed as a calendar date.
end[time] 2015-08-13T01:00:00 End time expressed as a calendar date.

Example:

…starttime=2015-08-12T01:00:00&endtime=2015-08-13T01:00:00…

Expressed as a calendar date and duration (seconds)

Parameters Examples Discussion
start[time] 2015-08-12T01:00:00 Start time expressed as a calendar date.
end[time] 7200 End time expressed as duration (seconds).

Example:

…starttime=2015-08-12T01:00:00&endtime=7200…

This example specifies a calendar date as the start time and duration of 7200 seconds specified in the end[time] parameter.

Expressed as a calendar date, duration (seconds) or the key word: “currentutcday”

The key word “currentutcday” means exactly midnight of today’s date (UTC time). It may be used for the start[time] and end[time] parameters.

Parameters Examples Discussion
start[time] 7200 Start time expressed as duration (seconds).
end[time] currentutcday Today’s midnight (UTC).

Examples:

  1. …starttime=currentutcday&endtime=7200…
  2. …starttime=7200&endtime=currentutcday…

The first example specifies the duration of 2 hours after today’s midnight (UTC). The second example specifies the duration of 2 hours prior today’s midnight (UTC).

Time series processing options

The following parameters allow filtering the time series. Parameter order matters because each operation is performed in the order given.

Parameters Examples Discussion Default value
taper 0.25
0.25, HANNING
0.35, COSINE
Tapering in the time domain. The window width is specified as a fraction of the trace length from 0 to 0.5. The width may be optionally followed by window type : HANNING (défaut), HAMMING, COSINE. none
envelope true Time series envelope calculed with the approximated Hilbert transform. false
lp[filter] 1.0 Low-pass filter with the specified cutoff 1,2. none
hp[filter] 2.0 High-pass filter with the specified cutoff 1,2. none
bp[filter] 0.5-1.2 Band-pass filter with the specified range 1,2,3. none
zerophase true Zerophase filtering (may be used with lpfilter, hpfilter or bpfilter option). false
scale 1.5 Scale data samples by specified factor. none
divscale 4.0 Scale data samples by the inverse of the specified factor. none
diff true Differentiate using centered method. false
int true Integrate using trapezoidal method. false
deci[mate] 2.0 Decimation factor. A low-pass filter is applied prior to decimation (anti-aliasing filter). none
detrend true Remove the trend of the time series. false
demean true Remove the mean of the time series. false
correct true Apply instrumental correction by deconvolution with earth units conversion. false
waterlevel 10
none
Waterlevel (en dB) used for the deconvolution.
“none” value corresponds to the classical inverse filtering.
1
freqlimits 0.01-0.04-0.5-0.6 Band pass filter applied to the frequency domain prior to the deconvolution1,2. Rectangular window between f2 and f3 and cosine window between f1 and f2 and between f3 and f4. none
units VEL Output unit (AUTO, DISP, VEL, ACC). Enabled only with correct option. AUTO

Notes :

  1. Frequency in Hertz.

  2. IIR 4th order filter with a Butterworth window.

  3. Frequency numbers may be separated by a comma or by a dash. For example : 0.01,0.02 or 0.01-0.02

Plot options

Parameters Examples Discussion Default value
showtitle false Whether or not to show the channel and date-range information on the top of the plot. true
showscale false Whether or not to show a scale on the right-side axis of the plot. true
monochrome true Creates a grayscale or a color plot. false
width 500 Width of the output plot (pixels). The range is 400 to 2000. 1200
height 400 Height of the output plot(pixels). The range is 200 to 2000. 400

Output options

Parameters Example Discussion Default value
format ascii Format of the output file : ascii (equivalent to tspair), mseed, sac, slist or plot (graphical output). none

Date and time formats

YYYY-MM-DDThh:mm:ss[.ssssss] ex. 1997-01-31T12:04:32.123
YYYY-MM-DD ex. 1997-01-31 ( a time of 00:00:00 is assumed)

where:

YYYY    :: four-digit year
MM      :: two-digit month (01=January, etc.)
DD      :: two-digit day (01 through 31)
T       :: date-time separator
hh      :: two-digit hour (00 through 23)
mm      :: two-digit number of minutes (00 through 59)
ss      :: two-digit number of seconds (00 through 59)
ssssss  :: one to six-digit number of microseconds (0 through 999999)