mphase.gain: mphase.gain

Description Usage Arguments Value Note

View source: R/mphasegain.R

Description

mphase.gain takes as input an object created by the estTable function and returns a validation of which multiphase method and estimator performed best in comparison to the onephase estimation (baseline) in terms of estimation precision.

Usage

1
mphase.gain(esttable.obj, pref.vartype = "g_variance", exclude.synth = TRUE)

Arguments

esttable.obj

an object of class esttable created by the estTable function

pref.vartype

preferred type of multiphase variance that should be compared to the onephase variance, if more then one variance type has been calculated in the multiphase estimation object(s) stored in esttable. Valid input values are "g_variance" (default) and "ext_variance".

exclude.synth

logical. If set to TRUE (default), synthetic estimations are not considered in the validation.

Value

mphase.gain returns a data.frame containing the following components:

Note

The gain can be interpreted as: "The multiphase estimation procedure leads to a gain % reduction in variance compared to the onephase procedure".

The relative efficiency can be interpreted as: "Using the onephase estimation procedure, the terrestrial sample size would have to be rel.eff times larger in order to achieve the same precision (in terms of variance) as the mutiphase estimation procedure".


forestinventory documentation built on Jan. 13, 2021, 9:11 p.m.