Get BOM radar imagery

Fetch BOM radar imagery from ftp://ftp.bom.gov.au/anon/gen/radar/ and return a SpatRaster layer object. Files available are the most recent radar snapshot which are updated approximately every 6 to 10 minutes. Suggested to check file availability first by using get_available_radar.

Usage

get_radar_imagery(product_id, path = NULL, download_only = FALSE)

Arguments

product_id

Character. BOM product ID to download and import as a magick object. Value is required.

path

Character. A character string with the name where the downloaded file is saved. If not provided, the default value NULL is used which saves the file in an R session temp directory.

download_only

Logical. Whether the radar image is loaded into the environment as a magick object or just downloaded.

Value

A magick object of the most recent radar image snapshot published by the BOM. If download_only = TRUE there will be a NULL return value with the download path printed in the console as a message.

Details

Valid BOM Radar Product IDs for radar imagery can be obtained from get_available_radar.

References

Australian Bureau of Meteorology (BOM) radar images
http://www.bom.gov.au/australia/radar/

See also

get_available_radar

Author

Dean Marchiori, [email protected]

Examples

# \donttest{
# Fetch most recent radar image for Wollongong 256km radar
imagery <- get_radar_imagery(product_id = "IDR032")
#> file downloaded to:/tmp/RtmpgdulRp/file5661ffd8599.gif
imagery
#> # A tibble: 1 × 7
#>   format width height colorspace matte filesize density
#>   <chr>  <int>  <int> <chr>      <lgl>    <int> <chr>  
#> 1 GIF      524    564 sRGB       TRUE     34335 72x72  
# }