Guide
Saildocs GRIB requests explained
Offshore with only email, over satellite or HF radio, you can still get a forecast: email a one-line request to Saildocs and a GRIB file comes back as an attachment. Here is how the line works, with examples to copy.
The request
Send it to query@saildocs.com from any email account, in the body of the message; the subject does not matter. The file comes back to the address you sent from. Several requests can go in one email, one per line.
send GFS:10N,40N,65W,15W|2,2|0,12..120|WIND,PRMSL,WAVES- send
- a one-off file; sub for a subscription (below)
- GFS
- the model: GFS, ECMWF, ICON, or RRFS for North America
- 10N,40N,65W,15W
- the area: south, north, west, east edges, in whole degrees
- 2,2
- the grid spacing in degrees, north-south then east-west
- 0,12..120
- the forecast hours: the first two set the step, repeated out to the last (0, 12, 24 … 120); or list them: 0,24,48
- WIND,PRMSL,WAVES
- what to send: wind, pressure, waves; with GFS also GUST, APCP (rain) and TMP (air temperature)
Examples
Sizes are estimates, as the request builder works them out.
send GFS:48N,52N,7W,3E|0.25,0.25|0,6..48|WIND,PRMSL,GUSTAbout 40 KB.
send GFS:10N,40N,65W,15W|2,2|0,12..120|WIND,PRMSL,WAVESAbout 30 KB.
send ECMWF:10N,40N,65W,15W|2,2|0,24..144|WIND,PRMSLAbout 15 KB.
sub GFS:10N,40N,65W,15W|2,2|0,24..96|WIND,PRMSL,WAVES days=10 time=18:00About 14 KB. To stop it early, send the same line with cancel in place of sub: cancel GFS:10N,40N,65W,15W|2,2|0,24..96|WIND,PRMSL,WAVES days=10 time=18:00
A subscription (sub instead of send) brings a fresh file every day: days= for how many days (14 if you leave it out) and time= for when, in UTC (shortly after 06:00 if you leave it out).
Keep the file small
The size grows with the area, the number of hours and the fields, and with the square of the grid: halve the spacing and the file is four times bigger. Sailmail and Winlink limit what one message can carry, and every kilobyte costs airtime on a satellite phone.
For an ocean crossing, 1° or 2° is plenty: the weather systems are hundreds of miles across. Save 0.25° for a small coastal area. Ask for fewer hours or fewer fields before you shrink the area: a front coming from outside it is the one you need to see.
Let Griblet write it
The request builder on the landing page writes the line for you: drag the area on a map, pick the model, the hours and what to send, and it shows the estimated size and warns you when the file will not fit a Sailmail or Winlink message.
When the file arrives, open it on the Griblet landing page: drop it on the page or choose it. GRIB1 and GRIB2 both work, and the file is read once, then deleted. Saved to your logbook, it opens again offline.