Skip to contents

eLTER reporting format naming convention for files

Source: R/eLTER_reporting.R
reporting_compose_file_name.Rd

[Experimental] Compose file name following eLTER naming convention

Usage

reporting_compose_file_name(
  deimsid = NULL,
  country_code = NULL,
  site_name = NULL,
  data_topic,
  variable_group = "",
  time_span,
  version = Sys.Date() %>% format("V%Y%m%d")
)

Arguments

deimsid

A character The DEIMS ID of the site from DEIMS-SDR website. More information about DEIMS ID in this pages: page.

country_code

A character automatically evaluated if DEIMS ID is provided. Otherwise reference to the country of the site as two-digit country code according to ISO 3166-1 alpha-2.

site_name

A character Automatically evaluated if DEIMS ID is provided. Otherwise the name of the site according to DEIMS-SDR, if the name is too long the site name can be shortened.

data_topic

A character. Max 5-digit code for data topic or observation programme, e.g. METEO (Meteorology), BIODIV (Biodiversity), DEPO (deposition), GHG (Green House gas), SW (Soil water), VEG (Vegetation). The abbreviation is defined by the data provider depending on the data.

variable_group

A character. Optional, list of variables or variable groups contained in the data. The abbreviation is defined by the data provider depending on the data.

time_span

A numeric or a character. Time span covered in the data.

version

version in format "VYYYYMMDD". Data version in the format “V”YYYYMMDD. Defaults to current date.

Value

filename (without extension) following naming convention

Note

This method must be intended as a signpost for future implementation

See also

Peterseil, Geiger et al. (2020) Field Specification for data reporting. Technical Document. TechDoc.01. EU Horizon 2020 eLTER PLUS Project, Grant agreement No. 871128 https://zenodo.org/record/6373410

Author

Paolo Tagliolato, phD tagliolato.p@irea.cnr.it

Alessandro Oggioni, phD oggioni.a@irea.cnr.it

Examples

if (FALSE) {
## Not run:

deimsid <- "https://deims.org/8eda49e9-1f4e-4f3e-b58e-e0bb25dc32a6"
time_span <- 2015 # e.g. whole year
# time_span <- "20150302-20180415" # e.g. span between two dates
data_topic <- "VEG" # data provider defined abbreviation of "vegetation"
variable_group <- "SPECCOVER" # data provider defined abbreviation
version <- "V20220907"

filename <- reporting_compose_file_name(
  deimsid = deimsid,
  data_topic = data_topic,
  variable_group = variable_group,
  time_span = time_span,
  version = version
)

## End (Not run)
}