dMax: Desirability Functions

Description Usage Arguments Details Value Author(s) References See Also Examples

Description

Functions implementing multivariate optimization and ranking using the desirability function approach described in Derringer and Suich (1980)

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
## Default S3 method:
dMax(low, high, scale = 1, tol = NULL, ...)
## Default S3 method:
dMin(low, high, scale = 1, tol = NULL, ...)
## Default S3 method:
dTarget(low, target, high, lowScale = 1, highScale = 1, tol = NULL, ...) 
## Default S3 method:
dArb(x, d, tol = NULL, ...)
## Default S3 method:
dBox(low, high, tol = NULL, ...)
## Default S3 method:
dCategorical(values, tol = NULL, ...)
## Default S3 method:
dOverall(...)

Arguments

low

a constant to define the desirability function for dMax, dMin, dTarget and dBox

high

a constant to define the desirability function for dMax, dMin, dTarget and dBox

target

a constant to define the desirability function for dMax, dMin, dTarget and dBox

scale

the scaling factor for dMax and dMin. Values less than one make the criteria more difficult to satisfy while values greater than one make it easier.

lowScale

the scaling factor for dTarget. This bends the curve between the points low and target. Values less than one make the criteria more difficult to satisfy while values greater than one make it easier.

highScale

the scaling factor for dTarget. This bends the curve between the points high and target. Values less than one make the criteria more difficult to satisfy while values greater than one make it easier.

x

a set of input values

d

a set of desirabilites between zero and one (inclusive) that match the length of x

values

a named numeric vector of possible values

tol

an optional tolerance for zero desirability. When this is non-null, zero desirabilites are replaced with this value

...

For dOverall, this is one or more desirability objects. For the other methods, this argument is not currently used

Details

The functions dMax, dMin, dTarget ande dOverall are the basic equations used by Derringer and Suich (1980). dBox is a simple step funciton between two points. dArb can be used to create other shapes that do not fall into the other funcional forms. See the package vignette or the references for more details

Value

a list. Common values are:

tol

the value specified by the tol argument

call

the origianl function call

Author(s)

Max Kuhn

References

Derringer, G. and Suich, R. (1980), Simultaneous Optimization of Several Response Variables. Journal of Quality Technology 12, 214–219.

See Also

predict.dMax

Examples

1
2
dMax.default(1,3)
dMax(1,3)

Example output

Larger-is-better desirability function

Call: dMax.default(low = 1, high = 3)

Non-informative value: 0.5 
Larger-is-better desirability function

Call: dMax.default(low = 1, high = 3)

Non-informative value: 0.5 

desirability documentation built on May 1, 2019, 8:50 p.m.