mwtp {support.CEs}R Documentation

Calculating the marginal willingness to pay

Description

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

Usage

mwtp(output, monetary.variables, nonmonetary.variables = NULL,
     nreplications = 10000,
     percentile.points = NULL,
     confidence.level = 0.95,
     method = "kr", 
     seed = NULL)

## S3 method for class 'mwtp'
print(x, digits = max(3, getOption("digits") - 3),
      scientific = FALSE, ...)

Arguments

output

An object containing the output from the function clogit in the package survival or from the function glm in the package stats.

monetary.variables

A vector containing the names of the monetary variables in the output used to calculate the MWTPs.

nonmonetary.variables

A vector containing the names of the non-monetary variables in the output used to calculate the MWTPs. Its default is NULL.

nreplications

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

percentile.points

It is only kept for giving an error message regarding unused argument. It will be removed. The argument confidence.level is used instead.

confidence.level

A value showing the confidence level (coefficient) of an empirical distribution of each MWTP. Its default vector is set as 0.95, which indicates the lower and upper bounds of the 95 percent confidence interval.

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 format.

scientific

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

...

Arguments passed to the function format.

Details

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.

Value

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.

Author(s)

Hideo Aizaki

See Also

make.dataset, clogit, glm, mded

Examples

# See "Examples" for the function make.dataset.

[Package support.CEs version 0.7-0 Index]