Computes DFBETAS (Difference in BETAS, standardized) for a fitted brma object. DFBETAS measures the influence of each observation on the estimated model coefficients. Positive values indicate that deleting the observation yields a smaller estimate, negative values indicate that deleting the observation yields a larger estimate.
Usage
# S3 method for class 'brma'
dfbetas(
model,
type = "mods",
standardized_coefficients = FALSE,
transform_factors = TRUE,
return_loo_estimates = FALSE,
component = NULL,
parameter = NULL,
...
)Arguments
- model
a fitted brma object.
- type
type of parameters to be summarized. Defaults to
"mods"(for the effect size and meta-regression coefficients). The other options are"scale"(for the heterogeneity and scale-regression coefficients) and"bias"(for omega, PET, and PEESE publication-bias parameters).- standardized_coefficients
whether to show standardized meta-regression and scale-regression coefficients. Defaults to
FALSE. When set toTRUE, standardized coefficients are returned for the intercept and continuous predictors of the location (type = "mods") and scale (type = "scale") formulas. These coefficients correspond to the standardized scale on which prior distributions are specified by default (i.e.,standardize_continuous_predictors = TRUE). Otherwise, the coefficients are returned on the original scale of the predictors.- transform_factors
whether to transform factors to their original names. Defaults to
TRUE.- return_loo_estimates
whether to return the leave-one-out coefficient estimates used to compute DFBETAS instead of standardized DFBETAS values. Defaults to
FALSE.- component
optional parameter namespace. Use
"random"for semantic random-effect SD, correlation, and allocation quantities.- parameter
optional semantic random-effect quantity. When omitted with
component = "random", all available random quantities are returned.- ...
additional arguments (currently ignored).
Value
If return_loo_estimates = FALSE, a data frame with \(K\) rows
(observations) and \(P\) columns (parameters), containing DFBETAS values.
If return_loo_estimates = TRUE, returns the corresponding leave-one-out
coefficient estimates. Row names correspond to study labels (if available)
or indices.
Details
This function computes DFBETAS values using the Leave-One-Out (LOO) approximation based on Pareto Smoothed Importance Sampling (PSIS) weights. Ideally, DFBETAS is defined as: $$DFBETAS_{ij} = \frac{\hat{\beta}_j - \hat{\beta}_{j(-i)}}{SE(\hat{\beta}_{j(-i)})}$$ where \(\hat{\beta}_j\) is the estimate of the \(j\)-th coefficient using the full data, \(\hat{\beta}_{j(-i)}\) is the estimate when observation \(i\) is omitted, and \(SE(\hat{\beta}_{j(-i)})\) is the standard error of the coefficient when observation \(i\) is omitted.
In the Bayesian context using LOO approximation:
\(\hat{\beta}_{j(-i)}\) is estimated as the importance sampling weighted mean of the posterior samples, using PSIS weights \(w_{is}\).
\(SE(\hat{\beta}_{j(-i)})\) is estimated as the importance sampling weighted standard deviation of the posterior samples.
This approximation allows computing influence statistics without refitting
the model \(K\) times, making it computationally efficient.
For brma.mv() objects, DFBETAS use estimate-unit PSIS weights. With
correlated known-V data, this is influence under conditional estimate
deletion, not independent-study deletion.
A requested random-effect correlation must be defined in every posterior
draw. If either SD is zero in some draws, the complete influence request is
unavailable; explicitly select an everywhere-defined quantity with
component = "random" and parameter instead.
For type = "bias", fixed identification parameters (e.g., the reference
\(\omega = 1\) interval) can have zero LOO posterior standard deviation.
These parameters are retained in the output, but their DFBETAS values are
reported as NaN because the standardized diagnostic is undefined.
Note: This function requires that LOO-CV has been computed for the model
using add_loo.