oohbchoice {DCchoice}  R Documentation 
Parametric approach to analyze oneandonehalfbound dichotomous choice contingent valuation data
Description
This function analyzes oneandonehalfbound dichotomous choice contingent valuation (CV) data on the basis of the utility difference approach.
Usage
oohbchoice(formula, data, subset, na.action = na.omit, dist = "loglogistic",
par = NULL, ...)
Arguments
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. 
Details
Oneandonehalfbound dichotomous choice contingent valuation (OOHBDCCV), which was developed by Cooper et al. (2002), is an intermediate CV format between singlebounded dichotomous choice (SBDC) CV format and doublebounded dichotomous choice (DBDC) CV format.
On the basis of an example of environmental valuation study, we will explain differences in question format among SBDCCV, DBDCCV, and OOHBDCCV 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 SBDCCV 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 SBDCCV 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 DBDCCV survey, the CV question consists of two stages: after answering the SBDCCV style question mentioned above (the first stage), the respondents are also asked to answer an additional SBDCCV 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 DBDCCV survey: "yesyes" ("yes" in the both stages), "yesno" ("yes" and "no" in the first and second stages, respectively), "noyes" ("no" and "yes" in the first and second stages, respectively), and "nono" ("no" in the both stages).
In the OOHBDCCV survey, after answering the first SBDCCV style question (the first stage), only respondents who satisfy certain conditions are requested to answer an additional SBDCCV style question (the second stage). Details in the OOHBDCCV 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 OOHBDCCV survey: "no", "yesno", and "yesyes" when the lower bid is shown in the first stage; and "yes", "noyes", and "nono" when the higher bid is shown in the first stage. Refer to Cooper et al. (2002) for detailed explanation of OOHBDCCV, including the example CV questions.
The function oohbchoice()
implements an analysis of OOHBDCCV 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 willingnesstopays (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 = "loglogistic")
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"
, "loglogistic"
(default value), "lognormal"
, or "weibull"
is available. The difference between normal and lognormal models or between logistic or loglogistic 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 lefthand 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 twolevel 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 OOHBDCCV 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 OOHBDCCV data can be done by turnbull.oohb
.
Value
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
.
Acknowledgments
We would like to thank Dr. Joseph C. Cooper and Dr. Giovanni Signorello for their kindness.
References
Cooper JC, Hanemann M, Signorello G (2002). “Oneandonehalfbound 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.
See Also
summary.dbchoice
, oohbsyn
, krCI
, bootCI
,
turnbull.oohb
, Formula
Examples
## See oohbsyn.