Learn R Programming

⚠️There's a newer version (1.2.0) of this package.Take me there.

foreSIGHT (version 1.0.0)

Systems Insights from Generation of Hydroclimatic Timeseries

Description

A tool to create hydroclimate scenarios, stress test systems and visualize system performance in scenario-neutral climate change impact assessments. Scenario-neutral approaches 'stress-test' the performance of a modelled system by applying a wide range of plausible hydroclimate conditions (see Brown & Wilby (2012) and Prudhomme et al. (2010) ). These approaches allow the identification of hydroclimatic variables that affect the vulnerability of a system to hydroclimate variation and change. This tool enables the generation of perturbed time series using a range of approaches including simple scaling of observed time series (e.g. Culley et al. (2016) ) and stochastic simulation of perturbed time series via an inverse approach (see Guo et al. (2018) ). It incorporates 'Richardson-type' weather generator model configurations documented in Richardson (1981) , Richardson and Wright (1984), as well as latent variable type model configurations documented in Bennett et al. (2018) , Rasmussen (2013) , Bennett et al. (2019) to generate hydroclimate variables on a daily basis (e.g. precipitation, temperature, potential evapotranspiration) and allows a variety of different hydroclimate variable properties, herein called attributes, to be perturbed. Options are included for the easy integration of existing system models both internally in R and externally for seamless 'stress-testing'. A suite of visualization options for the results of a scenario-neutral analysis (e.g. plotting performance spaces and overlaying climate projection information) are also included. As further developments in scenario-neutral approaches occur the tool will be updated to incorporate these advances.

Copy Link

Version

Install

install.packages('foreSIGHT')

Monthly Downloads

281

Version

1.0.0

License

GPL-3

Maintainer

Bree Bennett

Last Published

December 17th, 2020

Functions in foreSIGHT (1.0.0)

egSimOATSummary

Summary of a OAT scenario.
tankPerformance

A function to calculate difference performance from simulated tank behaviour
modSimulator

modSimulator
tankWrapper

Wrapper function for a rain water tank system model
runSystemModel

Runs a system model and outputs the system performance
generateScenario

Produces time series of hydroclimatic variables for an exposure target.
viewVariables

Prints the names of and units of valid variables
writeControlFile

Writes a sample controlFile.json file
egSimSummary

Summary of a regGrid scenario.
modCalibrator

modCalibrator
tank_obs

Observations for demo tank model examples and vignette
plotPerformanceOAT

Plots performance for one-at-a-time (OAT) perturbations in attributes
viewDefaultOptimArgs

Prints the default optimisation arguments
plotPerformanceSpace

Plots a performance space using the system performance and scenarios as input
generateScenarios

Produces time series of hydroclimatic variables for an exposure space.
getSimSummary

Produces a summary object containing the metadata of a full simulation
viewModelParameters

Prints the names and bounds of the parameters of the stochastic models
viewTankMetrics

Prints the names of the performance metrics of the rain water tank system model
viewModels

Prints the available stochastic model options
plotExpSpace

Plots the location of points in a two-dimensional exposure space
plotPerformanceSpaceMulti

Plots contours of the number of performance thresholds exceeded in the perturbation space
plotOptions

Plots the differences in performance metrics from two system options
plotScenarios

Creates summary plots of the biases in the scenarios
viewAttributeDef

Prints the definition of an attribute
viewAttributes

Prints the names of valid attributes
egSimPerformance_systemB

Performance metrics of an alternate tank model using regGrid scenarios.
calculateAttributes

Calculates the attributes of the hydroclimate time series
createExpSpace

Creates exposure space of hydroclimatic targets for generation of scenarios using 'generateScenarios'
climdata

Example climate projection data
egSimPerformance

Performance metrics of the tank model using regGrid scenarios.
egScalSummary

Summary of a simple scaled scenario.
egScalPerformance

Performance metrics of the tank model using simple scaled scenarios.
egSimOATPerformance

Performance metrics of the tank model using OAT scenarios.
egClimData

Climate attributes from projections.