Estimate test power from observed effect size

Source: R/bootstrap_methods.R · Help: ?restimate_test_power

Uses the observed chi-squared statistic and effect size to approximate the achieved power of a heteroscedasticity test and to suggest an increased sample size required to attain the desired power threshold.

Usage

restimate_test_power(
  test_result,
  model,
  data,
  alpha = 0.05,
  target_power = 0.8,
  max_multiplier = 5
)

Arguments

test_result

An object returned by perform*Test() functions with statistic and parameter components.

model

Fitted model used in the diagnostic.

data

Data frame supplied to the diagnostic.

alpha

Significance level used in the test. Defaults to 0.05.

target_power

Desired minimum power for the recommendation.

max_multiplier

Upper bound multiplier relative to the observed sample size when searching for the recommended sample size.

Value

A list with elements power, recommended_n, and details containing auxiliary information (degrees of freedom, non-centrality parameter, and a power curve over a grid of effect sizes).

Deprecated

Deprecated since 0.14.0: an internal helper of the package, which leaves the exports in 1.0.0. It still works and warns.