oohbchoice | R Documentation |
This function analyzes one-and-one-half-bound dichotomous choice contingent valuation (CV) data on the basis of the utility difference approach.
oohbchoice(formula, data, subset, na.action = na.omit, dist = "log-logistic",
par = NULL, ...)
formula |
an object of S3 class |
data |
a data frame containing the variables in the model formula. |
subset |
an optional vector specifying a subset of observations. |
na.action |
a function which indicates what should happen when the data contains |
dist |
a character string setting the error distribution in the model, which
takes one of |
par |
a vector of initial parameters over which the optimization is carried out. |
... |
optional arguments. Currently not in use. |
One-and-one-half-bound dichotomous choice contingent valuation (OOHBDC-CV), which was developed by Cooper et al. (2002), is an intermediate CV format between single-bounded dichotomous choice (SBDC) CV format and double-bounded dichotomous choice (DBDC) CV format.
On the basis of an example of environmental valuation study, we will explain differences in question format among SBDC-CV, DBDC-CV, and OOHBDC-CV below.
In any of three CV surveys, two situations are firstly explained to the respondents: the current situation and the improved situation where an environmental improvement plan is assumed to be implemented. Question following the explanation of situations differs according to CV types.
In an SBDC-CV survey, after the explanation of situation mentioned above, the respondents are asked whether they would be willing to pay a certain amount of money toward the implementation of the plan. Therefore, there are two possible responses to the SBDC-CV survey: "yes (agree)," and "no (disagree)." The amounts (bids) that respondents are requested to contribute toward the plan are listed in advance. Each respondent is requested to answer a question randomly assigned with one of the listed bids.
In a DBDC-CV survey, the CV question consists of two stages: after answering the SBDC-CV style question mentioned above (the first stage), the respondents are also asked to answer an additional SBDC-CV style question (the second stage). The bid in the second stage varies according the response in the first stage: a higher bid is displayed in the second stage if the response in the first stage is "yes," whereas a lower bid is displayed when the response in the first stage is "no." Therefore, there are four possible responses to the DBDC-CV survey: "yes-yes" ("yes" in the both stages), "yes-no" ("yes" and "no" in the first and second stages, respectively), "no-yes" ("no" and "yes" in the first and second stages, respectively), and "no-no" ("no" in the both stages).
In the OOHBDC-CV survey, after answering the first SBDC-CV style question (the first stage), only respondents who satisfy certain conditions are requested to answer an additional SBDC-CV style question (the second stage). Details in the OOHBDC-CV survey are as follows: Step 1) A list of bid ranges [BLj, BHj] (j = 1, 2, ..., J), where BLj < BHj, are decided: i.e., [BL1, BH1], [BL2, BH2], ..., and [BLJ, BHJ]. Step 2) One of the bid ranges is randomly presented to respondents (e.g., a bid range of [BL3, BH3] for j = 3). Step 3) One of the two bids presented to the respondents is selected randomly (i.e., BL3 or BH3 in the case of step 2 example) and then the respondents are asked whether they would be willing to pay the amount of the bid selected (the first stage). Step 4) The respondents are asked to answer the second stage if they satisfy either condition: (a) their answer in the first stage is "yes" when the lower bid is presented in the first stage, or (b) their answer in the first stage is "no" when the higher bid is presented in the first stage. Therefore, there are six possible responses to the OOHBDC-CV survey: "no", "yes-no", and "yes-yes" when the lower bid is shown in the first stage; and "yes", "no-yes", and "no-no" when the higher bid is shown in the first stage. Refer to Cooper et al. (2002) for detailed explanation of OOHBDC-CV, including the example CV questions.
The function oohbchoice()
implements an analysis of OOHBDC-CV responses (data) on the basis of the utility difference approach (Hanemann, 1984).
The function returns an object of S3 class oohbchoice
(see below for details), which inherits from an S3 class dbchoice
. The generic functions for the S3 class dbchoice
such as print()
, summary()
, vcov()
, logLik()
, plot()
, and update()
, are available for the S3 class oohbchoice
. In addition, the two functions krCI()
and bootCI()
are available to compute the confidence intervals for the estimates of willingness-to-pays (WTPs): krCI()
implements simulations to construct empirical distributions of the WTP, while bootCI()
carries out nonparametric bootstrapping (see the package DCchoice for details).
Although oohbchoice()
has six arguments, a basic generic call to oohbchoice()
is given as follows:
oohbchoice(formula, data, dist = "log-logistic")
The argument formula
defines the response variables and covariates (see below for details on the formula). The argument data
specifies the data frame containing the variables in the model. The argument dist
sets the error distribution: one of "logistic"
, "normal"
, "log-logistic"
(default value), "log-normal"
, or "weibull"
is available. The difference between normal and log-normal models or between logistic or log-logistic ones is how the bid variable is incorporated into the model to be estimated. For the Weibull model, the bid variable must be entered in the natural log. Therefore, the user must be careful in defining the model formula that is explained in details below.
A typical structure of the formula for oohbchoice()
is defined as follows:
R1 + R2 ~ (the names of the covariates) | BL + BH
The formula is an object of S3 class Formula
and specifies the model structure. It has to be written in a symbolic expression in R. The formula consists of three parts as follows.
The first part, the left-hand side of the tilde sign (~
), must contain the response variables for the suggested prices in the first and the second stage of CV questions. In the example below, R1
denotes a binary or two-level factor response variable for a bid in the first stage and R2
for a bid in the second stage. R1
contains yes
or no
to the bid in the first stage or 1
for yes
and 0
for no
. R2
contains yes
, no
, none
to the bid in the second stage or 1
for yes
, 0
for no
, and -9
for none
. The value of none
(-9
) means that the respondents have no second stage: the respondents are asked to answer the second stage question only if they satisfy either condition: (a) they answer yes
in the first stage when the lower bid is shown in the first stage, or (b) they answer no
in the first stage when the higher bid is shown in the first stage.
The covariates are defined in the second part of the formula in the place of (the names of the covariates). Each covariate is connected with the arithmetic operator +
and (the names of the covariates) in the above syntax should be replaced with var1 + var2
and the like. The plus sign is nothing to do with addition of the two variables in the symbolic expression. When the covariate contains only a constant term, a value of 1
is set as the covariate: R1 + R2 ~ 1 | BL + BH
(see the examples section below)
The last part of the formula starts after the vertical bar (|
). The names of the two variables (BL
and BH
) containing suggested lower and higher prices in OOHBDC-CV question are specified in this part. The two variables are also connected with the arithmetic operator (+
).
According to the structure of the formula, a data set (data frame) consists of three parts. An example of the data set (first six rows) is as follows (gender
and age
are respondents' characteristics and assumed to be covariates):
id | R1 | R2 | gender | age | BL | BH |
1 | no | none | male | 51 | 2000 | 2500 |
2 | yes | no | male | 30 | 500 | 1000 |
3 | yes | yes | female | 25 | 500 | 1000 |
4 | yes | none | male | 48 | 1000 | 1500 |
5 | no | yes | male | 60 | 1000 | 1500 |
6 | no | no | female | 34 | 2500 | 3000
|
Respondent 1 faced a bid range [2000
, 2500
]; respondents 2 and 3 faced a bid range [500
, 1000
]; respondents 4 and 5 faced a bid range [1000
, 1500
]; and respondent 6 faced [2500
, 3000
]. Respondent 1 answered no
in the first stage of CV question and had no the second stage; respondent 2 answered yes
and no
in the first and second stage, respectively; respondent 3 answered yes
and yes
in the both stages; respondent 4 answered yes
in the first stage and had no the second stage; respondent 5 answered no
and yes
in the first and second stage; and respondent 6 answered no
in the both stages.
Note that BL
and BH
are NOT the first stage bid and the second stage bid, respectively. The function oohbchoice()
understands which bids (BL
and BH
) are presented in the first stage and second stage, respectively, on the basis of values of variables R1
and R2
.
Nonparametric analysis of OOHBDC-CV data can be done by turnbull.oohb
.
The function returns an S3 class object oohbchoice
, which inherits from the S3 class dbchoice
. See dbchoice()
for the details on the S3 object dbchoice
.
We would like to thank Dr. Joseph C. Cooper and Dr. Giovanni Signorello for their kindness.
Cooper JC, Hanemann M, Signorello G (2002). “One-and-one-half-bound dichotomous choice contingent valuation”, The Review of Economics and Statistics, 84, 742–750.
Hanemann WM (1984). “Welfare Evaluations in Contingent Valuation Experiments with Discrete Responses”, American Journal of Agricultural Economics, 66(2), 332–341.
summary.dbchoice
, oohbsyn
, krCI
, bootCI
,
turnbull.oohb
, Formula
## See oohbsyn.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.