Difference between revisions of "Importing NOAA Winds"

From VRTool wiki
Jump to: navigation, search
(Setting the Number of Forecasts)
m
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The winds used in the VR and VORG games are generated from weather GRIBs downloaded from NOAA's [http://nomads.ncdc.noaa.gov/data.php#hires_weather_datasets Global Forecast System]. This weather is then processed by the game servers and fed to the game clients on players machines at the regular 12-hourly weather updates.
+
The winds used in Virtual Regatta games are generated from weather GRIBs downloaded from NOAA's [http://nomads.ncdc.noaa.gov/data.php#hires_weather_datasets Global Forecast System]. This weather is then processed by the game servers and fed to the game clients on players machines at regular intervals.
  
VRTool is able to import these same weather GRIBS imported directly from the NOAA server, independently of the game. This has the obvious competitive benefit that VRTool has updated forecasts well in advance of the 12-hourly game feed, allowing players to make early course adjustments for the future weather.   
+
VRTool is able to import these same weather GRIBS directly from the NOAA server, independently of the game. This has the obvious competitive benefit that VRTool can get the forecasts in advance of the regular game feeds, allowing players to make early course adjustments for the future weather.   
  
 
Winds are imported using VRTool's built-in '''NOAA Import Module'''. There are various configuration settings in the module to ensure that the correct forecasts are extracted from the NOAA server, and that the subsequent processing is consistent with the game servers.
 
Winds are imported using VRTool's built-in '''NOAA Import Module'''. There are various configuration settings in the module to ensure that the correct forecasts are extracted from the NOAA server, and that the subsequent processing is consistent with the game servers.
  
[[File:ToolbarWinds.gif|right]]The '''NOAA Import Module''' is started by clicking the '''Winds''' button on the main toolbar. (The same button is also available on the '''Wind Grids''' control panel in the "Winds" tab.)
+
The '''NOAA Import Module''' is started by clicking the '''Winds''' [[File:ToolbarWinds.gif]] button on the main toolbar. (The same button is also available on the '''Wind Grids''' control panel in the "Winds" tab.)
 +
 
 +
  Tip: NOAA changed GFS access methods in jan/15. Update VRTool to the newest version to download GFS forecasts.
  
  
Line 20: Line 22:
 
{|class="wikitable"
 
{|class="wikitable"
 
|''Tip: You may experience problems if you try to download a weather grib which crosses the 180° meridian. VRTool will reset one of the boundaries to the 180° meridian. This is an issue with the NOAA download facility, not VRTool. If you need your routing to cross the 180° meridian you will need to download separate gribs each side of the meridian.''
 
|''Tip: You may experience problems if you try to download a weather grib which crosses the 180° meridian. VRTool will reset one of the boundaries to the 180° meridian. This is an issue with the NOAA download facility, not VRTool. If you need your routing to cross the 180° meridian you will need to download separate gribs each side of the meridian.''
 +
|}<br style="clear: both" />
 +
 +
== Download Parameters ==
 +
[[File:NOAADownloadParamsVORG.gif|right]]'''Time Zone''': Set this to your computer's time zone setting. You can click on the icon to retrieve this automatically. The module uses this setting along with your computer's time to determine the UTC time, which is used to probe the NOAA database for the files with the correct time stamp.
 +
{|class="wikitable"
 +
|'''Tip for users in New Zealand:''' ''If your system time zone is set to '''(UTC+12:00) Auckland, Wellington''' the [[File:IconLisa.gif]] icon returns a time zone of '''-12''' during NZST, or '''-13''' during NZDT. You should use these rather odd settings - they work correctly in VRTool.''
 
|}
 
|}
<br style="clear: both" />
 
  
== VORG 2011-2012 Settings ==
+
'''Resolution''': This setting determines the forecast interval in hours that the module downloads. The NOAA model produces forecasts at 6-hour intervals, so 6 is the lowest setting you can use for the resolution. If you set it to 12 the module will download every second forecast.
[[File:VORGLogo.gif]]
+
 
 +
'''Up to''': Determines the number of forecasts downloaded. The maximum setting of 384 hours will download all of the available weather. On a broadband connection you can happily leave this set on the maximum. Use a reduced value if you know you will reach your destination in less time and you are using a slow connection - this speeds up the download.
  
=== Download Parameters ===
 
[[File:NOAADownloadParamsVORG.gif|right]]'''Time Zone''': Set this to your computer's time zone setting. You can click on the icon to retrieve this automatically. (''Not sure what VRTool does with this.'')
 
 
{|class="wikitable"
 
{|class="wikitable"
|''Tip: For users in the GMT +12:00 zone (eg New Zealand), clicking on the icon retrieves a system time zone of -12. The -12 setting seems to work correctly.''
+
|'''''Tip:''' Although the NOAA GFS generates gribs out to 384 hours (16 days) in the future, VRTool can only access the gribs beyond 192 hours at certain times, which are:''
 +
 
 +
*''10:45 - 16:00 UTC''
 +
*''22:45 - 04:00 UTC''
 +
 
 +
''At all other times the download will stop at around 192 hours. The reasons for this are explained [[NOAAWinds#Getting long-range forecasts|here]].''
 
|}
 
|}
'''Resolution''': Set to 12. This is the forecast interval in hours. (''Not sure what VRTool does with this.'')
 
 
'''Up to''': Determines the number of forecasts downloaded. A setting of 180 will download all the forecasts up to and including the +180 hour forecast. The normal maximum is 180 hours. Reduce this setting if you know you will reach your destination in less time - this speeds up the download (and has another [[#Setting the Number of Forecasts|more important benefit]]).
 
  
=== Transformations ===
+
== Transformations ==
 
[[File:NOAATransformVORG.gif|right]] These settings ensure that the downloaded GRIB is processed in the same way as the game server, so that VRTool's weather is indentical to the game weather.
 
[[File:NOAATransformVORG.gif|right]] These settings ensure that the downloaded GRIB is processed in the same way as the game server, so that VRTool's weather is indentical to the game weather.
  
 
The '''Grid Probe Resolution''' (set to 1&deg;) sets the resolution of the data points in the downloaded GRIB file. These weather data points are displayed on the chart at 1&deg; intervals. For the VORG the speed and direction are then interpolated between these points, so it is important to ensure that [[Wind Interpolation|wind interpolation]] is turned on in VRTool.
 
The '''Grid Probe Resolution''' (set to 1&deg;) sets the resolution of the data points in the downloaded GRIB file. These weather data points are displayed on the chart at 1&deg; intervals. For the VORG the speed and direction are then interpolated between these points, so it is important to ensure that [[Wind Interpolation|wind interpolation]] is turned on in VRTool.
 +
<br style="clear: both" />
 +
==Game wind parameters==
 +
[[File:NOAAGameWindParameter.gif|right]]
 
<br style="clear: both" />
 
<br style="clear: both" />
  
Line 49: Line 60:
 
[[File:ToolbarForecast.gif|right]]
 
[[File:ToolbarForecast.gif|right]]
 
* Change the forecast by clicking on the '''Forecast Selector''' on the [[Tools|toolbar]]. This is because the chart often doesn't refresh correctly after a new download.
 
* Change the forecast by clicking on the '''Forecast Selector''' on the [[Tools|toolbar]]. This is because the chart often doesn't refresh correctly after a new download.
* Verify that the weather is correct by comparing it with the game. To do this, display the current weather (by clicking on '''0''' in the '''Forecast Selector'''). Use the '''Ruler''' tool to read the wind speed and direction at some location - your current boat position is a good place. Then go to the same location in the game client and verify that the wind speed and direction are identical.
+
* Verify that the weather is correct by comparing it with the game. To do this, display the current weather (by clicking on '''0''' in the '''Forecast Selector'''). Use the '''Ruler''' [[File:ToolbarRuler.gif]] tool to read the wind speed and direction at some location - your current boat position is a good place. Then go to the same location in the game client and verify that the wind speed and direction are identical.
  
 
If that checks out you are good to go with the new weather grid.
 
If that checks out you are good to go with the new weather grid.
Line 63: Line 74:
 
== Advanced Topics ==
 
== Advanced Topics ==
 
=== Time Zones ===
 
=== Time Zones ===
Time zones can be confusing. Real mariners keep a clock set to GMT. Similarly life in virtual regattas is much simpler if you set your game computer to the GMT time zone. However this may confuse some other applications, such as email clients.
+
Time zones can be confusing. Real mariners keep a clock set to GMT. Similarly, life in virtual regattas is much simpler if you set your game computer to the GMT time zone. However this may confuse some other applications, such as email clients.
 +
 
 
=== Setting the Number of Forecasts ===
 
=== Setting the Number of Forecasts ===
  
When using VRTool your main weather updates will be at 0400, 1000, 1600 and 2200 UTC, or shortly after. At the top of the hour the new NOAA cycle is only half finished, usually up to about the +96 hr forecast. If you set VRTool to download forecasts beyond this hour the download will fail - you have to wait until all the forecast files you want have been produced......
+
[[File:NOAADownloadParamsVORG.gif|right]] When using VRTool your main weather downloads will be at 04:00, 10:00, 16:00 and 22:00 UTC, or shortly after. At the start of the hour the new NOAA cycle is only partially finished, usually up to about the +72 hr forecast. If you want longer forecasts than this you have to wait until the later files are available, or the download will fail. For example if you want forecasts out to +180 hrs you have to wait for another half an hour, more or less, before you can start the download.
 +
 
 +
In a close race, even a brief delay in making a course change for future weather can be the difference between winning and losing. So always keep in mind how many hours of forecast you will need to get to your routing end-point and set the forecast '''Up to:''' setting accordingly. This lets you run the download at the earliest possible time.
 +
 
 +
Obviously once you get to within 72 hours of the finish line you can do the download sharp at the top of the hour.
 +
 
 +
=== NOAA Winds in Detail ===
 +
 
 +
For a more detailed explanation of how VRTool handles NOAA GFS grib files go to [[NOAAWinds]].

Latest revision as of 18:23, 5 February 2015

The winds used in Virtual Regatta games are generated from weather GRIBs downloaded from NOAA's Global Forecast System. This weather is then processed by the game servers and fed to the game clients on players machines at regular intervals.

VRTool is able to import these same weather GRIBS directly from the NOAA server, independently of the game. This has the obvious competitive benefit that VRTool can get the forecasts in advance of the regular game feeds, allowing players to make early course adjustments for the future weather.

Winds are imported using VRTool's built-in NOAA Import Module. There are various configuration settings in the module to ensure that the correct forecasts are extracted from the NOAA server, and that the subsequent processing is consistent with the game servers.

The NOAA Import Module is started by clicking the Winds ToolbarWinds.gif button on the main toolbar. (The same button is also available on the Wind Grids control panel in the "Winds" tab.)

 Tip: NOAA changed GFS access methods in jan/15. Update VRTool to the newest version to download GFS forecasts.


Setting the GRIB Boundaries

With a broadband connection it is practical to download a very wide area of ocean. This means that even for a trans-oceanic leg you can set the GRIB boundaries once to cover the whole area of the whole leg, and then not touch it again. The module defaults to the last-entered boundaries. This simplifies both the downloads and the weather routing.

Zoom the chart out so that you can see the whole area of the leg.

NOAAGribBoundary.gif
Start the NOAA Import Module and go to the Download from NOAA tab. Click on the top-left boundary handle. Now go to the chart and place the cursor at the top-left corner of an imaginary rectangle which surrounds anywhere you are likely to be during the leg. Click to pick up the co-ordinates of this point. Then do the same for the bottom-right corner. The GRIB boundaries are now set for the whole leg.
Tip: You may experience problems if you try to download a weather grib which crosses the 180° meridian. VRTool will reset one of the boundaries to the 180° meridian. This is an issue with the NOAA download facility, not VRTool. If you need your routing to cross the 180° meridian you will need to download separate gribs each side of the meridian.

Download Parameters

NOAADownloadParamsVORG.gif
Time Zone: Set this to your computer's time zone setting. You can click on the icon to retrieve this automatically. The module uses this setting along with your computer's time to determine the UTC time, which is used to probe the NOAA database for the files with the correct time stamp.
Tip for users in New Zealand: If your system time zone is set to (UTC+12:00) Auckland, Wellington the IconLisa.gif icon returns a time zone of -12 during NZST, or -13 during NZDT. You should use these rather odd settings - they work correctly in VRTool.

Resolution: This setting determines the forecast interval in hours that the module downloads. The NOAA model produces forecasts at 6-hour intervals, so 6 is the lowest setting you can use for the resolution. If you set it to 12 the module will download every second forecast.

Up to: Determines the number of forecasts downloaded. The maximum setting of 384 hours will download all of the available weather. On a broadband connection you can happily leave this set on the maximum. Use a reduced value if you know you will reach your destination in less time and you are using a slow connection - this speeds up the download.

Tip: Although the NOAA GFS generates gribs out to 384 hours (16 days) in the future, VRTool can only access the gribs beyond 192 hours at certain times, which are:
  • 10:45 - 16:00 UTC
  • 22:45 - 04:00 UTC

At all other times the download will stop at around 192 hours. The reasons for this are explained here.

Transformations

NOAATransformVORG.gif
These settings ensure that the downloaded GRIB is processed in the same way as the game server, so that VRTool's weather is indentical to the game weather.

The Grid Probe Resolution (set to 1°) sets the resolution of the data points in the downloaded GRIB file. These weather data points are displayed on the chart at 1° intervals. For the VORG the speed and direction are then interpolated between these points, so it is important to ensure that wind interpolation is turned on in VRTool.

Game wind parameters

NOAAGameWindParameter.gif


Running the Download

NOAADownloadNow.gif
To run a manual download click on Download Now!. The progress of the download and conversion to .XML format can be observed in the module window.

After the download finishes and the new weather grid displays on the chart there are two things you should always do:

ToolbarForecast.gif
  • Change the forecast by clicking on the Forecast Selector on the toolbar. This is because the chart often doesn't refresh correctly after a new download.
  • Verify that the weather is correct by comparing it with the game. To do this, display the current weather (by clicking on 0 in the Forecast Selector). Use the Ruler ToolbarRuler.gif tool to read the wind speed and direction at some location - your current boat position is a good place. Then go to the same location in the game client and verify that the wind speed and direction are identical.

If that checks out you are good to go with the new weather grid.

Tip: If the download is interrupted before it finishes it usually means that the current NOAA GFS run is still in progress and the forecast file is not yet available. This is discussed in more detail in Advanced Topics. If this happens wait for a while and then try again. If the download is interupted like this the whole download is cancelled and the existing weather grid is preserved.
Tip: VRTool can also be set up to do automatic downloads. However manual downloads give you direct control of the process and give you opportunity to observe the download and verify that it has completed correctly.

Advanced Topics

Time Zones

Time zones can be confusing. Real mariners keep a clock set to GMT. Similarly, life in virtual regattas is much simpler if you set your game computer to the GMT time zone. However this may confuse some other applications, such as email clients.

Setting the Number of Forecasts

NOAADownloadParamsVORG.gif
When using VRTool your main weather downloads will be at 04:00, 10:00, 16:00 and 22:00 UTC, or shortly after. At the start of the hour the new NOAA cycle is only partially finished, usually up to about the +72 hr forecast. If you want longer forecasts than this you have to wait until the later files are available, or the download will fail. For example if you want forecasts out to +180 hrs you have to wait for another half an hour, more or less, before you can start the download.

In a close race, even a brief delay in making a course change for future weather can be the difference between winning and losing. So always keep in mind how many hours of forecast you will need to get to your routing end-point and set the forecast Up to: setting accordingly. This lets you run the download at the earliest possible time.

Obviously once you get to within 72 hours of the finish line you can do the download sharp at the top of the hour.

NOAA Winds in Detail

For a more detailed explanation of how VRTool handles NOAA GFS grib files go to NOAAWinds.