print.eba: Print Extreme Bounds Analysis Results

View source: R/ExtremeBounds.R

print.ebaR Documentation

Print Extreme Bounds Analysis Results

Description

hist.eba prints the results of extreme bounds analysis (EBA; performed by the eba function) and returns the printed object invisibly (via invisible(x)). The function prints out information about the distribution and significance of estimated regression coefficients, the results of Leamer's EBA, as well as those of Sala-i-Martin's EBA (both the normal and generic model).

Usage

## S3 method for class 'eba'
print(x, digits = 3, ...) 

Arguments

x

an object of class "eba", typically generated by the eba function.

digits

number of decimal places to which the output will be rounded.

...

further arguments passed to print.default and print.data.frame functions within print.eba.

Output

print.eba prints the following information in its output:

  • Call: the matched call (based on x$call).

  • Confidence level: the confidence level for hypothesis testing (x$level).

  • Number of combinations: the total number of doubtful variable combinations that contain at least one focus variable (x$ncomb).

  • Regressions estimated: the number of regressions that were estimated in the course of EBA (x$nreg). When no random sampling of regression models was requested (i.e., when eba's argument draws is NULL), the number of combinations (above) will equal the number of regressions estimated.

  • Number of regressions by variable: the number of regressions estimated, by variable (x$nreg.variable).

  • Number of coefficients used by variable: the number of coefficients used in the extreme bounds analysis, by variable (x$ncoef.variable).

Beta coefficients:

  • Coef (Wgt Mean): the weighted mean of the estimated regression coefficients. Individual regression models receive a weight specified by eba's argument weights.

  • SE (Wgt Mean): the weighted mean of the standard errors on estimated regression coefficients. Individual regression models receive a weight specified by eba's argument weights.

  • Min Coef and SE (Min Coef): the value of the lowest regression coefficient across the estimated models and the corresponding standard error.

  • Max Coef and SE (Max Coef): the value of the highest regression coefficient across the estimated models and the corresponding standard error.

Distribution of beta coefficients:

  • Pct(beta < mu): proportion of estimated regression coefficients whose value is less than mu.

  • Pct(beta > mu): proportion of estimated regression coefficients whose value is greater than mu.

  • Pct(significant != mu): proportion of regression models in which the estimated coefficient is statistically significantly different from mu.

  • Pct(signif & beta < mu): proportion of estimated regression coefficients that are both statistically significantly different from and whose value is less than mu.

  • Pct(signif & beta > mu): proportion of estimated regression coefficients that are both statistically significantly different from and whose value is greater than mu.

Leamer's Extreme Bounds Analysis (EBA):

  • Lower Extreme Bound: Leamer's lower extreme bound at the specified confidence level.

  • Upper Extreme Bound: Leamer's upper extreme bound at the specified confidence level.

  • Robust/Fragile?: a character string indicating whether the variable is robust or fragile based on Leamer's extreme bounds analysis.

Sala-i-Martin's Extreme Bounds Analysis (EBA):

  • N: CDF(beta <= 0): the value of the cumulative density function at CDF(mu) - i.e., the proportion of coefficients that are estimated to be lower or equal to mu - based on Sala-i-Martin's EBA that assumes that regression coefficients are normally distributed across the estimated models. Weights specified by eba's argument weights are applied.

  • N: CDF(beta > 0): the proportion of coefficients that are estimated to be greater than mu, based on Sala-i-Martin's EBA that assumes that regression coefficients are normally distributed across the estimated models. Weights specified by eba's argument weights are applied.

  • G: CDF(beta <= 0): the value of the cumulative density function at CDF(mu) based on Sala-i-Martin's EBA that does not assume any particular distribution of regression coefficients across the estimated models. Weights specified by eba's argument weights are applied.

  • G: CDF(beta > 0): the proportion of coefficients that are estimated to be greater than mu, based on Sala-i-Martin's EBA that does not assume any particular distribution of regression coefficients across the estimated models. Weights specified by eba's argument weights are applied.

Note that all values of cumulative density functions for Sala-i-Martin's EBA are printed as percentages.

Please cite as:

Hlavac, Marek (2016). ExtremeBounds: Extreme Bounds Analysis in R. Journal of Statistical Software, 72(9), 1-22. doi: 10.18637/jss.v072.i09.

Author(s)

Marek Hlavac < mhlavac at alumni.princeton.edu >
Research Fellow, Central European Labour Studies Institute (CELSI), Bratislava, Slovakia

See Also

eba, hist.eba

Examples

# perform Extreme Bounds Analysis

eba.results <- eba(formula = mpg ~ wt | hp + gear | cyl + disp + drat + qsec + vs + am + carb,
                   data = mtcars[1:10, ], k = 0:2)

# The same result can be achieved by running:
# eba.results <- eba(data = mtcars[1:10, ], y = "mpg", free = "wt",
#                    doubtful = c("cyl","disp","hp","drat","qsec","vs","am","gear","carb"),
#                    focus = c("hp","gear"), k = 0:2)

# print out results, rounded to 2 decimal places
print(eba.results, digits = 2)



ExtremeBounds documentation built on July 9, 2023, 6:32 p.m.