README.md

bomrang: Australian Government Bureau of Meteorology (BOM) Data from R

CircleCI Appveyor codecov DOI CRAN_Status_Badge status Project Status: Active – The project has reached a stable, usable state and is being actively developed.

Provides functions to interface with Australian Government Bureau of Meteorology (BOM) data, fetching data and returning a tidy data frame of précis forecasts, current weather data from stations, ag information bulletins, historical weather data and downloading and importing radar or satellite imagery.

Credit for the name, bomrang, goes to Di Cook, who suggested it while attending the rOpenSci AUUnconf in Brisbane, 2016, upon seeing the vignette that we had assembled during the Unconf.

Quick Start

Install the stable release from CRAN.

install.packages("bomrang")

Or from GitHub for the version in development.

if (!require("remotes")) {
  install.packages("remotes", repos = "http://cran.rstudio.com/")
  library("remotes")
}

install_github("ropensci/bomrang", build_vignettes = TRUE)

Using bomrang

Several functions are provided by bomrang to retrieve Australian Bureau of Meteorology (BOM) data. A family of functions retrieve weather data and return tidy data frames; - get_precis_forecast(), which retrieves the précis (short) forecast; - get_current_weather(), which fetches the current weather for a given station; - get_ag_bulletin(), which retrieves the agriculture bulletin; - get_weather_bulletin(), which retrieves the BOM 0900 or 1500 bulletins; - get_coastal_forecast(), which returns coastal waters forecasts; and - get_historical(), which retrieves historical daily observations for a given station.

A second group of functions retrieve information pertaining to satellite and radar imagery, - get_available_imagery(); - the satellite imagery itself, get_satellite_imagery(); - get_available_radar(); and - the radar imagery itself, get_radar_imagery().

Vignettes are provided illustrating examples of all functions and a use case.

Meta

References

Australian Bureau of Meteorology (BOM) Weather Data Services

Australian Bureau of Meteorology (BOM) FTP Public Products

Australian Bureau of Meteorology (BOM) Weather Data Services Agriculture Bulletins

Australian Bureau of Meteorology (BOM) Weather Data Services Observation of Rainfall

Australian Bureau of Meteorology (BOM) High-definition satellite images



Try the bomrang package in your browser

Any scripts or data that you put into this service are public.

bomrang documentation built on Sept. 12, 2018, 9:03 a.m.