get_satellite_imagery: Get BOM Satellite GeoTIFF Imagery
In bomrang: Australian Government Bureau of Meteorology ('BOM') Data Client

Description Usage Arguments Details Value Author(s) References See Also Examples

Fetch BOM satellite GeoTIFF imagery from ftp://ftp.bom.gov.au/anon/gen/gms/ and return a raster SpatRaster object of 'GeoTIFF' files. Files are available at ten minutes update frequency with a 24 hour delete time. It is suggested to check file availability first by using get_available_imagery.

1	get_satellite_imagery(product_id, scans = 1, cache = FALSE)

`product_id`	Character. BOM product ID to download in 'GeoTIFF' format and import as a `SpatRaster` object. A vector of values from `get_available_imagery` may be used here. Value is required.
`scans`	Numeric. Number of scans to download, starting with most recent and progressing backwards, e.g., 1 - the most recent single scan available , 6 - the most recent hour available, 12 - the most recent 2 hours available, etc. Negating will return the oldest files first. Defaults to 1. Value is optional.
`cache`	Logical. Store image files locally for later use? If `FALSE`, the downloaded files are removed when R session is closed. To take advantage of cached files in future sessions, use `cache = TRUE`. Defaults to `FALSE`. Value is optional.

Valid BOM satellite Product IDs for use with product_id include:

IDE00420: AHI cloud cover only 2km FD GEOS GIS
IDE00421: AHI IR (Ch13) greyscale 2km FD GEOS GIS
IDE00422: AHI VIS (Ch3) greyscale 2km FD GEOS GIS
IDE00423: AHI IR (Ch13) Zehr 2km FD GEOS GIS
IDE00425: AHI VIS (true colour) / IR (Ch13 greyscale) composite 1km FD GEOS GIS
IDE00426: AHI VIS (true colour) / IR (Ch13 greyscale) composite 2km FD GEOS GIS
IDE00427: AHI WV (Ch8) 2km FD GEOS GIS
IDE00430: AHI cloud cover only 2km AUS equirect. GIS
IDE00431: AHI IR (Ch13) greyscale 2km AUS equirect. GIS
IDE00432: AHI VIS (Ch3) greyscale 2km AUS equirect. GIS
IDE00433: AHI IR (Ch13) Zehr 2km AUS equirect. GIS
IDE00435: AHI VIS (true colour) / IR (Ch13 greyscale) composite 1km AUS equirect. GIS
IDE00436: AHI VIS (true colour) / IR (Ch13 greyscale) composite 2km AUS equirect. GIS
IDE00437: AHI WV (Ch8) 2km AUS equirect. GIS
IDE00439: AHI VIS (Ch3) greyscale 0.5km AUS equirect. GIS

We cache using hoardr, find your cache folder by executing manage_cache$cache_path_get.

A SpatRaster object of GeoTIFF images with layers named by BOM Product ID, timestamp and band.

Adam H. Sparks, adamhsparks@gmail.com

Australian Bureau of Meteorology (BOM) high-definition satellite images
http://www.bom.gov.au/australia/satellite/index.shtml

get_available_imagery manage_cache

# Fetch AHI VIS (true colour) / IR (Ch13 greyscale) composite 1km FD
# GEOS GIS \code{SpatRaster} object for most recent single scan available

imagery <- get_satellite_imagery(product_id = "IDE00425", scans = 1)

# Get a list of available image files and use that to specify files for
# download, downloading the two most recent files available

avail <- get_available_imagery(product_id = "IDE00425")
imagery <- get_satellite_imagery(product_id = avail, scans = 2)