cds_build_request: Prepare a request for downloading a dataset

In CopernicusClimate: Search Download and Handle Data from Copernicus Climate Data Service

Prepare a request for downloading a dataset

Description

This function is used by cds_estimate_costs() and cds_submit_job() to subset a dataset before downloading. It will also help you to explore which parameters are available for subsetting.

Usage

cds_build_request(dataset, ...)

Arguments

dataset	The dataset name to be used for setting up a request.
...	Parameters for subsetting the dataset. Use cds_dataset_form() to inquiry which parameters and parameter values are available for a specific dataset. If left blank it will take default parameter values.

Value

Returns a named list, which can be used to submit a job (cds_submit_job()) or inquiry its cost (cds_estimate_costs()).

Examples

if (interactive()) {
  cds_build_request(
    dataset        = "reanalysis-era5-pressure-levels",
    variable       = "geopotential",
    product_type   = "reanalysis",
    area           = c(n = 55, w = -1, s = 50, e = 10),
    year           = "2024",
    month          = "03",
    day            = "01",
    pressure_level = "1000",
    data_format    = "netcdf"
  )
}

CopernicusClimate documentation built on Jan. 8, 2026, 1:08 a.m.