Faire une requête de fichier GRIB à Saildocs

Saildocs est un système automatisé et le format d'une requête de fichier GRIB doit être exactement respecté.

Le format d'une requête de base est :

	gfs:lat0,lat1,lon0,lon1|dlat,dlon|VTs|Params

	•	"lat0,lat1,lon0,lon1" représente les limites Lat/Lon (en degrés entiers suivis de N/S ou E/W). Ce champ est obligatoire, pas de zone par défaut.
	•	"dlat,dlon" est la maille en degrés (ex. "1,1" pour une grille de 1° x 1°). Si omis, la maille par défaut est "2,2". La maille minimum dépend du modèle, voir "modèles disponibles" ci-dessous. Ce paramètre a une incidence importante sur la taille du fichier, voir plu loin. 
	•	"VTs" est une liste d'heures séparées par des virgules (heures des prévisions, ex. "24,48,72"). Sf omis les heures par défaut sont "24,48,72".  Les heures disponibles dépendent du modèle. Notez que les prévisions au-delà de 4 ou 5 jours doivent être regardées avec un scepticisme croissant.
	•	"Params" est une liste de paramètres séparés par des virgules. Si omis, les paramètres par défaut sont WIND et PRESSURE.  

Le caractère de séparation "|" est la barre verticale utilisée dans les requêtes de fichiers GRIB (alt+maj+L avec le clavier Mac).

Si la requête saisie ne tient pas sur une ligne unique, il faut insérer un caractère "=" (égal) et continuer la saisie sur la ligne suivante. Ne pas insérer d'espace vide avant le "=". 

Exemples
=======
Pour demander un fichier GRIB qui couvre la zone 20N-60N et 120W-160W, avec une maille de 2 degrés et une validité de 24 à 72 heures, présentant le vent et la pression au sol, envoyez le mail suivant :
---------------------------
A: query@saildocs.com
Objet: n'importe quoi
---------------------------
send gfs:40N,60N,140W,120W
---------------------------
Notez que c'est identique à :

send gfs:40N,60N,140W,120W|2,2|24,48,72|PRESS,WIND

IMPORTANT: N'insérez aucun espace vide, Saildocs utilise les espaces pour délimiter les paramètres.

Cet exemple aura une taille d'environ 2 Ko. La taille est proportionnelle au nombre de points de données : ex. la taille et la résolution de la grille, le nombre d'heures valides, le nombre de  paramètres, comptent pour 1,5 octet par point. L'effet majeur sur la taille du fichier est la taille de la maille, un fichier avec grille de 1°x1° est 4x plus grand qu'avec une grille de 2°x2°. 
Ce sont des fichiers binaires non compressés, qui peuvent être compressés si ils sont envoyés via des serveurs comme Sailmail, Mailasail ou Winlink radio, il n'y a donc aucun avantage à les pré-compresser.

La requête doit être saisie sur une unique ligne. Cependant une ligne de requête trop longue peut être coupée par un caractère "=" de la manière suivante :

send gfs:20N,60N,160W,120W|2,2|6,12,18,=
24,36,48,72,96|PRESS,WIND time=12:00

Un raccourcis est également valide pour une longue liste d'heures de prévisions, par exemple :

send gfs:20N,60N,160W,120W|2,2|6,12..96|PRESS,WIND

Cela signifie : 6, 12 heures puis répéter le même intervalle de 6 heures jusqu'à 96 heures.

Abonnement
=========

Pour s'abonner à un GRIB déterminé , utilisez le même format et changez simplement le "send" par "sub" (ou "subscribe"), par exemple :
-----------------------------
A: query@saildocs.com
Objet: n'importe quoi
-----------------------------
sub gfs:40N,60N,140W,120W
-----------------------------
Cela crée un abonnement qui enverra le fichier tous les jours peu de temps après 06h00 (UTC). 
L'abonnement par défaut est d'une durée de 14 jours, pour modifier cette durée ajoutez un espace et "days=30" pour un abonnement de 30 jours (ou bien "days=0" pour un abonnement illimité). On peut demander d'autres durées. Par exemple :

sub gfs:20N,60N,160W,120W days=30 time=18:00

Supprimer un abonnement
===================

Envoyez le même message en remplaçant "sub" par "cancel". le reste du message doit être strictement identique à celui de l'abonnement. Les instructions d'abandon sont aussi incluses dans chaque message d'abonnement reçu.

Modèles disponibles
==============

La source principale des fichiers GRIB est le modèle global GFS du NOAA/NCEP (code de requête "gfs:" ou simplement "grib:"). Les échéances valides des prévisions sont 0,3..180 heures avec une maille de 0,5° et 192,204..384 heures avec une maille de 2,5°. (Notez que les données de la maille de 0,5° ne sont pas toujours disponibles, en ce cas Saildocs choisit 1° par défaut). Les paramètres disponibles sont PRESS ou PRMSL pour Pression au niveau moyen de la mer, WIND pour le gradient de vent en surface (à 10 mètres d'altitude), APCP pour les cumuls de précipitations, TCDC pour le gradient de nébulosité, HGT pour les hauteurs de la surface de pression 500 hPa , SEATMP pour la température de la mer en surface, AIRTMP pour la température de l'air (2 mètres d'altitude), WAVES pour la hauteur des vagues (issue du modèle WW3), CAPE (Convective Available Potential Energy) pour le gradient d'instabilité verticale. Les données du modèle sont mises à jour peu de temps avant 06Z (UTC) pour l'exploitation de 00Z et ensuite toutes les 6 heures. 

Des données d'autres modèles du NOAA et de l'US Navy sont disponibles, envoyez un mail (vide) à : gribmodels@saildocs.com pour plus d'informations.

Compatibilité 
==========

Les fichiers GRIB générés par Saildocs ont un format standard WMO qui leur permettent d'être affichés avec le visualisateur Airmail's Viewfax et la plupart des programmes de cartographie incluant Coastal Explorer, Deckman pour Windows, Expedition, Maxsea, Nobeltec, Raytech, GPSNavX, MacENC, et tout type de programme traitant les fichiers GRIB standard. 

Les fichiers GRIB sont envoyés en pièces jointes codées MIME et peuvent être envoyés par radio mail via Sailmail (www.sailmail.com) ou le système Winlink ham-radio (www.winlink.org). En utilisant une connexion à basse vitesse, l'attention doit être portée à la taille du fichier. Sailmail traite les fichiers GRIB jusqu'à 30 Ko (10 Ko pour Pactor-2) mais cela peut parfois être encore trop gros en fonction de la distance, des conditions et de la vitesse de connexion. Winklink autoridse les pièces jointes après que l'utilisateur ait réglé une limite de taille aux pièces jointes, ceci est effectué en envoyant un message d'options Winlink-2000 (menu Airmail's Windows).

Adresses des supports
================
Pour recevoir des informations générales sur Saildocs envoyez un mail (vide) à : info@saildocs.com (répondeur automatique)
Pour des problèmes/questions relatives à Saildocs, envoyez un mail à support@saildocs.com
Pour des problèmes concernant les programmes de cartographie consultez les sites web de chaque concepteur.

Historique
========
Saildocs a été lancé en 1999 pour fournir des prévisions météo par internet aux membres de Sailmail. Il a été créé et supporté par Jim Corenman, co-fondateur de Sailmail avec Stan Honey et concepteur du logiciel Airmail. Le projet GRIB a démarré en 2002 comme un "science project" et a récemment migré sur un nouveau serveur avec connexion a large bande-passante aux serveurs du NOAA. Saildocs continue à être disponible gratuitement, merci au soutien de Sailmail (www.sailmail.com).

Merci d'utiliser Saildocs et bonnes navigations !