HN_accuracy: Sensitivity-based identification and classification of...

Description Usage Arguments Details Value References See Also Examples

View source: R/HN_accuracy.R

Description

This function implements the algorithm for sensitivity-based identification and classification of inaccurate half-normal heterogeneity priors proposed in Ott et al. (2021). It classifies the specified half-normal heterogeneity prior as either anticonservative (puts more than half of its probability mass on too small heterogeneity values) or conservative (puts more than half of its probability mass on too large heterogeneity values). Assumes a Bayesian normal-normal hierarchical model.

Usage

1
2
HN_accuracy(df, scale.HN = 0.5, mu.mean = 0, mu.sd = 4, 
            tail.prob = 0.5, grid.epsilon = 0.00354)

Arguments

df

data frame with one column "y" containing the effect estimates for the individual studies and a column "sigma" containing the standard errors of these estimates

scale.HN

scale parameter of the half-normal prior of interest. Defaults to 0.5.

mu.mean

mean of the normal prior for the effect mu. Defaults to 0.

mu.sd

standard deviation of the normal prior for the effect mu. Defaults to 4.

tail.prob

probability mass of the prior above the reference threshold. Defaults to 0.5, which corresponds to the 50%-RLMC-based adjustment of priors.

grid.epsilon

value for epsilon, a tuning parameter for epsilon-local sensitivity computation (see pri_par_epsilon_grid for details). Defaults to 0.00354.

Details

This algorithm proceeds as follows: First, it computes the effective median RLMC for the half-normal prior with scale parameter scale.HN and the data set df. Second, it applies the 50%-RLMC-based adjustment to obtain a HC prior with the same median RLMC for the data set df. Third, it computes epsilon-local sensitivity estimates for these two HN and HC priors and the data set df. Finally, comparing the two sensitivity estimates leads to the decision: If the sensitivity estimate for the HN prior is larger than the sensitivity estimate for the HC prior, then both the HN and HC prior are classfied as anticonservative. If the sensitivity estimate for the HC prior is larger than the sensitivity estimate for the HN prior, then both the HN and HC prior are classfied as conservative.

This is a special case of the algorithm described in Ott et al. (2021, Section 5), see also the Supplementary Material of that manuscript (Section 4.6) for more information.

The default value 0.5 of scale.HN, the scale parameter of the HN heterogeneity prior, is recommended in Bender et al. (2018) for the meta-analysis of a small number of small studies.

Value

A list of the following 4 elements:

param

a list of the following two scale parameter values (non-negative real numbers):
HN: scale parameter of the specified HN prior
HC: scale parameter of the adjusted HC prior

mrlmc_HN

the effective median RLMC for the specified HN prior. Real number in [0, 1].

S_tau

a list of the following two epsilon-local sensitivity estimates with respect to the heterogeneity parameter tau:
`S(tau)^HN`: sensitivity estimate for the HN prior
`S(tau)^HC`: sensitivity estimate for the HC prior

decision

a string specifiying the decision if the HN and HC priors are anticonservative or conservative

References

Ott, M., Hunanyan, S., Held, L., Roos, M. Sensitivity-based identification of inaccurate heterogeneity priors in Bayesian meta-analysis. Submitted to Statistical Methods in Medical Research. 2021.

Ott, M., Hunanyan, S., Held, L., Roos, M. Supplementary Material: Sensitivity-based identification of inaccurate heterogeneity priors in Bayesian meta-analysis. Submitted to Statistical Methods in Medical Research. 2021.

Bender, R., Friede, T., Koch, A., Kuss, O., Schlattmann, P., Schwarzer, G., Skipka, G. (2018). Methods for evidence synthesis in the case of very few studies. Research Synthesis Methods 9(3)), 382–392. https://doi.org/10.1002/jrsm.1297

See Also

HC_accuracy, prior_accuracy, effective_rlmc, pri_par_adjust

Examples

1
2
3
4
5
6
7
# load the steriod-resistant rejection (SRR) data analyzed in Friede et al. (2017)
data(srr)

# sensitivity-based accuracy estimation & classification for
# the HN(0.5) prior and the SRR data
HN_accuracy(df = srr, scale.HN = 0.5,
            mu.mean = 0, mu.sd = 4)

pa4bayesmeta documentation built on Aug. 1, 2021, 3 p.m.