This accessory function extracts metadata included in the name of a Sentinel-2 product which follows the sen2r naming convention (see safe_shortname).
sen2r_getElements(
s2_names,
naming_convention,
format = "data.table",
abort = TRUE
)A vector of Sentinel-2 product names in the sen2r naming convention.
The naming convention used to extract information
from s2_names names. "sen2r" is the
sen2r naming convention;
an experimental accepted value is "sen2r_new" (it will be documented in future).
By default (argument unspecified or NULL), "sen2r" is used unless
any s2_names matches "sen2r" while some matches "sen2r_new".
Alternatively, a list with the manual definition of the naming convention
can be provided (the required format will be documented in a future release).
One between data.table (default), data.frame and list.
Logical parameter: if TRUE (default), the function aborts
in case any of s2_names is not recognised; if FALSE, a warning is shown,
and a list with only the element "type"='unrecognised' is returned.
A data.table, data.frame or list of the output metadata.
License: GPL 3.0
L. Ranghetti, M. Boschetti, F. Nutini, L. Busetto (2020). "sen2r": An R toolbox for automatically downloading and preprocessing Sentinel-2 satellite data. Computers & Geosciences, 139, 104473. doi:10.1016/j.cageo.2020.104473 , URL: https://sen2r.ranghetti.info/.
# Define product name
fs2nc_examplename <-
"/path/of/the/product/S2A1C_20170603_022_32TQQ_TOA_20.tif"
# Return metadata
sen2r_getElements(fs2nc_examplename)
#> type mission level sensing_date id_orbit extent_name prod_type res file_ext
#> 1: tile A 1C 2017-06-03 022 32TQQ TOA 20m tif