validateInputR Documentation

validateInput

Description

Validates input for power functions.

Usage

validateInput(
  power.type = NULL,
  effect = NULL,
  effect.measure = NULL,
  alpha = NULL,
  beta = NULL,
  power = NULL,
  abratio = NULL,
  N = NULL,
  df = NULL,
  p = NULL,
  SigmaHat = NULL,
  Sigma = NULL,
  muHat = NULL,
  mu = NULL,
  fittingFunction = "ML",
  simulatedPower = FALSE,
  modelH0 = NULL,
  power.min = alpha,
  power.max = 0.999,
  effect.min = NULL,
  effect.max = NULL,
  steps = 50,
  linewidth = 1
)

Arguments

power.type

type of power analyses, one of "a-priori", "post-hoc", "compromise", "powerplot.byN", "powerplot.byEffect"

effect

effect size specifying the discrepancy between H0 and H1

effect.measure

type of effect, one of "F0", "RMSEA", "Mc", "GFI", "AGFI"

alpha

alpha error

beta

beta error

power

power (= 1 - beta)

abratio

ratio alpha/beta

N

the number of observations

df

the model degrees of freedom

p

the number of observed variables, required for effect.measure = "GFI" and effect.measure = "AGFI"

SigmaHat

model implied covariance matrix

Sigma

observed (or population) covariance matrix

muHat

model implied mean vector

mu

observed (or population) mean vector

fittingFunction

whether to use ML (the default) or WLS

simulatedPower

whether to perform a simulated (TRUE) (rather than analytical, FALSE) power analysis.

modelH0

for simulated power: lavaan model string defining the (incorrect) analysis model.

power.min

for plotting: minimum power

power.max

for plotting: maximum power

effect.min

for plotting: minimum effect

effect.max

for plotting: maximum effect

steps

for plotting: number of sampled points

linewidth

for plotting: linewidth