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

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 or a raster::stack() object of satellite imagery from GeoTIFF files.

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 from 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 imagery,

• get_available_imagery() and the imagery itself,
• get_satellite_imagery(). Vignettes are provided illustrating examples of

all functions and a use case.

Meta

• Please report any issues or bugs.

• License:

  • All code is licenced MIT

  • All data is copyright Australia Bureau of Meteorology, BOM Copyright Notice http://reg.bom.gov.au/other/copyright.shtml

• To cite bomrang, please use the output from citation("bomrang")

• Please note that this project is released with a

Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

References

Australian Bureau of Meteorology (BOM) Weather Data Services

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

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