standard_statistic_wrapper: Standard statistic wrappers

standard_statistic_wrapperR Documentation

Standard statistic wrappers


Functions to be used within variance estimation wrappers in order to specify which statistic is to be estimated.


total(y, by = NULL, where = NULL)

ratio(num, denom, by = NULL, where = NULL)

mean(y, by = NULL, where = NULL)

diff_of_ratio(num1, denom1, num2, denom2, by = NULL, where = NULL)

ratio_of_ratio(num1, denom1, num2, denom2, by = NULL, where = NULL)



A vector corresponding to the variable to calculate the statitic on. If not numeric (character or factor), it is automatically discretized.


Factor vector (character vectors are coerced to factors) whose levels are used to break down the estimation by domains.


Logical vector indicating the domain to perform variance estimation on.

num, num1, num2

Numerical vector(s) corresponding to the numerator(s) to be used in the estimation.

denom, denom1, denom2

Numerical vector(s) corresponding to the denominator(s) to be used in the estimation.


When the estimator is not the estimator of a total, the application of analytical variance estimation formulae developed for the estimator of a total is not straightforward (Deville, 1999). An asymptotically unbiased variance estimator can nonetheless be obtained if the estimation of variance is performed on a variable obtained from the original data through a linerization step.

The ratio, mean, diff_of_ratio and ratio_of_ratio functions produce the point estimate of the statistic and derive the corresponding linearized variable which is later on passed on to the variance estimation function within the variance estimation wrapper.

Note: The total function does not perform any linearization (as none is needed for the estimator of a total) and solely produces the corresponding point estimator.


Martin Chevalier


Caron N. (1998), "Le logiciel Poulpe : aspects méthodologiques", Actes des Journées de méthodologie statistique

Deville J.-C. (1999), "Variance estimation for complex statistics and estimators: linearization and residual techniques", Survey Methodology, 25:193–203

See Also

define_statistic_wrapper, define_variance_wrapper


# See qvar examples

gustave documentation built on Nov. 17, 2023, 5:10 p.m.