logoresif

Webservice ph5-dataselect

Ce service donne accès aux données sismiques du réseau RESIF qui sont archivées au format PH5.

Formats de sorties disponibles

miniSEED
SAC binary
GEOCSV (TSPAIR)

Utilisation de la requête

/query? (channel-options) (date-range-options) (output-options) [filter-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=<geocsv|mseed|sac>)
filter-options       ::  [decimate=<2-16>]
filter-options       ::  [reduction=<nombre>]

(..) requis
[..] optionnel
les valeurs par défaut sont en majuscules

Exemples de requêtes

http://ws.resif.fr/resifws/ph5-dataselect/1/query?net=3C&station=N02&channel=DPN&start=2019-11-13T12:00:00&end=2019-11-13T12:50:00&nodata=404&format=sac

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

Jokers : le point d’interrogation ? représente n’importe quel caractère unique, alors que l’astérisque * représente zéro caractère ou plus.
Listes : plusieurs éléments peuvent également être récupérés à l’aide d’une liste séparée par des virgules. Les jokers peuvent être inclus dans la liste.

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

Détails sur la nomenclature des codes

NETWORK : 1 à 2 caractères alphanumériques. Un groupe de points de mesures.
STATION : 1 à 5 caractères alphanumériques. Un site de mesure dans un réseau.
CHANNEL : 3 caractères alphanumériques. Le premier caractère indique la bande de fréquence du capteur, le second le type de l’instrument et le troisième l’orientation physique.
LOCATION : 2 caractères alphanumériques. Ils permettent de distinguer plusieurs flux de données d’un même canal.

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 :

…starttime=currentutcday&endtime=7200…
…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

Paramètre	Exemple	Discussion	Valeur par défaut
reduction	1.5	Réduit la vitesse du signal par une constante.	aucune
deci[mate]	2.0	Facteur de décimation.	aucune

Options de sortie

Paramètre	Exemple	Discussion	Valeur par défaut
format	sac	Format de sortie du fichier : geocsv, mseed, sac	mseed

Requêtes HTTP POST

Les méthodes /extent et /query peuvent être employées avec le protocole HTTP POST. Tous les paramètres valident avec HTTP GET sont utilisables avec HTTP POST.

La forme générale d’une requête POST est un ensemble de paires parameter=value, une par ligne, suivies d’un nombre arbitraire de canaux et d’une fenêtre temporelle optionnelle :

parameter=<value>
parameter=<value>
parameter=<value>
Net Sta Loc Chan [StartTime EndTime]
Net Sta Loc Chan [StartTime EndTime]
…

La fenêtre temporelle peut être précisée globalement :

…
start=2020-10-01T00:00:00
end=2020-10-01T00:01:00
Net1 Sta1 Loc1 Chan1
Net2 Sta2 Loc2 Chan2
…

ou par ligne :

…
Net1 Sta1 Loc1 Chan1 2020-10-01T00:00:00 2020-10-01T00:01:00
Net2 Sta2 Loc2 Chan2 2020-10-02T00:00:00 2020-10-02T00:02:00
…

La fenêtre temporelle globale peut être utilisée conjointement avec des fenêtres temporelles individuelles. Si aucune information temporelle n’est précisée, la période maximale de disponibilité est utilisée.

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)