download_data: Download ERA5-Land Data

In rIACI: Iberian Actuarial Climate Index Calculations

Download ERA5-Land Data

Description

Downloads ERA5-Land data from the ECMWF Climate Data Store for the specified time range and variables. Implements a retry mechanism to handle transient errors during data download.

Usage

download_data(
  start_year,
  end_year,
  start_month = 1,
  end_month = 12,
  variables = c("10m_u_component_of_wind", "10m_v_component_of_wind", "2m_temperature",
    "total_precipitation"),
  dataset = "reanalysis-era5-land",
  area = c(-90, -180, 90, 180),
  output_dir = "cds_data",
  user_id,
  user_key,
  max_retries = 3,
  retry_delay = 5,
  timeout = 7200
)

Arguments

start_year	Integer. The starting year for data download.
end_year	Integer. The ending year for data download.
start_month	Integer. The starting month (default is 1).
end_month	Integer. The ending month (default is 12).
variables	Character vector. Variables to download. Default includes common variables: c("10m_u_component_of_wind", "10m_v_component_of_wind", "2m_temperature", "total_precipitation").
dataset	Character. Dataset short name (default is "reanalysis-era5-land").
area	Numeric vector. Geographical area specified as c(North, West, South, East).
output_dir	Character. Directory to save the downloaded data (default is "cds_data").
user_id	Character. Your ECMWF user ID.
user_key	Character. Your ECMWF API key.
max_retries	Integer. Maximum number of retry attempts in case of download failure (default is 3).
retry_delay	Numeric. Delay between retry attempts in seconds (default is 5).
timeout	Numeric. Timeout duration for each request in seconds (default is 7200, i.e., 2 hours).

Value

None. Data is downloaded to the specified output directory.

Examples

## Not run: 
# Set your ECMWF user ID and key
user_id <- "your_user_id"
user_key <- "your_api_key"

# Define the geographical area (North, West, South, East)
area <- c(90, -180, -90, 180) # Global

# Download data for 2020
download_data(
  start_year = 2020,
  end_year = 2020,
  variables = c("2m_temperature", "total_precipitation"),
  area = area,
  user_id = user_id,
  user_key = user_key
)

## End(Not run)

rIACI documentation built on April 12, 2025, 9:16 a.m.