hddtools (version 0.5)

catalogueSEPA: Data source: SEPA catalogue

Description

This function provides an unofficial SEPA database catalogue of river level data (available from http://pennine.ddns.me.uk/riverlevels/ConciseList.html) containing info for 1752 stations. Some are NRFA stations.

Usage

catalogueSEPA(columnName = NULL, columnValue = NULL, useCachedData = TRUE)

Arguments

columnName

name of the column to filter

columnValue

value to look for in the column named columnName

useCachedData

logical, set to TRUE to use cached data, set to FALSE to retrive data from online source. This is TRUE by default.

Value

This function returns a data frame made of a maximum of 830 rows (stations) and 8 columns: "idNRFA","aspxpage", "stationId", "River", "Location", "GridRef", "Operator" and "CatchmentArea(km2)". Column idNRFA shows the National River Flow Archive station id. Column "aspxpage" returns the Environment Agency gauges id. The column "stationId" is the id number used by SEPA. Use the stationId to retrieve the time series of water levels.

Examples

## Not run: ------------------------------------
#   # Retrieve the whole catalogue
#   SEPA_catalogue_all <- catalogueSEPA()
# 
#   # Get only catchments with area above 5000 Km2
#   SEPA_catalogue_area <- catalogueSEPA(columnName = "CatchmentAreaKm2",
#                                        columnValue = ">= 5000")
# 
#   # Get only catchments within river Avon
#   SEPA_catalogue_river <- catalogueSEPA(columnName = "River",
#                                         columnValue = "Avon")
## ---------------------------------------------