growth(model = NULL, data = NULL, conditional.x = "default", fixed.x = "default", orthogonal = FALSE, std.lv = FALSE, parameterization = "default", std.ov = FALSE, missing = "default", ordered = NULL, sample.cov = NULL, sample.cov.rescale = "default", sample.mean = NULL, sample.nobs = NULL, ridge = 1e-05, group = NULL, group.label = NULL, group.equal = "", group.partial = "", group.w.free = FALSE, cluster = NULL, constraints = '', estimator = "default", likelihood = "default", link = "default", information = "default", se = "default", test = "default", bootstrap = 1000L, mimic = "default", representation = "default", do.fit = TRUE, control = list(), WLS.V = NULL, NACOV = NULL, zero.add = "default", zero.keep.margins = "default", zero.cell.warn = TRUE, start = "default", check = c("start", "post"), verbose = FALSE, warn = TRUE, debug = FALSE)
model.syntax
for more information. Alternatively, a
parameter table (eg. the output of the lavaanify()
function) is also
accepted.TRUE
, we set up the model conditional on
the exogenous `x' covariates; the model-implied sample statistics
only include the non-x variables. If FALSE
, the exogenous `x'
variables are modeled jointly with the other variables, and the
model-implied statistics refect both sets of variables. If
"default"
, the value is set depending on the estimator, and
whether or not the model involves categorical endogenous variables.TRUE
, the exogenous `x' covariates are considered
fixed variables and the means, variances and covariances of these variables
are fixed to their sample values. If FALSE
, they are considered
random, and the means, variances and covariances are free parameters. If
"default"
, the value is set depending on the mimic option.TRUE
, the exogenous latent variables
are assumed to be uncorrelated.TRUE
, the metric of each latent variable is
determined by fixing their (residual)
variances to 1.0. If FALSE
, the metric
of each latent variable is determined by fixing the factor loading of the
first indicator to 1.0."delta"
, the delta parameterization is used. If "theta"
,
the theta parameterization is used.TRUE
, all observed variables are standardized
before entering the analysis."listwise"
, cases with missing values are removed
listwise from the data frame before analysis. If "direct"
or
"ml"
or "fiml"
and the estimator is maximum likelihood,
Full Information Maximum Likelihood (FIML) estimation is used using all
available data in the data frame. This is only valid if the data are
missing completely at random (MCAR) or missing at random (MAR). If
"default"
, the value is set depending on the estimator and the
mimic option.likelihood="normal"
, the user provided covariance matrix is
internally rescaled by multiplying it with a factor (N-1)/N, to ensure
that the covariance matrix has been divided by N. This can be turned off
by setting the sample.cov.rescale
argument to FALSE
.TRUE
, the sample covariance matrix provided
by the user is internally rescaled by multiplying it with a factor (N-1)/N.
If "default"
, the value is set depending on the estimator and the
likelihood option: it is set to TRUE
if maximum likelihood
estimation is used and likelihood="normal"
, and FALSE
otherwise.NULL
(the default), all grouping levels are selected, in the
order as they appear in the data."loadings"
, "intercepts"
, "means"
,"thresholds"
,
"regressions"
, "residuals"
,
"residual.covariances"
, "lv.variances"
or
"lv.covariances"
, specifying the pattern of equality
constraints across multiple groups.TRUE
, the group frequencies are
considered to be free parameters in the model. In this case, a
Poisson model is fitted to estimate the group frequencies. If
FALSE
(the default), the group frequencies are fixed to their
observed values.model.syntax
for more information."ML"
for maximum likelihood, "GLS"
for generalized least
squares, "WLS"
for weighted least squares (sometimes called ADF
estimation), "ULS"
for unweighted least squares and "DWLS"
for
diagonally weighted least squares. These are the main options that affect
the estimation. For convenience, the "ML"
option can be extended
as "MLM"
, "MLMV"
, "MLMVS"
, "MLF"
, and
"MLR"
. The estimation will still be plain "ML"
, but now
with robust standard errors and a robust (scaled) test statistic. For
"MLM"
, "MLMV"
, "MLMVS"
, classic robust standard
errors are used (se="robust.sem"
); for "MLF"
, standard
errors are based on first-order derivatives (se="first.order"
);
for "MLR"
, `Huber-White' robust standard errors are used
(se="robust.huber.white"
). In addition, "MLM"
will compute
a Satorra-Bentler scaled (mean adjusted) test statistic
(test="satorra.bentler"
) , "MLMVS"
will compute a
mean and variance adjusted test statistic (Satterthwaite style)
(test="mean.var.adjusted"
), "MLMV"
will compute a mean
and variance adjusted test statistic (scaled and shifted)
(test="scaled.shifted"
), and "MLR"
will
compute a test statistic which is asymptotically
equivalent to the Yuan-Bentler T2-star test statistic. Analogously,
the estimators "WLSM"
and "WLSMV"
imply the "DWLS"
estimator (not the "WLS"
estimator) with robust standard errors
and a mean or mean and variance adjusted test statistic. Estimators
"ULSM"
and "ULSMV"
imply the "ULS"
estimator with robust standard errors
and a mean or mean and variance adjusted test statistic."wishart"
,
the wishart likelihood approach is used. In this approach, the covariance
matrix has been divided by N-1, and both standard errors and test
statistics are based on N-1.
If "normal"
, the normal likelihood approach is used. Here,
the covariance matrix has been divided by N, and both standard errors
and test statistics are based on N. If "default"
, it depends
on the mimic option: if mimic="lavaan"
or mimic="Mplus"
,
normal likelihood is used; otherwise, wishart likelihood is used."logit"
,
a logit link is used for binary and ordered observed variables.
If "probit"
, a probit link is used. If "default"
,
it is currently set to "probit"
(but this may change)."expected"
, the expected information matrix
is used (to compute the standard errors). If "observed"
, the
observed information matrix is used. If "default"
, the value is
set depending on the estimator and the mimic option."standard"
, conventional standard errors
are computed based on inverting the (expected or observed) information
matrix. If "first.order"
, standard errors are computed based on
first-order derivatives. If "robust.sem"
, conventional robust
standard errors are computed. If "robust.huber.white"
,
standard errors are computed based on the `mlr' (aka pseudo ML,
Huber-White) approach.
If "robust"
, either "robust.sem"
or
"robust.huber.white"
is used depending on the estimator,
the mimic option, and whether the data are complete or not.
If "boot"
or "bootstrap"
, bootstrap standard errors are
computed using standard bootstrapping (unless Bollen-Stine bootstrapping
is requested for the test statistic; in this case bootstrap standard
errors are computed using model-based bootstrapping).
If "none"
, no standard errors are computed."standard"
, a conventional chi-square test is computed.
If "Satorra.Bentler"
, a Satorra-Bentler scaled test statistic is
computed. If "Yuan.Bentler"
, a Yuan-Bentler scaled test statistic
is computed. If "mean.var.adjusted"
or "Satterthwaite"
, a
mean and variance adjusted test statistic is compute.
If "scaled.shifted"
, an alternative mean and variance adjusted test
statistic is computed (as in Mplus version 6 or higher).
If "boot"
or "bootstrap"
or
"Bollen.Stine"
, the Bollen-Stine bootstrap is used to compute
the bootstrap probability value of the test statistic.
If "default"
, the value depends on the
values of other arguments."Mplus"
, an attempt is made to mimic the Mplus
program. If "EQS"
, an attempt is made to mimic the EQS program.
If "default"
, the value is (currently) set to to "lavaan"
,
which is very close to"Mplus"
."LISREL"
the classical LISREL matrix
representation is used to represent the model (using the all-y variant)."WLS"
;
if the estimator is "DWLS"
, only the diagonal of this matrix will be
used. For a multiple group analysis, a list with a weight matrix
for each group. The elements of the weight matrix should be in the
following order (if all data is continuous): first the means (if a
meanstructure is involved), then the lower triangular elements of the
covariance matrix including the diagonal, ordered column by column. In
the categorical case: first the thresholds (including the means for
continuous variables), then the slopes (if any), the variances of
continuous variables (if any), and finally the lower triangular elements
of the correlation/covariance matrix excluding the diagonal, ordered
column by column.WLS.V
argument for information about the order of the elements."default"
, the value is set depending on the "mimic"
option. By default, lavaan uses zero.add = c(0.5. 0.0)
.TRUE
, the other values of the
frequency table are adjusted so that all margins are unaffected. If
"default"
, the value is set depending on the "mimic"
. The
default is TRUE
.TRUE
, give a warning if one or more cells
of a bivariate frequency table are empty."simple"
and "Mplus"
.
In the first
case, all parameter values are set to zero, except the factor loadings
(set to one), the variances of latent variables (set to 0.05), and
the residual variances of observed variables (set to half the observed
variance).
If "Mplus"
, we use a similar scheme, but the factor loadings are
estimated using the fabin3 estimator (tsls) per factor.
If start
is a fitted
object of class lavaan
, the estimated values of
the corresponding parameters will be extracted. If it is a model list,
for example the output of the paramaterEstimates()
function,
the values of the est
or start
or ustart
column
(whichever is found first) will be extracted.FALSE
, the model is not fit, and the current
starting values of the model parameters are preserved."nlminb"
. See the manpage of
nlminb
for an overview of the control parameters.
A different optimizer can be chosen by setting the value of
optim.method
. For unconstrained optimization (the model syntax
does not include any "==", ">" or "<" operators),="" the="" available="" options="" are="" "nlminb" (the default), "BFGS"
and
"L-BFGS-B"
. See the manpage of the optim
function for
the control parameters of the latter two options. For constrained
optimization, the only available option is "nlminb.constr"
.">
check
includes "start"
,
the starting values are checked for possibly inconsistent values (for
example values implying correlations larger than one);
if check
includes "post"
, a check is performed after
(post) fitting, to check if the solution is admissable.TRUE
, the function value is printed out during
each iteration.TRUE
, some (possibly harmless) warnings are printed
out during the iterations.TRUE
, debugging information is printed out.lavaan
, for which several methods
are available, including a summary
method.
growth
function is a wrapper for the more general
lavaan
function, using the following default arguments:
meanstructure = TRUE
,
int.ov.free = FALSE
, int.lv.free = TRUE
,
auto.fix.first = TRUE
(unless std.lv = TRUE
),
auto.fix.single = TRUE
, auto.var = TRUE
,
auto.cov.lv.x = TRUE
,
auto.th = TRUE
, auto.delta = TRUE
,
and auto.cov.y = TRUE
.
lavaan
## linear growth model with a time-varying covariate
model.syntax <- '
# intercept and slope with fixed coefficients
i =~ 1*t1 + 1*t2 + 1*t3 + 1*t4
s =~ 0*t1 + 1*t2 + 2*t3 + 3*t4
# regressions
i ~ x1 + x2
s ~ x1 + x2
# time-varying covariates
t1 ~ c1
t2 ~ c2
t3 ~ c3
t4 ~ c4
'
fit <- growth(model.syntax, data=Demo.growth)
summary(fit)
Run the code above in your browser using DataLab