Fetch the BOM daily Coastal Waters Forecast and return a data frame of the forecast regions for a specified state or region.

get_coastal_forecast(state = "AUS")

Arguments

state

Australian state or territory as full name or postal code. Fuzzy string matching via agrep is done. Defaults to “AUS” returning all state forecasts, see details for further information.

Value

A data.table of an Australia BOM Coastal Waters Forecast. For full details of fields and units returned see Appendix 5 in the bomrang vignette, use
vignette("bomrang", package = "bomrang") to view.

Details

Allowed state and territory postal codes, only one state per request or all using AUS.

ACT

Australian Capital Territory (will return NSW)

NSW

New South Wales

NT

Northern Territory

QLD

Queensland

SA

South Australia

TAS

Tasmania

VIC

Victoria

WA

Western Australia

AUS

Australia, returns forecast for all states, NT and ACT

References

Forecast data come from Australian Bureau of Meteorology (BOM) Weather Data Services
http://www.bom.gov.au/catalogue/data-feeds.shtml

Location data and other metadata come from the BOM anonymous FTP server with spatial data
ftp://ftp.bom.gov.au/anon/home/adfd/spatial/, specifically the DBF file portion of a shapefile,
ftp://ftp.bom.gov.au/anon/home/adfd/spatial/IDM00003.dbf

See also

Author

Dean Marchiori, [email protected] and Paul Melloy [email protected]

Examples

# \donttest{ coastal_forecast <- get_coastal_forecast(state = "NSW") coastal_forecast
#> index product_id type state_code #> 1: <NA> IDN11001 <NA> NSW #> 2: 0 IDN11001 <NA> NSW #> 3: 1 IDN11001 <NA> NSW #> 4: 2 IDN11001 <NA> NSW #> 5: 0 IDN11001 <NA> NSW #> 6: 1 IDN11001 <NA> NSW #> 7: 2 IDN11001 <NA> NSW #> 8: 0 IDN11001 <NA> NSW #> 9: 1 IDN11001 <NA> NSW #> 10: 2 IDN11001 <NA> NSW #> 11: 0 IDN11001 <NA> NSW #> 12: 1 IDN11001 <NA> NSW #> 13: 2 IDN11001 <NA> NSW #> 14: 0 IDN11001 <NA> NSW #> 15: 1 IDN11001 <NA> NSW #> 16: 2 IDN11001 <NA> NSW #> 17: 0 IDN11001 <NA> NSW #> 18: 1 IDN11001 <NA> NSW #> 19: 2 IDN11001 <NA> NSW #> 20: 0 IDN11001 <NA> NSW #> 21: 1 IDN11001 <NA> NSW #> 22: 2 IDN11001 <NA> NSW #> 23: 0 IDN11001 <NA> NSW #> 24: 1 IDN11001 <NA> NSW #> 25: 2 IDN11001 <NA> NSW #> index product_id type state_code #> dist_name pt_1_name pt_2_name aac #> 1: New South Wales <NA> <NA> NSW_FA001 #> 2: Eden Coast: Montague Island to Gabo Island <NA> <NA> NSW_MW001 #> 3: Eden Coast: Montague Island to Gabo Island <NA> <NA> NSW_MW001 #> 4: Eden Coast: Montague Island to Gabo Island <NA> <NA> NSW_MW001 #> 5: Batemans Coast: Ulladulla to Montague Island <NA> <NA> NSW_MW002 #> 6: Batemans Coast: Ulladulla to Montague Island <NA> <NA> NSW_MW002 #> 7: Batemans Coast: Ulladulla to Montague Island <NA> <NA> NSW_MW002 #> 8: Illawarra Coast: Port Hacking to Ulladulla <NA> <NA> NSW_MW003 #> 9: Illawarra Coast: Port Hacking to Ulladulla <NA> <NA> NSW_MW003 #> 10: Illawarra Coast: Port Hacking to Ulladulla <NA> <NA> NSW_MW003 #> 11: Sydney Coast: Broken Bay to Port Hacking <NA> <NA> NSW_MW004 #> 12: Sydney Coast: Broken Bay to Port Hacking <NA> <NA> NSW_MW004 #> 13: Sydney Coast: Broken Bay to Port Hacking <NA> <NA> NSW_MW004 #> 14: Hunter Coast: Seal Rocks to Broken Bay <NA> <NA> NSW_MW005 #> 15: Hunter Coast: Seal Rocks to Broken Bay <NA> <NA> NSW_MW005 #> 16: Hunter Coast: Seal Rocks to Broken Bay <NA> <NA> NSW_MW005 #> 17: Macquarie Coast: Smoky Cape to Seal Rocks <NA> <NA> NSW_MW006 #> 18: Macquarie Coast: Smoky Cape to Seal Rocks <NA> <NA> NSW_MW006 #> 19: Macquarie Coast: Smoky Cape to Seal Rocks <NA> <NA> NSW_MW006 #> 20: Coffs Coast: Wooli to Smoky Cape <NA> <NA> NSW_MW007 #> 21: Coffs Coast: Wooli to Smoky Cape <NA> <NA> NSW_MW007 #> 22: Coffs Coast: Wooli to Smoky Cape <NA> <NA> NSW_MW007 #> 23: Byron Coast: Point Danger to Wooli <NA> <NA> NSW_MW008 #> 24: Byron Coast: Point Danger to Wooli <NA> <NA> NSW_MW008 #> 25: Byron Coast: Point Danger to Wooli <NA> <NA> NSW_MW008 #> dist_name pt_1_name pt_2_name aac #> start_time_local end_time_local utc_offset start_time_utc #> 1: 2021-10-01 10:17:05 2021-10-01 10:17:05 10:00 2021-10-01 10:17:05 #> 2: 2021-10-01 10:00:00 2021-10-01 10:00:00 10:00 2021-10-01 10:00:00 #> 3: 2021-10-02 00:00:00 2021-10-02 00:00:00 10:00 2021-10-02 00:00:00 #> 4: 2021-10-03 00:00:00 2021-10-03 00:00:00 10:00 2021-10-03 00:00:00 #> 5: 2021-10-01 10:00:00 2021-10-01 10:00:00 10:00 2021-10-01 10:00:00 #> 6: 2021-10-02 00:00:00 2021-10-02 00:00:00 10:00 2021-10-02 00:00:00 #> 7: 2021-10-03 00:00:00 2021-10-03 00:00:00 10:00 2021-10-03 00:00:00 #> 8: 2021-10-01 10:00:00 2021-10-01 10:00:00 10:00 2021-10-01 10:00:00 #> 9: 2021-10-02 00:00:00 2021-10-02 00:00:00 10:00 2021-10-02 00:00:00 #> 10: 2021-10-03 00:00:00 2021-10-03 00:00:00 10:00 2021-10-03 00:00:00 #> 11: 2021-10-01 10:00:00 2021-10-01 10:00:00 10:00 2021-10-01 10:00:00 #> 12: 2021-10-02 00:00:00 2021-10-02 00:00:00 10:00 2021-10-02 00:00:00 #> 13: 2021-10-03 00:00:00 2021-10-03 00:00:00 10:00 2021-10-03 00:00:00 #> 14: 2021-10-01 10:00:00 2021-10-01 10:00:00 10:00 2021-10-01 10:00:00 #> 15: 2021-10-02 00:00:00 2021-10-02 00:00:00 10:00 2021-10-02 00:00:00 #> 16: 2021-10-03 00:00:00 2021-10-03 00:00:00 10:00 2021-10-03 00:00:00 #> 17: 2021-10-01 10:00:00 2021-10-01 10:00:00 10:00 2021-10-01 10:00:00 #> 18: 2021-10-02 00:00:00 2021-10-02 00:00:00 10:00 2021-10-02 00:00:00 #> 19: 2021-10-03 00:00:00 2021-10-03 00:00:00 10:00 2021-10-03 00:00:00 #> 20: 2021-10-01 10:00:00 2021-10-01 10:00:00 10:00 2021-10-01 10:00:00 #> 21: 2021-10-02 00:00:00 2021-10-02 00:00:00 10:00 2021-10-02 00:00:00 #> 22: 2021-10-03 00:00:00 2021-10-03 00:00:00 10:00 2021-10-03 00:00:00 #> 23: 2021-10-01 10:00:00 2021-10-01 10:00:00 10:00 2021-10-01 10:00:00 #> 24: 2021-10-02 00:00:00 2021-10-02 00:00:00 10:00 2021-10-02 00:00:00 #> 25: 2021-10-03 00:00:00 2021-10-03 00:00:00 10:00 2021-10-03 00:00:00 #> start_time_local end_time_local utc_offset start_time_utc #> end_time_utc #> 1: 2021-10-01 10:17:05 #> 2: 2021-10-01 10:00:00 #> 3: 2021-10-02 00:00:00 #> 4: 2021-10-03 00:00:00 #> 5: 2021-10-01 10:00:00 #> 6: 2021-10-02 00:00:00 #> 7: 2021-10-03 00:00:00 #> 8: 2021-10-01 10:00:00 #> 9: 2021-10-02 00:00:00 #> 10: 2021-10-03 00:00:00 #> 11: 2021-10-01 10:00:00 #> 12: 2021-10-02 00:00:00 #> 13: 2021-10-03 00:00:00 #> 14: 2021-10-01 10:00:00 #> 15: 2021-10-02 00:00:00 #> 16: 2021-10-03 00:00:00 #> 17: 2021-10-01 10:00:00 #> 18: 2021-10-02 00:00:00 #> 19: 2021-10-03 00:00:00 #> 20: 2021-10-01 10:00:00 #> 21: 2021-10-02 00:00:00 #> 22: 2021-10-03 00:00:00 #> 23: 2021-10-01 10:00:00 #> 24: 2021-10-02 00:00:00 #> 25: 2021-10-03 00:00:00 #> end_time_utc #> forecast_seas #> 1: <NA> #> 2: Below 1 metre. #> 3: Below 1 metre. #> 4: Below 1 metre. #> 5: Below 1 metre. #> 6: Below 1 metre. #> 7: Below 1 metre. #> 8: Below 1 metre. #> 9: Below 1 metre. #> 10: Below 1 metre. #> 11: Below 1 metre. #> 12: Below 1 metre. #> 13: Below 1 metre. #> 14: Below 1 metre. #> 15: Below 1 metre. #> 16: Below 1 metre. #> 17: 1 to 2 metres, decreasing to 1 to 1.5 metres by early evening. #> 18: Below 1 metre. #> 19: Around 1 metre. #> 20: 1.5 to 2.5 metres. #> 21: Around 1 metre. #> 22: Around 1 metre. #> 23: 1.5 to 2.5 metres. #> 24: 1 to 1.5 metres, decreasing below 1 metre during the morning. #> 25: Around 1 metre, increasing to 1 to 1.5 metres inshore during the afternoon or evening. #> forecast_seas #> forecast_weather #> 1: <NA> #> 2: Partly cloudy. 60% chance of showers. The chance of a thunderstorm in the late morning and afternoon. #> 3: Cloudy. 60% chance of showers. The chance of a thunderstorm. #> 4: Partly cloudy. 50% chance of showers. #> 5: Partly cloudy. 60% chance of showers. The chance of a thunderstorm in the late morning and afternoon. #> 6: Partly cloudy. 60% chance of showers. The chance of a thunderstorm. #> 7: Partly cloudy. #> 8: Partly cloudy. 50% chance of showers. The chance of a thunderstorm in the late morning and afternoon. #> 9: Partly cloudy. 50% chance of showers. The chance of a thunderstorm. #> 10: Partly cloudy. #> 11: Partly cloudy. The chance of a thunderstorm in the late morning and afternoon, possibly severe. #> 12: Mostly sunny. The chance of a thunderstorm from the late morning. #> 13: Mostly sunny. #> 14: Partly cloudy. The chance of a thunderstorm in the late morning and afternoon, possibly severe. #> 15: Mostly sunny. The chance of a thunderstorm. #> 16: Mostly sunny. #> 17: Partly cloudy. The chance of a thunderstorm from the late morning, possibly severe. #> 18: Mostly sunny. The chance of a thunderstorm. #> 19: Sunny. #> 20: Partly cloudy. 50% chance of showers from the late morning. The chance of a thunderstorm, possibly severe. #> 21: Partly cloudy. The chance of a thunderstorm. #> 22: Sunny. #> 23: Partly cloudy. 90% chance of showers. The chance of a thunderstorm. #> 24: Mostly sunny. The chance of a thunderstorm in the morning and afternoon. #> 25: Sunny. #> forecast_weather #> forecast_winds #> 1: <NA> #> 2: Northeasterly 10 to 15 knots becoming variable about 10 knots in the evening. #> 3: South to southwesterly about 10 knots increasing to 10 to 15 knots early in the morning. #> 4: West to southwesterly 10 to 15 knots shifting east to northeasterly during the morning then becoming variable about 10 knots during the evening. #> 5: North to northeasterly 10 to 15 knots tending east to northeasterly in the middle of the day then becoming variable about 10 knots in the late afternoon. #> 6: Variable below 10 knots becoming south to southwesterly 10 to 15 knots in the morning then decreasing to about 10 knots in the early afternoon. #> 7: Variable about 10 knots becoming north to northeasterly 10 to 15 knots during the afternoon then tending north to northwesterly during the evening. #> 8: North to northeasterly about 10 knots increasing to 10 to 15 knots in the middle of the day then becoming north to northwesterly about 10 knots in the late afternoon. #> 9: West to northwesterly about 10 knots tending southwesterly 10 to 15 knots in the morning. #> 10: Northwest to southwesterly 10 to 15 knots tending northerly during the afternoon. #> 11: North to northeasterly 10 to 15 knots turning northwesterly in the evening. #> 12: Variable about 10 knots. #> 13: West to southwesterly 10 to 15 knots shifting north to northeasterly during the day. #> 14: Northerly 10 to 15 knots, reaching up to 20 knots offshore north of Port Stephens in the evening. Winds turning northwesterly below 10 knots in the late evening. #> 15: West to northwesterly 10 to 15 knots tending west to southwesterly in the middle of the day then tending west to northwesterly in the late afternoon. #> 16: Westerly 10 to 15 knots shifting northeasterly during the afternoon then tending northerly during the evening. #> 17: Northerly 15 to 20 knots, reaching up to 25 knots offshore north of Port Macquarie in the late morning and early afternoon. #> 18: Variable about 10 knots becoming southeast to southwesterly 10 to 15 knots in the middle of the day then becoming north to northwesterly about 10 knots in the evening. #> 19: Westerly 10 to 15 knots tending east to northeasterly during the afternoon then tending northerly during the evening. #> 20: Northerly 15 to 25 knots, reaching up to 30 knots offshore north of Coffs Harbour in the late morning. #> 21: North to northwesterly 10 to 15 knots, reaching up to 20 knots offshore early in the morning. Winds tending west to northwesterly before dawn then becoming variable about 10 knots in the early afternoon. #> 22: Westerly 10 to 15 knots shifting northeasterly during the day then tending northerly during the evening. #> 23: Northerly 15 to 25 knots, reaching up to 30 knots offshore in the late morning and early afternoon. #> 24: West to northwesterly 15 to 20 knots tending north to northeasterly 10 to 15 knots in the early afternoon then tending west to northwesterly in the late evening. #> 25: Westerly 10 to 15 knots tending northwest to northeasterly 15 to 20 knots during the day. #> forecast_winds #> forecast_swell1 #> 1: <NA> #> 2: Northeasterly 1.5 to 2 metres. #> 3: Northeasterly 2 to 2.5 metres. #> 4: Northeasterly 2 metres, decreasing to 1.5 metres during the morning. #> 5: Northeasterly 2 metres. #> 6: Northeasterly 2 to 2.5 metres. #> 7: Northeasterly 1.5 metres inshore, increasing to 1.5 to 2 metres offshore south of Moruya Heads. #> 8: Northeasterly 2 metres. #> 9: Northeasterly 1.5 to 2.5 metres. #> 10: East to northeasterly 1.5 metres inshore, increasing to 1.5 to 2 metres offshore south of Point Perpendicular. #> 11: Northeasterly 2 metres. #> 12: Northeasterly 1.5 to 2.5 metres, tending easterly 1.5 metres later in the evening. #> 13: Easterly 1.5 metres. #> 14: Northeasterly 1.5 to 2.5 metres. #> 15: Northeasterly 1.5 to 2.5 metres. #> 16: East to northeasterly 1.5 metres inshore, increasing to 1.5 to 2 metres offshore north of Port Stephens. #> 17: Northeasterly 1.5 to 2 metres. #> 18: Northeasterly 2 metres, tending easterly 2 metres later in the evening. #> 19: East to northeasterly 1.5 metres inshore, increasing to 1.5 to 2 metres offshore. #> 20: Northeasterly 1 to 1.5 metres inshore, increasing to 1.5 to 2 metres offshore south of Coffs Harbour. #> 21: Northeasterly 1.5 to 2 metres, tending easterly 2 metres by early evening. #> 22: East to northeasterly 1.5 metres inshore, increasing to 1.5 to 2 metres offshore. #> 23: Northeasterly 1 to 1.5 metres inshore, increasing to 1.5 to 2 metres offshore north of Yamba. #> 24: Northeasterly 1.5 to 2 metres. #> 25: East to northeasterly 1.5 metres inshore, increasing to 1.5 to 2 metres offshore. #> forecast_swell1 #> forecast_swell2 forecast_caution #> 1: <NA> <NA> #> 2: <NA> <NA> #> 3: <NA> <NA> #> 4: <NA> <NA> #> 5: <NA> <NA> #> 6: <NA> <NA> #> 7: <NA> <NA> #> 8: <NA> <NA> #> 9: <NA> <NA> #> 10: <NA> <NA> #> 11: <NA> <NA> #> 12: <NA> <NA> #> 13: <NA> <NA> #> 14: <NA> <NA> #> 15: <NA> <NA> #> 16: <NA> <NA> #> 17: <NA> <NA> #> 18: <NA> <NA> #> 19: <NA> <NA> #> 20: <NA> <NA> #> 21: <NA> <NA> #> 22: <NA> <NA> #> 23: <NA> <NA> #> 24: <NA> <NA> #> 25: <NA> <NA> #> forecast_swell2 forecast_caution #> marine_forecast tropical_system_location #> 1: <NA> NA #> 2: <NA> NA #> 3: <NA> NA #> 4: <NA> NA #> 5: <NA> NA #> 6: <NA> NA #> 7: <NA> NA #> 8: <NA> NA #> 9: <NA> NA #> 10: <NA> NA #> 11: <NA> NA #> 12: <NA> NA #> 13: <NA> NA #> 14: <NA> NA #> 15: <NA> NA #> 16: <NA> NA #> 17: <NA> NA #> 18: <NA> NA #> 19: <NA> NA #> 20: Strong Wind Warning for Friday for Coffs Coast NA #> 21: <NA> NA #> 22: <NA> NA #> 23: Strong Wind Warning for Friday for Byron Coast NA #> 24: <NA> NA #> 25: <NA> NA #> marine_forecast tropical_system_location #> forecast_waves #> 1: NA #> 2: NA #> 3: NA #> 4: NA #> 5: NA #> 6: NA #> 7: NA #> 8: NA #> 9: NA #> 10: NA #> 11: NA #> 12: NA #> 13: NA #> 14: NA #> 15: NA #> 16: NA #> 17: NA #> 18: NA #> 19: NA #> 20: NA #> 21: NA #> 22: NA #> 23: NA #> 24: NA #> 25: NA #> forecast_waves
# }