Anglais - Français


Webservice timeseries

This service provides access to the timeseries 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} [nodata=404]


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

Detailed descriptions of each query parameter

Channel options

Parameter Example Discussion
net[work] FR Seismic network name. Accepts wildcards and lists.
sta[tion] CIEL Station name. Accepts wildcards and lists.
loc[ation] 00 Location code. Use loc=-- for empty location codes. Accepts wildcards and lists.
cha[nnel] HHZ Channel Code. Accepts wildcards and lists.

Wildcards and lists

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

Date-range options

Parameter Example Discussion
start[time] 2010-01-10T00:00:00 Selects data on or after the specified start time.
end[time] 2011-02-11T01:00:00 Selects data on or before the specified end time.

The definition of the time interval may take different forms:

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.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 the 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 unit’s conversion. false
waterlevel 10
Waterlevel (en dB) used for the deconvolution.
“none” value corresponds to the classical inverse filtering.
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 the 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)


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)