R/rvn_hyd_dygraph.R

In RavenR: Raven Hydrological Modelling Framework R Support and Analysis

#' @title Read in Raven Hydrograph file
#'
#' @description
#' rvn_hyd_dygraph plots modeled vs observed hydrographs when supplied with hydrograph data
#' structure read using \code{\link{rvn_hyd_read}}
#'
#' @param hy hydrograph data structure generated by \code{\link{rvn_hyd_read}} routine
#' @param timezone data timezone; defaults to UTC
#' @param basins list of subbasin names from hydrograph file. Each subbasin creates separate dygraph plots
#' @param main dygraph title to override the default (applied to all dygraphs)
#' @param figheight height of figure, in pixels
#'
#' @return a list of plot handles to dygraph plots
#'
#' @examples
#'
#' # read in RavenR sample hydrographs data
#' hy <- rvn_hydrograph_data
#'
#' # view contents for subbasin 36 as dyGraph
#' dyplots <- rvn_hyd_dygraph(hy,basins="Sub36")
#' dyplots
#'
#' rvn_hyd_dygraph(hy,basins="Sub36", main="test title")
#'
#' # view contents for all basins in hydrograph data
#' rvn_hyd_dygraph(hy)
#'
#' @export rvn_hyd_dygraph
#' @importFrom purrr map
#' @importFrom dygraphs dygraph dyRangeSelector
rvn_hyd_dygraph <- function(hy, timezone="UTC",basins="", main=NULL, figheight=400) {

  if (basins==""){
    basins<-sub('_obs', "", colnames(hy$hyd))
    basins<-sub('_res', "", basins)
    basins<-unique(basins)
    basins<-basins[-1] # no precip ts
  }

  if (is.null(main)) {

    plotfunc <- function(basin){
      hyd <- rvn_hyd_extract(subs = basin, hyd = hy)
      flow <- merge(hyd$sim, hyd$obs)
      return(dygraph(flow, group = 'flows', main = basin, height=figheight) %>%
               dyRangeSelector())
    }
  } else {

    plotfunc <- function(basin){
      hyd <- rvn_hyd_extract(subs = basin, hyd = hy)
      flow <- merge(hyd$sim, hyd$obs)
      return(dygraph(flow, group = 'flows', main = main, height=figheight) %>%
               dyRangeSelector())
    }
  }

  dyplots <- purrr::map(basins, plotfunc) # calls plotfunc for each basin in list basins
  return(dyplots)
}