R/ktm_clim_hourly.R

In dendRoAnalyst: A Tool for Processing and Analyzing Dendrometer Data

#' @title Hourly climate data for Kathmandu derived from ERA5-Land
#'
#' @description
#' Hourly near-surface climate data for Kathmandu, Nepal, extracted from the
#' Copernicus Climate Change Service (C3S) ERA5-Land reanalysis. The dataset is
#' included to demonstrate climate–dendrometer workflows in
#' \pkg{dendRoAnalyst}, including joining hourly climate data with dendrometer
#' observations, event-based analyses, and wavelet-based analyses.
#'
#' @format A data frame with hourly observations and 5 variables:
#' \describe{
#'   \item{\code{TIME}}{Date-time stamp of the hourly observation.}
#'   \item{\code{temp}}{Air temperature in degree Celsius.}
#'   \item{\code{prec}}{Precipitation in millimetres.}
#'   \item{\code{VPD}}{Vapour pressure deficit in kPa.}
#'   \item{\code{RH}}{Relative humidity in percent.}
#' }
#'
#' @details
#' \code{ktm_clim_hourly} contains a single-location hourly climate time series
#' for Kathmandu derived from ERA5-Land. ERA5-Land is a global land-surface
#' reanalysis produced by replaying the land component of ERA5 at enhanced
#' spatial resolution and is widely used for land-surface and ecohydrological
#' applications.
#'
#' This dataset is intended as an example climate input for
#' \pkg{dendRoAnalyst}. It can be used, for example, with functions that join
#' dendrometer and climate data, calculate phase-climate relations, run event
#' analyses, or perform wavelet and wavelet-coherence analyses.
#'
#' Users should check the exact temporal coverage of the object in their local
#' installation, for example with:
#' \preformatted{
#' range(ktm_clim_hourly$TIME)
#' }
#'
#' @source
#' Extracted from the Copernicus Climate Change Service (C3S) Climate Data Store
#' ERA5-Land reanalysis product:
#'
#' Muñoz-Sabater, J. (2019). ERA5-Land hourly data from 1950 to present.
#' Copernicus Climate Change Service (C3S) Climate Data Store (CDS).
#'
#' @references
#' Muñoz-Sabater, J., Dutra, E., Agustí-Panareda, A., Albergel, C.,
#' Arduini, G., Balsamo, G., Boussetta, S., Choulga, M., Harrigan, S.,
#' Hersbach, H., Martens, B., Miralles, D. G., Piles, M.,
#' Rodríguez-Fernández, N. J., Zsoter, E., Buontempo, C., and Thépaut, J.-N.
#' (2021). ERA5-Land: a state-of-the-art global reanalysis dataset for land
#' applications. \emph{Earth System Science Data}, 13, 4349--4383.
#'
"ktm_clim_hourly"