rvn_rvh_query {RavenR}

Queries RVH object for subbasins and HRUs of interest

Description

Queries the RVH object for subbasins or HRUs that are upstream of, downstream of, or the opposite of those conditions, for a given subbasin ID.

Usage

rvn_rvh_query(rvh = NULL, subbasinID = NULL, condition = "upstream_of")

Arguments

rvh

rvh object as returned by rvn_rvh_read

subbasinID

subbasinID of basin of interest, as character or integer

condition

condition applied to the query

Details

Based on the definition of subbasins by their outlets in Raven, it is assumed here that 'upstream' includes the specified subbasin (i.e. everything upstream of subbasin X includes subbasin X as well), and 'downstream' of subbasin X does not include subbasin X. This is different from the default behaviour of igraph, which includes the specified subbasin in either query.

Value

rvh object in same format, but queried to condition and all features (SBtable, HRUtable, SBnetwork) updated.

Note

Raven has capabilities for creating subbasin and HRU groups that meet certain criteria as well, consider reviewing the ':PopulateSubbasinGroup', ':PopulateHRUGroup', and other commands in Section A.3.2 of the Raven User's Manual.

See Also

rvn_rvh_write to write contents of the generated (and usually modified HRU and SubBasin tables) rvn_rvh_read to read a Raven RVH file into R

Examples

# load example rvh file
nith <- system.file("extdata","Nith.rvh",package = "RavenR")
rvh <- rvn_rvh_read(nith)

# plot full watershed with igraph library
plot(rvh$SBnetwork)

# query all subbasins upstream of basin 39, plot
rvh_upstream_of_39 <- rvn_rvh_query(rvh, subbasinID=39, condition="upstream_of")
plot(rvh_upstream_of_39$SBnetwork)

# query of HRUs downstream of basin 39
rvn_rvh_query(rvh, subbasinID=39, condition="downstream_of")$SBtable