R: Construct a parametric function conversion node

utility.conversion.parfun.create {utility}

R Documentation

Construct a parametric function conversion node

Description

Function to construct a node converting values into utilities by a parametric function.

Usage

utility.conversion.parfun.create(name.node, 
                                 node, 
                                 name.fun, 
                                 par, 
                                 names.par    = rep(NA, length(par)), 
                                 required     = FALSE, 
                                 col          = "black", 
                                 shift.levels = 0)

Arguments

`name.node`	name of the node to be constructed as a character string.
`node`	value node that is to be converted into a utility node.
`name.fun`	name of the parametric function to be evaluated as a character string. The parametric function must have the arguments `u` and `par` which pass a vector of values and a vector of parameters to the function, respectively. The function has to return a vector of corresponding utilities.
`par`	numeric vector of parameter values to be passed to the function specified unter `name.fun`.
`names.par`	(optional) vector of parameter names corresponging to the vector of values specified under `par`. Only required to provide access to the values through a named parameter vector.
`required`	(optional) logical variable indicating if the value of this node is required for aggregation at the next higher level. If this variable is `TRUE`, aggregation at the next higher level is not possible if this node returns NA. Default value is `FALSE`.
`col`	(optional) color used for plotting the bounding box of the node in the objective hierarchy. Default value is `"black"`.
`shift.levels`	(optional) number of hierarchical levels by which the node in the objective hierarchy is shifted to make a branch fit better to other branches. Default value is `0`.

Value

The function returns the created object of type utility.conversion.parfun with the properties specified in the arguments of the function.

Author(s)

Peter Reichert <peter.reichert@emeriti.eawag.ch>

References

Short description of the package:

Reichert, P., Schuwirth, N. and Langhans, S., Constructing, evaluating and visualizing value and utility functions for decision support, Environmental Modelling & Software 46, 283-291, 2013.

Textbooks on the use of utility and value functions in decision analysis:

Keeney, R. L. and Raiffa, H. Decisions with Multiple Objectives - Preferences and Value Tradeoffs. John Wiley & Sons, 1976.

Eisenfuehr, F., Weber, M. and Langer, T., Rational Decision Making, Springer, Berlin, 2010.