Package 'getCRUCLdata' reference manual

Title:	'CRU' 'CL' v. 2.0 Climatology Client
Description:	Provides functions that automate downloading and importing University of East Anglia Climate Research Unit ('CRU') 'CL' v. 2.0 climatology data, facilitates the calculation of minimum temperature and maximum temperature and formats the data into a data frame or a list of 'terra' 'rast' objects for use. 'CRU' 'CL' v. 2.0 data are a gridded climatology of 1961-1990 monthly means released in 2002 and cover all land areas (excluding Antarctica) at 10 arc minutes (0.1666667 degree) resolution. For more information see the description of the data provided by the University of East Anglia Climate Research Unit, <https://crudata.uea.ac.uk/cru/data/hrg/tmc/readme.txt>.
Authors:	Adam H. Sparks [aut, cre]
Maintainer:	Adam H. Sparks <[email protected]>
License:	MIT + file LICENSE
Version:	0.3.3
Built:	2024-08-29 23:09:30 UTC
Source:	https://github.com/ropensci/getCRUCLdata

Create a data of climatology variables from local disk files

Description

Automates importing CRU CL v.2.0 climatology data and creates a tidy data frame of the data. If requested, minimum and maximum temperature may also be automatically calculated as described in the data readme.txt file. This function can be useful if you have network connection issues that mean automated downloading of the files using R does not work properly.

Nomenclature and units from readme.txt:

pre: precipitation (millimetres/month)

cv: cv of precipitation (percent)

rd0: wet-days (number days with >0.1mm rain per month)
tmp: mean temperature (degrees Celsius)
dtr: mean diurnal temperature range (degrees Celsius)
reh: relative humidity (percent)
sunp: sunshine (percent of maximum possible (percent of day length))
frs: ground-frost (number of days with ground-frost per month)
wnd: 10 metre windspeed (metres/second)
elv: elevation (automatically converted to metres)

For more information see the description of the data provided by CRU, https://crudata.uea.ac.uk/cru/data/hrg/tmc/readme.txt

Usage

create_CRU_df(
  pre = FALSE,
  pre_cv = FALSE,
  rd0 = FALSE,
  tmp = FALSE,
  dtr = FALSE,
  reh = FALSE,
  tmn = FALSE,
  tmx = FALSE,
  sunp = FALSE,
  frs = FALSE,
  wnd = FALSE,
  elv = FALSE,
  dsn = ""
)
create_CRU_df(
  pre = FALSE,
  pre_cv = FALSE,
  rd0 = FALSE,
  tmp = FALSE,
  dtr = FALSE,
  reh = FALSE,
  tmn = FALSE,
  tmx = FALSE,
  sunp = FALSE,
  frs = FALSE,
  wnd = FALSE,
  elv = FALSE,
  dsn = ""
)

Arguments

`pre`	Logical. Fetch precipitation (millimetres/month) from server and return in the data frame? Defaults to `FALSE`.
`pre_cv`	Logical. Fetch cv of precipitation (percent) from server and return in the data frame? Defaults to `FALSE`. NOTE. Setting this to `TRUE` will always results in pre being set to `TRUE` and returned as well.
`rd0`	Logical. Fetch wet-days (number days with >0.1millimetres rain per month) and return in the data frame? Defaults to `FALSE`.
`tmp`	Logical. Fetch temperature (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`dtr`	Logical. Fetch mean diurnal temperature range (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`reh`	Logical. Fetch relative humidity and return it in the data frame? Defaults to `FALSE`.
`tmn`	Logical. Calculate minimum temperature values (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`tmx`	Logical. Calculate maximum temperature (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`sunp`	Logical. Fetch sunshine, percent of maximum possible (percent of day length) and return it in data frame? Defaults to `FALSE`.
`frs`	Logical. Fetch ground-frost records (number of days with ground- frost per month) and return it in data frame? Defaults to `FALSE`.
`wnd`	Logical. Fetch 10m wind speed (metres/second) and return it in the data frame? Defaults to `FALSE`.
`elv`	Logical. Fetch elevation (converted to metres) and return it in the data frame? Defaults to `FALSE`.
`dsn`	Local file path where CRU CL v.2.0 .dat.gz files are located.

Value

A tidy data frame of CRU CL v. 2.0 climatology elements as a data.frame object

Note

This package automatically converts elevation values from kilometres to metres.

Author(s)

Adam H Sparks, [email protected]

Examples


# Create a data frame of temperature from locally available files in the
# tempdir() directory.

download.file(
  url = "https://crudata.uea.ac.uk/cru/data/hrg/tmc/grid_10min_tmp.dat.gz",
  destfile = file.path(tempdir(), "grid_10min_tmp.dat.gz")
)

CRU_tmp <- create_CRU_df(tmp = TRUE, dsn = tempdir())

CRU_tmp

# Create a data frame of temperature from locally available files in the
# tempdir() directory.

download.file(
  url = "https://crudata.uea.ac.uk/cru/data/hrg/tmc/grid_10min_tmp.dat.gz",
  destfile = file.path(tempdir(), "grid_10min_tmp.dat.gz")
)

CRU_tmp <- create_CRU_df(tmp = TRUE, dsn = tempdir())

CRU_tmp

Create a list of terra rast objects from local disk files

Description

Automates importing CRU CL v.2.0 climatology data and creates a terra rast of the data. If requested, minimum and maximum temperature may also be automatically calculated as described in the data readme.txt file. This function can be useful if you have network connection issues that mean automated downloading of the files using R does not work properly.

Nomenclature and units from readme.txt:

pre: precipitation (millimetres/month)

cv: cv of precipitation (percent)

rd0: wet-days (number days with >0.1mm rain per month)
tmp: mean temperature (degrees Celsius)
dtr: mean diurnal temperature range (degrees Celsius)
reh: relative humidity (percent)
sunp: sunshine (percent of maximum possible (percent of day length))
frs: ground-frost (number of days with ground-frost per month)
wnd: 10 metre windspeed (metres/second)
elv: elevation (automatically converted to metres)

For more information see the description of the data provided by CRU, https://crudata.uea.ac.uk/cru/data/hrg/tmc/readme.txt

Usage

create_CRU_stack(
  pre = FALSE,
  pre_cv = FALSE,
  rd0 = FALSE,
  tmp = FALSE,
  dtr = FALSE,
  reh = FALSE,
  tmn = FALSE,
  tmx = FALSE,
  sunp = FALSE,
  frs = FALSE,
  wnd = FALSE,
  elv = FALSE,
  dsn = ""
)
create_CRU_stack(
  pre = FALSE,
  pre_cv = FALSE,
  rd0 = FALSE,
  tmp = FALSE,
  dtr = FALSE,
  reh = FALSE,
  tmn = FALSE,
  tmx = FALSE,
  sunp = FALSE,
  frs = FALSE,
  wnd = FALSE,
  elv = FALSE,
  dsn = ""
)

Arguments

`pre`	Logical. Fetch precipitation (millimetres/month) from server and return in the data frame? Defaults to `FALSE`.
`pre_cv`	Logical. Fetch cv of precipitation (percent) from server and return in the data frame? Defaults to `FALSE`. NOTE. Setting this to `TRUE` will always results in pre being set to `TRUE` and returned as well.
`rd0`	Logical. Fetch wet-days (number days with >0.1millimetres rain per month) and return in the data frame? Defaults to `FALSE`.
`tmp`	Logical. Fetch temperature (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`dtr`	Logical. Fetch mean diurnal temperature range (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`reh`	Logical. Fetch relative humidity and return it in the data frame? Defaults to `FALSE`.
`tmn`	Logical. Calculate minimum temperature values (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`tmx`	Logical. Calculate maximum temperature (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`sunp`	Logical. Fetch sunshine, percent of maximum possible (percent of day length) and return it in data frame? Defaults to `FALSE`.
`frs`	Logical. Fetch ground-frost records (number of days with ground- frost per month) and return it in data frame? Defaults to `FALSE`.
`wnd`	Logical. Fetch 10m wind speed (metres/second) and return it in the data frame? Defaults to `FALSE`.
`elv`	Logical. Fetch elevation (converted to metres) and return it in the data frame? Defaults to `FALSE`.
`dsn`	Local file path where CRU CL v.2.0 .dat.gz files are located.

Value

A list of terra rast objects of CRU CL v. 2.0 climatology elements

Note

This package automatically converts elevation values from kilometres to metres.

This package crops all spatial outputs to an extent of ymin = -60, ymax = 85, xmin = -180, xmax = 180. Note that the original wind data include land area for parts of Antarctica, these data are excluded in the terra rast objects generated by this function.

Author(s)

Adam H. Sparks, [email protected]

Examples


# Create a terra rast object of temperature from tmp files in the tempdir()
# directory.

download.file(
  url = "https://crudata.uea.ac.uk/cru/data/hrg/tmc/grid_10min_tmp.dat.gz",
  destfile = file.path(tempdir(), "grid_10min_tmp.dat.gz")
)

CRU_tmp <- create_CRU_stack(tmp = TRUE, dsn = tempdir())

CRU_tmp

# Create a terra rast object of temperature from tmp files in the tempdir()
# directory.

download.file(
  url = "https://crudata.uea.ac.uk/cru/data/hrg/tmc/grid_10min_tmp.dat.gz",
  destfile = file.path(tempdir(), "grid_10min_tmp.dat.gz")
)

CRU_tmp <- create_CRU_stack(tmp = TRUE, dsn = tempdir())

CRU_tmp

Download and create a data frame of climatology parameters

Description

This function automates downloading and importing CRU CL v. 2.0 climatology data and creates a data frame of the data. If requested, minimum and maximum temperature may also be automatically calculated as described in the data readme.txt file. Data may be cached for later use by this function, saving time downloading files in future use of the function.

Nomenclature and units from readme.txt:

pre: precipitation (millimetres/month)

cv: cv of precipitation (percent)

rd0: wet-days (number days with >0.1mm rain per month)
tmp: mean temperature (degrees Celsius)
dtr: mean diurnal temperature range (degrees Celsius)
reh: relative humidity (percent)
sunp: sunshine (percent of maximum possible (percent of day length))
frs: ground-frost (number of days with ground-frost per month)
wnd: 10 metre windspeed (metres/second)
elv: elevation (automatically converted to metres)

For more information see the description of the data provided by CRU, https://crudata.uea.ac.uk/cru/data/hrg/tmc/readme.txt

Usage

get_CRU_df(
  pre = FALSE,
  pre_cv = FALSE,
  rd0 = FALSE,
  tmp = FALSE,
  dtr = FALSE,
  reh = FALSE,
  tmn = FALSE,
  tmx = FALSE,
  sunp = FALSE,
  frs = FALSE,
  wnd = FALSE,
  elv = FALSE,
  cache = FALSE
)
get_CRU_df(
  pre = FALSE,
  pre_cv = FALSE,
  rd0 = FALSE,
  tmp = FALSE,
  dtr = FALSE,
  reh = FALSE,
  tmn = FALSE,
  tmx = FALSE,
  sunp = FALSE,
  frs = FALSE,
  wnd = FALSE,
  elv = FALSE,
  cache = FALSE
)

Arguments

`pre`	Logical. Fetch precipitation (millimetres/month) from server and return in the data frame? Defaults to `FALSE`.
`pre_cv`	Logical. Fetch cv of precipitation (percent) from server and return in the data frame? Defaults to `FALSE`. NOTE. Setting this to `TRUE` will always results in pre being set to `TRUE` and returned as well.
`rd0`	Logical. Fetch wet-days (number days with >0.1 millimetres rain per month) and return in the data frame? Defaults to `FALSE`.
`tmp`	Logical. Fetch temperature (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`dtr`	Logical. Fetch mean diurnal temperature range (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`reh`	Logical. Fetch relative humidity and return it in the data frame? Defaults to FALSE.
`tmn`	Logical. Calculate minimum temperature values (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`tmx`	Logical. Calculate maximum temperature (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`sunp`	Logical. Fetch sunshine, percent of maximum possible (percent of day length) and return it in data frame? Defaults to `FALSE`.
`frs`	Logical. Fetch ground-frost records (number of days with ground- frost per month) and return it in data frame? Defaults to `FALSE`.
`wnd`	Logical. Fetch 10m wind speed (metres/second) and return it in the data frame? Defaults to `FALSE`.
`elv`	Logical. Fetch elevation (converted to metres) and return it in the data frame? Defaults to `FALSE`.
`cache`	Logical. Store CRU CL v. 2.0 data files locally for later use? If `FALSE`, the downloaded files are removed when R session is closed. To take advantage of cached files in future sessions, use `cache = TRUE` after the initial download and caching. Defaults to `FALSE`.

Value

A tidy data frame of CRU CL v. 2.0 climatology elements as a tibble object

Note

This package automatically converts elevation values from kilometres to metres.

Author(s)

Adam H. Sparks, [email protected]

Examples


# Download data and create a data frame of precipitation and temperature
# without caching the data files
CRU_pre_tmp <- get_CRU_df(pre = TRUE, tmp = TRUE)

head(CRU_pre_tmp)
CRU_pre_tmp

# Download data and create a data frame of precipitation and temperature
# without caching the data files
CRU_pre_tmp <- get_CRU_df(pre = TRUE, tmp = TRUE)

head(CRU_pre_tmp)
CRU_pre_tmp

Download and create a list of terra rast objects of climatology parameters

Description

This function automates downloading and importing CRU CL v. 2.0 climatology data into R and creates a list of terra rast of the data. If requested, minimum and maximum temperature may also be automatically calculated as described in the data readme.txt file. Data may be cached for later use by this function, saving time downloading files in future use of the function.

Nomenclature and units from readme.txt:

pre: precipitation (millimetres/month)

cv: cv of precipitation (percent)

rd0: wet-days (number days with >0.1mm rain per month)
tmp: mean temperature (degrees Celsius)
dtr: mean diurnal temperature range (degrees Celsius)
reh: relative humidity (percent)
sunp: sunshine (percent of maximum possible (percent of day length))
frs: ground-frost (number of days with ground-frost per month)
wnd: 10 metre windspeed (metres/second)
elv: elevation (automatically converted to metres)

For more information see the description of the data provided by CRU, https://crudata.uea.ac.uk/cru/data/hrg/tmc/readme.txt

Usage

get_CRU_stack(
  pre = FALSE,
  pre_cv = FALSE,
  rd0 = FALSE,
  tmp = FALSE,
  dtr = FALSE,
  reh = FALSE,
  tmn = FALSE,
  tmx = FALSE,
  sunp = FALSE,
  frs = FALSE,
  wnd = FALSE,
  elv = FALSE,
  cache = FALSE
)
get_CRU_stack(
  pre = FALSE,
  pre_cv = FALSE,
  rd0 = FALSE,
  tmp = FALSE,
  dtr = FALSE,
  reh = FALSE,
  tmn = FALSE,
  tmx = FALSE,
  sunp = FALSE,
  frs = FALSE,
  wnd = FALSE,
  elv = FALSE,
  cache = FALSE
)

Arguments

`pre`	Logical. Fetch precipitation (millimetres/month) from server and return in the data frame? Defaults to `FALSE`.
`pre_cv`	Logical. Fetch cv of precipitation (percent) from server and return in the data frame? Defaults to `FALSE`. NOTE. Setting this to `TRUE` will always results in pre being set to `TRUE` and returned as well.
`rd0`	Logical. Fetch wet-days (number days with >0.1millimetres rain per month) and return in the data frame? Defaults to `FALSE`.
`tmp`	Logical. Fetch temperature (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`dtr`	Logical. Fetch mean diurnal temperature range (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`reh`	Logical. Fetch relative humidity and return it in the data frame? Defaults to FALSE.
`tmn`	Logical. Calculate minimum temperature values (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`tmx`	Logical. Calculate maximum temperature (degrees Celsius) and return it in the data frame? Defaults to `FALSE`.
`sunp`	Logical. Fetch sunshine, percent of maximum possible (percent of day length) and return it in data frame? Defaults to `FALSE`.
`frs`	Logical. Fetch ground-frost records (number of days with ground- frost per month) and return it in data frame? Defaults to `FALSE`.
`wnd`	Logical. Fetch 10m wind speed (metres/second) and return it in the data frame? Defaults to `FALSE`.
`elv`	Logical. Fetch elevation (converted to metres) and return it in the data frame? Defaults to `FALSE`.
`cache`	Logical. Store CRU CL v. 2.0 data files locally for later use? If `FALSE`, the downloaded files are removed when R session is closed. To take advantage of cached files in future sessions, use `cache = TRUE` after the initial download and caching. Defaults to `FALSE`.

Value

A list of terra rast objects of CRU CL v. 2.0 climatology elements

Note

This package automatically converts elevation values from kilometres to metres.

Author(s)

Adam H. Sparks, [email protected]

Examples


# Download data and create a \code{\link{terra}} \code{\link[terra]{rast}}
# object of precipitation and temperature without caching the data files
CRU_pre_tmp <- get_CRU_stack(pre = TRUE, tmp = TRUE)

CRU_pre_tmp


# Download data and create a \code{\link{terra}} \code{\link[terra]{rast}}
# object of precipitation and temperature without caching the data files
CRU_pre_tmp <- get_CRU_stack(pre = TRUE, tmp = TRUE)

CRU_pre_tmp

Manage locally cached CRU CL v. 2.0 files

Description

Manage cached getCRUCLdata files with hoardr

Details

The default cache directory is file.path(rappdirs::user_cache_dir(), "R/getCRUCLdata"), but you can set your own path using manage_cache$cache_path_set()

manage_cache$cache_delete only accepts one file name, while manage_cache$cache_delete_all does not accept any names, but deletes all files. For deleting many specific files, use manage_cache$cache_delete in an lapply() type call.

Useful user functions

manage_cache$cache_path_get() - get cache path
manage_cache$cache_path_set() - set cache path
manage_cache$list() - returns a character vector of full path file names
manage_cache$files() - returns file objects with metadata
manage_cache$details() - returns files with details
manage_cache$delete() - delete specific files
manage_cache$delete_all() - delete all files, returns nothing

Author(s)

Adam H. Sparks, [email protected]

Examples

## Not run: 

# list files in cache
manage_cache$list()

# delete certain database files
manage_cache$delete("file path")
manage_cache$list()

# delete all files in cache
manage_cache$delete_all()
manage_cache$list()

# set a different cache path from the default
manage_cache$cache_path_set("~/tmp")

## End(Not run)
## Not run: 

# list files in cache
manage_cache$list()

# delete certain database files
manage_cache$delete("file path")
manage_cache$list()

# delete all files in cache
manage_cache$delete_all()
manage_cache$list()

# set a different cache path from the default
manage_cache$cache_path_set("~/tmp")

## End(Not run)

Package 'getCRUCLdata'

Help Index

Create a data of climatology variables from local disk files

Description

Usage

Arguments

Value

Note

Author(s)

See Also

Examples

Create a list of terra rast objects from local disk files

Description

Usage

Arguments

Value

Note

Author(s)

See Also

Examples

Download and create a data frame of climatology parameters

Description

Usage

Arguments

Value

Note

Author(s)

See Also

Examples

Download and create a list of terra rast objects of climatology parameters

Description

Usage

Arguments

Value

Note

Author(s)

See Also

Examples

Manage locally cached CRU CL v. 2.0 files

Description

Details

Useful user functions

Author(s)

Examples