get_satellite_imagery: Get BOM Satellite GeoTIFF Imagery

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

View source: R/get_satellite_imagery.R

Description

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

Usage

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

Arguments

product_id

Character. BOM product ID to download in GeoTIFF format and import as a stack 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.

Details

Valid BOM satellite Product IDs 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.

Value

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

Author(s)

Adam H Sparks, [email protected]

References

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

See Also

get_available_imagery manage_cache

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
## Not run: 
# Fetch AHI VIS (true colour) / IR (Ch13 greyscale) composite 1km FD
# GEOS GIS raster stack 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)


## End(Not run)

bomrang documentation built on Aug. 15, 2018, 9:05 a.m.