updateInventory {gimms}

Update GIMMS NDVI3g File Inventory

Description

Download the latest version of the GIMMS NDVI3g file inventory from the National Center for Atmospheric Research, NASA Earth Exchange (NEX) Amazon AWS or Ames Ecological Forecasting Lab (ECOCAST). If the specified endpoint is not reachable (e.g., if there is no active internet connection), the latest local version of the file inventory is used.

Usage

updateInventory(
  server = c("poles", "nasanex", "ecocast"),
  version = 1L,
  quiet = FALSE
)

Arguments

server

character. Specifies the remote server to use. Currently available options are "poles" (default), "nasanex" and "ecocast".

version

integer (or any other convertible class), defaults to 1L. Specifies desired GIMMS NDVI3g product version, see 'Details'. Currently ignored if server != "ecocast".

quiet

logical, defaults to FALSE. If TRUE, console output is disabled.

Details

GIMMS NDVI3g.v1 is currently available from ECOCAST and The National Center for Atmospheric Research until end 2015 and comes in NetCDF (.nc4) format. In contrast, NDVI3g.v0 is available as ENVI binary imagery and available from ECOCAST (NASANEX) until end 2013 (2012) only.

Value

A character vector of online filepaths.

References

The National Center for Atmospheric Research (2018). A Big Earth Data Platform for Three Poles. Global GIMMS NDVI3g v1 dataset (1981-2015). Available online at http://poles.tpdc.ac.cn/en/data/9775f2b4-7370-4e5e-a537-3482c9a83d88/ (accessed on 2021-04-15).

See Also

rearrangeFiles.

Examples

## Not run: 
updateInventory()
updateInventory(server = "nasanex", version = 0)

## End(Not run)

## note that local versions of the online file inventories are also available
ofl_ecv1 <- system.file("extdata", "inventory_ecv1.rds", package = "gimms")
readRDS(ofl_ecv1)

ofl_v0 <- system.file("extdata", "inventory_ecv0.rds", package = "gimms")
readRDS(ofl_v0)

ofl_plv1 <- system.file("extdata", "inventory_plv1.rds", package = "gimms")
readRDS(ofl_plv1)