bomrang v0.6.0

0

Monthly downloads

0th

Percentile

Australian Government Bureau of Meteorology ('BOM') Data Client

Provides functions to interface with Australian Government Bureau of Meteorology ('BOM') data, fetching data and returning a tidy data frame of precis forecasts, historical and current weather data from stations, agriculture bulletin data, 'BOM' 0900 or 1500 weather bulletins and downloading and importing radar and satellite imagery files. Data (c) Australian Government Bureau of Meteorology Creative Commons (CC) Attribution 3.0 licence or Public Access Licence (PAL) as appropriate. See <http://www.bom.gov.au/other/copyright.shtml> for further details.

Readme

bomrang: Australian Government Bureau of Meteorology (BOM) Data Client

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.

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

Functions in bomrang

Name Description
get_coastal_forecast Get BOM Coastal Waters Forecast
get_available_radar Get a Listing of Available BOM Radar Imagery
get_historical Obtain Historical BOM Data
bomrang Australian Government Bureau of Meteorology (BOM) Data Client
get_precis_forecast Get BOM Daily Pr<U+00E9>cis Forecast for Select Towns
get_radar_imagery Get BOM Radar Imagery
get_ag_bulletin Get BOM Agriculture Bulletin Information for Select Stations
update_forecast_towns Update Internal Database with Latest BOM Forecast Towns
get_available_imagery Get a Listing of Available BOM Satellite GeoTIFF Imagery
get_current_weather Get Current Weather Observations of a BOM Station
%>% Pipe operator
update_station_locations Update Internal Databases with Latest BOM Station Metadata
reexports Objects exported from other packages
manage_cache Manage Locally Cached BOM Files
get_weather_bulletin Get BOM 0900 or 1500 Weather Bulletin
sweep_for_stations Find Nearest BOM Weather Stations
sweep_for_forecast_towns Find Nearest BOM Forecast Towns
get_satellite_imagery Get BOM Satellite GeoTIFF Imagery
No Results!

Vignettes of bomrang

Name
bomrang.Rmd
get_satellite_imagery-1.png
use_case.Rmd
No Results!

Last month downloads

Details

Type Package
URL https://github.com/ropensci/bomrang, https://docs.ropensci.org/bomrang/
BugReports https://github.com/ropensci/bomrang/issues
License MIT + file LICENSE
Encoding UTF-8
LazyData true
RoxygenNote 6.1.1
NeedsCompilation no
ByteCompile TRUE
VignetteBuilder knitr
X-schema.org-applicationCategory Tools
X-schema.org-keywords bom, meteorological-data, weather-forecast, australia, weather, weather-data, meteorology, australia-bureau-of-meteorology
X-schema.org-isPartOf https://ropensci.org
Packaged 2019-07-04 21:03:31 UTC; adamsparks
Repository CRAN
Date/Publication 2019-07-04 21:30:04 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/bomrang)](http://www.rdocumentation.org/packages/bomrang)