R: Construct an interpolation conversion node

utility.conversion.intpol.create {utility}

R Documentation

Construct an interpolation conversion node

Description

Function to construct a node converting values into utilities by interpolation.

Usage

utility.conversion.intpol.create(name.node, 
                                 node, 
                                 x, 
                                 u, 
                                 names.x      = rep(NA, length(x)), 
                                 names.u      = rep(NA, length(u)), 
                                 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.
`x`	numeric vector of values for which the utility is known.
`u`	numeric vector of utilities corresponding to the values given in the previous argument `x`.
`names.x`	(optional) vector of character strings with names of the components of the numeric vector `x` specified above. Only required to provide access to the values through a named parameter vector.
`names.u`	(optional) vector of character strings with names of the components of the numeric vector `u` specified above. Only required to provide acces 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.intpol1 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.