Français - Anglais

logoresif

Webservice FDSN timeseries

Ce service donne accès aux signaux temporels des capteurs sismiques du réseau RESIF. Des traitements supplémentaires peuvent être réalisés sur les données. La plage demandée ne peut excéder 31 jours. Seules les données non restreintes sont accessibles.

Options de traitements du signal

Formats de sorties disponibles

Utilisation de la requête

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

où :

channel-options      ::  (net=<network> & sta=<station> & loc=<location> & cha=<channel>)
date-range-options   ::  (starttime=<date|durée>) & (endtime=<date|durée>)
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=<fréquence>] [hpfilter=<fréquence>] [bpfilter=<fmin-fmax>] {zerophase=<true|FALSE>}
filter-options       ::  [detrend=<true|FALSE>]
filter-options       ::  [diff=<true|FALSE>] [int=<true|FALSE>]
filter-options       ::  [scale=<nombre>] [divscale=<nombre>]
filter-options       ::  [correct=<true|FALSE>] {waterlevel=<nombre>} {freqlimits=<f1-f2-f3-f4>} {units=<AUTO|disp|vel|acc>}
filter-options       ::  [demean=<TRUE|false>]

(..) requis
[..] optionnel
{..} optionnel, mais toujours en complément d'une autre option
les valeurs par défaut sont en majuscules

Exemples de requêtes

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

Descriptions détaillées de chaque paramètre de la requête

Format autorisé pour la station

Les quatre paramètres (network, station, location, channel) déterminent les canaux d’intérêt.

Paramètre Exemple Discussion Valeur par défaut
net[work] FR Nom du réseau sismique. aucune
sta[tion] CIEL Nom de la station. aucune
loc[ation] 00 Code de localisation. Utilisez loc=-- pour des codes de localisations vides. aucune
cha[nnel] HHZ Code de canal. aucune

Jokers et listes d’arguments

Par exemple, pour le code des canaux : channel=EH?,BHZ

Détails sur la nomenclature des codes

Formats autorisés pour l’intervalle de temps

La définition de l’intervalle de temps peut prendre différentes formes :

Avec une date de début et une date de fin

Paramètre Exemple Discussion Valeur par défaut
start[time] 2015-08-12T01:00:00 Date de début. aucune
end[time] 2015-08-13T01:00:00 Date de fin. aucune

Exemple :

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

Combinaison d’une date et d’une durée en secondes

Paramètre Exemple Discussion Valeur par défaut
start[time] 2015-08-12T01:00:00 Date de début. aucune
end[time] 7200 Durée du signal exprimée en secondes. aucune

Exemple :

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

L’exemple précédent spécifie une date pour le paramètre start[time] et 7200 secondes pour le paramètre end[time].

Combinaison du mot-clé “currentutcday” avec une date ou bien une durée en secondes

Le mot-clé “currentutcday” signifie exactement minuit de la date du jour (heure UTC). Il peut être utilisé avec les paramètres start[time] et end[time].

Paramètre Exemple Discussion Valeur par défaut
start[time] 7200 Date ou durée exprimée en secondes. aucune
end[time] currentutcday Minuit (UTC) de la date du jour. aucune

Exemples :

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

Le premier exemple désigne les 2 heures après minuit (heure UTC) du jour actuel. Le second exemple désigne les 2 dernières heures avant minuit (heure UTC) du jour actuel.

Options de traitements des signaux temporels

Les paramètres suivants permettent de filtrer les signaux. L’ordre des paramètres compte puisque chaque opération sera effectuée dans l’ordre donné.

Paramètre Exemple Discussion Valeur par défaut
taper 0.25
0.25, HANNING
0.35, COSINE
Fenêtrage dans le domaine temporel. La taille de la fenêtre est donnée en fraction de la taille du signal (de 0 à 0.5). Elle peut être suivie du type de fenêtre : HANNING (défaut), HAMMING, COSINE. aucune
envelope true Enveloppe du signal par transformée de Hilbert approchée. false
lp[filter] 1.0 Filtre passe-bas (IIR d’ordre 4 / fenêtre de Butterworth)1. aucune
hp[filter] 2.0 Filtre passe-haut (IIR d’ordre 4 / fenêtre de Butterworth)1. aucune
bp[filter] 0.5-1.2 Filtre passe-bande (IIR d’ordre 4 / fenêtre de Butterworth)1,2. aucune
zerophase true Filtrage à phase nulle. Option à utiliser avec : lpfilter, hpfilter ou bpfilter. false
detrend true Supprime la tendance temporelle du signal. false
scale 1.5 Multiplie les valeurs du signal par une constante. aucune
divscale 4.0 Divise les valeurs du signal par une constante. aucune
diff true Signal dérivé (approximation centrée). false
int true Signal intégré (méthode des trapèzes). false
deci[mate] 2.0 Facteur de décimation. Un filtre passe-bas est appliqué pour empêcher l’effet de repliement de spectre (antialiasing). aucune
demean true Retranche la valeur moyenne aux données. false
correct true Applique une correction instrumentale par déconvolution avec conversion en unités géophysiques. false
waterlevel 10
none
Niveau de l’eau (en dB) utilisé pour la déconvolution.
La valeur “none” correspond au filtrage inverse classique.
1
freqlimits 0.01-0.04-0.5-0.6 Filtrage passe-bande appliqué avant la déconvolution dans le domaine fréquentiel1,2. Fenêtre rectangle d’amplitude 1 entre f2 et f3 et en cosinus jusqu’à 0 pour f1 < f < f2 et f3 < f < f4. aucune
units VEL Unité de sortie (AUTO, DISP, VEL, ACC). Actif uniquement avec l’option correct. AUTO

Notes :

  1. Les fréquences sont exprimées en Hertz.

  2. Les fréquences sont séparées par une virgule ou un tiret. (Exemple : 0.01,0.02)

Options des graphiques

Paramètre Exemple Discussion Valeur par défaut
showtitle false Affiche ou non un titre montrant le canal et l’intervalle de dates. true
showscale false Affiche ou non une échelle sur le côté droit du graphique. true
monochrome true Image en niveaux de gris ou en couleur. false
width 500 Largeur de l’image de sortie (pixels). De 400 à 2000. 1200
height 400 Hauteur de l’image de sortie (pixels). De 200 à 2000. 400

Options de sortie

Paramètre Exemple Discussion Valeur par défaut
format ascii Format de sortie du fichier : ascii (équivalent à tspair), mseed, sac, slist ou plot (sortie graphique). aucune

Formats des dates et des heures

YYYY-MM-DDThh:mm:ss[.ssssss] ex. 1997-01-31T12:04:32.123
YYYY-MM-DD ex. 1997-01-31 (une heure de 00:00:00 est supposée)

avec :

YYYY    :: quatre chiffres de l'année
MM      :: deux chiffres du mois (01=Janvier, etc.)
DD      :: deux chiffres du jour du mois (01 à 31)
T       :: séparateur date-heure
hh      :: deux chiffres de l'heure (00 à 23)
mm      :: deux chiffres des minutes (00 à 59)
ss      :: deux chiffres des secondes (00 à 59)
ssssss  :: un à six chiffres des microsecondes en base décimale (0 à 999999)