bench {hbsae} | R Documentation |
Benchmark small area estimates.
Description
Benchmark small area estimates to conform to given totals at aggregate levels.
Usage
bench(x, R, rhs, mseMethod = "no", Omega, Lambda)
Arguments
x |
sae object to be benchmarked. As an alternative, a list can be supplied with at least components |
R |
restriction matrix, M x r matrix where r is the number of restrictions and M the number of areas; default is a single constraint on the population total.
Note that |
rhs |
r-vector of benchmark totals corresponding to the restrictions represented by (the columns of) |
mseMethod |
if |
Omega |
M x M matrix |
Lambda |
r x r matrix |
Details
This function adjusts the small area estimates EST(x)
, denoted by , to
where
-
is a symmetric M x M matrix. By default,
is taken to be the covariance matrix
of the input sae-object
x
. -
where
is the matrix passed to
bench
anddenotes the population size of the
th area, is a M x r matrix describing the aggregate level relative to the area level. Note that the matrix
acts on the vector of area totals whereas
acts on the area means to produce the aggregate totals. The default for
is a column vector of 1s representing an additivity constraint to the overall population total.
-
is an r-vector of aggregate-level totals, specified as
rhs
, that the small area estimates should add up to. -
is a symmetric r x r matrix controlling the penalty associated with deviations from the constraints
. The default is
, implying that the constraints must hold exactly.
The adjusted or benchmarked small area estimates minimize the expectation of the loss function
with respect to the posterior for the unknown small area means .
Optionally, MSE(x)
is updated as well. If mseMethod="exact"
the covariance matrix is adjusted from
to
and if mseMethod
is "model"
the adjusted covariance matrix is
The latter method treats the benchmark adjustments as incurring a bias relative to the best predictor under the model.
Value
An object of class sae
with adjusted estimates.
References
G.S. Datta, M. Ghosh, R. Steorts and J. Maples (2011). Bayesian benchmarking with applications to small area estimation. TEST 20(3), 574-588.
Y. You, J.N.K. Rao and P. Dick (2004). Benchmarking Hierarchical Bayes Small Area Estimators in the Canadian Census Undercoverage Estimation. Statistics in Transition 6(5), 631-640.
See Also
Examples
d <- generateFakeData()
# compute small area estimates
sae <- fSAE(y0 ~ x + area2, data=d$sam, area="area", popdata=d$Xpop)
# calibrate to overall population total
sae.c <- bench(sae, rhs=sum(d$mY0*sae$Narea))
plot(sae, sae.c)