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

This function calculates the marginal willingness to pay for the attributes and/or levels of the estimated model.

1 2 3 4 5 6 7 8 9 10 |

`output` |
An object containing the output from the function |

`monetary.variables` |
A vector containing the names of the monetary variables in the |

`nonmonetary.variables` |
A vector containing the names of the non-monetary variables in the |

`nreplications` |
An integer value denoting the number of replications in the simulation method. The default value is set as |

`percentile.points` |
It is only kept for giving an error message regarding unused argument. It will be removed. The argument |

`confidence.level` |
A value showing the confidence level (coefficient) of an empirical distribution of each MWTP. Its default vector is set as |

`method` |
A character variable describing the method used for calculating confidence intervals of MWTPs. It is set as "kr" if the Krinsky and Robb's method is used; it is set as "delta" if the delta method is used. |

`seed` |
Seed for a random number generator. |

`x` |
An object of S3 class "mwtp." |

`digits` |
A number of significant digits. See the function |

`scientific` |
Whether MWTPs and their confidence intervals are encoded in scientific format. See the function |

`...` |
Arguments passed to the function |

The definition of the marginal willingness to pay (MWTP) for a non-monetary variable provided by this function is *-b_{nm}/b_{m}*; where, *b_{nm}* is the estimated coefficient of the non-monetary variable, and *b_{m}* is the estimated coefficient of a monetary variable. Further, confidence intervals for the MWTPs are calculated according to the simulation method proposed by Krinsky and Robb (1987) or the delta method (see, e.g., Hole 2007).

In the Krinsky and Robb's method, *N* replications of a vector of the coefficients in the model are randomly sampled from a multivariate normal distribution with a vector of means and a variance-covariance matrix of the estimated coefficients. An empirical distribution for each of the MWTPs can be generated from *N* sets of the replicated coefficients, and a confidence interval for each of the MWTPs is identified on the basis of each empirical distribution.

In the delta method, a variance of MWTP of the non-monetary variable is calculated using estimated coefficients and variance-covariance matrix regarding the non-monetary and monetary variables, and then a confidence interval for the MWTP is calculated.

When the argument `nonmonetary.variables`

is not set by the user, variables in the argument `output`

—except for those assigned by the argument `monetary.variables`

—are treated as non-monetary variables, and the MWTPs for these variables are calculated. In the model that assumes alternative-specific attribute variables (that is, a labeled type choice experiment design), variables in the argument `output`

are classified into monetary and non-monetary variables according to the alternatives. Therefore, the argument `monetary.variables`

is set as a vector, whereas the argument `nonmonetary.variables`

is set as a list of vectors.

In version 0.3-0 and later versions, this function is also available for binary choice models estimated using the function `glm`

.

This function returns an object of S3 class "mwtp" that is a list with the following components.

`mwtp.table` |
A matrix containing the MWTPs for the non-monetary attribute variables and confidence intervals for each of the MWTPs. |

`method` |
A character variable containing the method used for calculating confidence intervals of MWTPs. |

`mwtps` |
A matrix containing empirical distributions of the MWTPs. It is included when the Krinsky and Robb's method is used. |

`repb` |
A matrix containing N sets of replicated coefficients. It is included when the Krinsky and Robb's method is used. |

The object `mwtps`

can be used for a function `mded`

in the package mded that calculates differences between two independent/dependent empirical distributions of the MWTPs.

Hideo Aizaki

`make.dataset`

, `clogit`

, `glm`

, `mded`

1 | ```
# See "Examples" for the function make.dataset.
``` |

```
Loading required package: DoE.base
Loading required package: grid
Loading required package: conf.design
Attaching package: 'DoE.base'
The following objects are masked from 'package:stats':
aov, lm
The following object is masked from 'package:graphics':
plot.design
The following object is masked from 'package:base':
lengths
Loading required package: MASS
Loading required package: simex
Loading required package: RCurl
Loading required package: bitops
Loading required package: XML
```

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.