copernicus: Access and extract COPERNICUS imagery

Description Download Extracting Product comparison Package options Note


The copernicus package allows to download data from the COPERNICUS data portal through the fast HTTP access (the so called 'data pool': The user should be registered to access data.


download_copernicus wil download zip files on the data portal based on an extent or given tiles (h,v) pairs and a product name. Only the following products are available: 'NDVI_1km_V1' (Normalized Difference Vegetation Index - VGT instrument), 'NDVI_1km_V2' (Normalized Difference Vegetation Index - PROBAV instrument),'LAI' (Leaf Area Index),'FCOVER' (Fraction of Vegetation Green Cover), 'FAPAR' (Fraction of Absorbed Photosynthetically Active Radiation),'VCI' (Vegetation Condition Index),'VPI' (Vegetation Productivity Index), 'DMP' (Dry Matter Productivity),'BA' (Burnt Areas).

The availability of the data between two dates can be checked with check_time_copernicus and at a given location with check_tile_copernicus. One can get the URL's of images for a given time period, location and product name with get_url_copernicus. Information included in the name of the files (e.g. aglorithm version, instrument) can be retrieved with scan_file_copernicus. The COPERNICUS tiling system can be created with gen_tile_copernicus and fetched with get_tile_copernicus which will retrieve tiles info (h,v,bounding box in LatLon) based on an extent or (h,v) pair.


File conversion can be done with extract_copernicus, which will transfrom raw h5 files to tif, by converting DN to physical values using the associated gain and offset of each product. The function can further subset data on a given extent, resample to a given resolution and project to a given coordinate system. One can also choose which layers of the h5 files can be extracted. This function requires to install GDAL. Quality Flags can be extracted with convert_qf_copernicus.

Product comparison

In addition to data access and extraction, copernicus allows to compare the spatial and temporal agreement between two RasterBrick or RasterStack objects, see compare_raster_time and compare_raster_space

Package options

Some of the package default options are set with copernicus_options, such as the download path, user name and password.


Pieces of code are taken/inspired from the MODIS package (v0.10-31):, Function arguments follow the same naming as in MODIS, as much as possible.

antoinestevens/copernicus documentation built on May 10, 2019, 12:23 p.m.