Collecting data paths

Many packages focus on the access to raster, vector, and tabular data, providing constant updates and improvements. For this reason, masDMT does not offer additional data access tools. Instead, it helps users locate relevant data. list_data() uses unique data identifiers as displayed in the MAS data catalog to find and report metadata on the relevant data files, including their format and location. As shown below, we can construct a data call in different levels of complexity, from a generic dataset request to a combination of dataset, subdataset, and spatial resolution.

# find all files for dataset "CCI_landCover"
list_data('CCI_landCover')

# find all files for subdataset "landCover" of dataset "CCI_landCover"
list_data('CCI_landCover/landCover')

# find all files subdataset "landCover" of dataset "CCI_landCover" with a resolution of "300m"
list_data('CCI_landCover/landCover/300m')

Calling list_data() without specifying a dataset call will return a data.frame listing all registered datasets. It is a useful tool to consult the complexity of the available data, helping us refine our search query.

dataset subdataset resolution path format start end modified
CCI_landCover landCover 300m CCI_landCover/CCI_landCover-landCover_20010000_300m.tif tif 2001-12-31 2001-12-31 2020-09-10 13:44:53
CCI_landCover landCover 1km CCI_landCover/CCI_landCover-landCover_200200000_1km.tif tif 2002-12-31 2002-12-31 2020-09-10 13:45:12