WeightsCalDF {Frames2}R Documentation

g-weights for the dual frame calibration estimator

Description

Computes the g-weights for the dual frame calibration estimator.

Usage

WeightsCalDF(ysA, ysB, pi_A, pi_B, domains_A, domains_B, N_A = NULL, N_B = NULL, 
N_ab = NULL, xsAFrameA = NULL, xsBFrameA = NULL, xsAFrameB = NULL, xsBFrameB = NULL, 
xsT = NULL, XA = NULL, XB = NULL, X = NULL, met = "linear")

Arguments

ysA

A numeric vector of length nAn_A or a numeric matrix or data frame of dimensions nAn_A x cc containing information about variable(s) of interest from sAs_A.

ysB

A numeric vector of length nBn_B or a numeric matrix or data frame of dimensions nBn_B x cc containing information about variable(s) of interest from sBs_B.

pi_A

A numeric vector of length nAn_A or a square numeric matrix of dimension nAn_A containing first order or first and second order inclusion probabilities for units included in sAs_A.

pi_B

A numeric vector of length nBn_B or a square numeric matrix of dimension nBn_B containing first order or first and second order inclusion probabilities for units included in sBs_B.

domains_A

A character vector of length nAn_A indicating the domain each unit from sAs_A belongs to. Possible values are "a" and "ab".

domains_B

A character vector of length nBn_B indicating the domain each unit from sBs_B belongs to. Possible values are "b" and "ba".

N_A

(Optional) A numeric value indicating the size of frame A.

N_B

(Optional) A numeric value indicating the size of frame B.

N_ab

(Optional) A numeric value indicating the size of the overlap domain.

xsAFrameA

(Optional) A numeric vector of length nAn_A or a numeric matrix or data frame of dimensions nAn_A x mAm_A, with mAm_A the number of auxiliary variables in frame A, containing auxiliary information in frame A for units included in sAs_A.

xsBFrameA

(Optional) A numeric vector of length nBn_B or a numeric matrix or data frame of dimensions nBn_B x mAm_A, with mAm_A the number of auxiliary variables in frame A, containing auxiliary information in frame A for units included in sBs_B. For units in domain bb, these values are 0.

xsAFrameB

(Optional) A numeric vector of length nAn_A or a numeric matrix or data frame of dimensions nAn_A x mBm_B, with mBm_B the number of auxiliary variables in frame B, containing auxiliary information in frame B for units included in sAs_A. For units in domain aa, these values are 0.

xsBFrameB

(Optional) A numeric vector of length nBn_B or a numeric matrix or data frame of dimensions nBn_B x mBm_B, with mBm_B the number of auxiliary variables in frame B, containing auxiliary information in frame B for units included in sBs_B.

xsT

(Optional) A numeric vector of length nn or a numeric matrix or data frame of dimensions nn x mTm_T, with mTm_T the number of auxiliary variables in both frames, containing auxiliary information for all units in the entire sample s=sAsBs = s_A \cup s_B.

XA

(Optional) A numeric value or vector of length mAm_A, with mAm_A the number of auxiliary variables in frame A, indicating the population totals for the auxiliary variables considered in frame A.

XB

(Optional) A numeric value or vector of length mBm_B, with mBm_B the number of auxiliary variables in frame B, indicating the population totals for the auxiliary variables considered in frame B.

X

(Optional) A numeric value or vector of length mTm_T, with mTm_T the number of auxiliary variables in both frames, indicating the population totals for the auxiliary variables considered in both frames.

met

(Optional) A character vector indicating the distance that must be used in calibration process. Possible values are "linear", "raking" and "logit". Default is "linear".

Details

Function provides g-weights in following scenarios:

Value

A numeric vector containing the g-weights for the dual frame calibration estimator.

References

Ranalli, M. G., Arcos, A., Rueda, M. and Teodoro, A. (2013) Calibration estimationn in dual frame surveys. arXiv:1312.0761 [stat.ME]

Deville, J. C., S\"arndal, C. E. (1992) Calibration estimators in survey sampling. Journal of the American Statistical Association, 87, 376 - 382

Examples

data(DatA)
data(DatB)
data(PiklA)
data(PiklB)

#Let calculate g-weights for the dual frame calibration estimator for variable Feeding, 
#without considering any auxiliary information
WeightsCalDF(DatA$Feed, DatB$Feed, PiklA, PiklB, DatA$Domain, DatB$Domain)

#Now, let calculate g-weights for the dual frame calibration estimator for variable Clothing 
#when the frame sizes and the overlap domain size are known
WeightsCalDF(DatA$Clo, DatB$Clo, PiklA, PiklB, DatA$Domain, DatB$Domain, 
N_A = 1735, N_B = 1191, N_ab = 601)

#Finally, let calculate g-weights for the dual frame calibration estimator
#for variable Feeding, considering Income as auxiliary variable in frame A
#and Metres2 as auxiliary variable in frame B and with frame sizes and overlap 
#domain size known.
WeightsCalDF(DatA$Feed, DatB$Feed, PiklA, PiklB, DatA$Domain, DatB$Domain, 
N_A = 1735, N_B =  1191, N_ab = 601, xsAFrameA = DatA$Inc, xsBFrameA = DatB$Inc, 
xsAFrameB = DatA$M2, xsBFrameB = DatB$M2, XA = 4300260, XB = 176553)

[Package Frames2 version 0.2.1 Index]