- resp_name
Character string giving the name of the observed response variable in
data. The response must be numeric and coded with consecutive
integer categories 1, ..., c, where c is the number of
response categories, with no missing categories.
- formula
A one-sided formula specifying the covariates in the transition model,
for example ~ gender + race + education + age_c. An intercept
should be included. If formula_init is NULL, the same
covariates are used for the initial latent-state probabilities.
- k
Positive integer giving the number of latent states. A one-state model is
allowed; in that case only the response probabilities and fit criteria are
estimated, and the arguments formula, formula_init,
baseline, model_int and model_cov have no effect.
- data
Data frame in long format. The first column is used as the subject
identifier and the second as the measurement occasion, irrespective of
their names. Subject identifiers must be consecutive integers, records
must be ordered by subject and occasion, and occasions for each subject
must be consecutive and start at 1. Individual trajectories may have
different lengths. Rows with missing values in the response or model
variables should be removed before fitting.
- reltol
Positive numeric value giving the relative log-likelihood tolerance used
to stop the EM algorithm. Iteration stops when the relative increment in
log-likelihood is no greater than reltol.
- rand.start
Logical value controlling initialization when nstart = 1. If
FALSE, the initial latent allocation is obtained by k-means
clustering of the response. If TRUE, a random latent allocation is
used. Components supplied in par.init override the corresponding
internally generated starting values.
- nstart
Positive integer giving the number of fits from different starting
values. If greater than 1, the first fit uses the k-means initialization
and the remaining fits use random initial allocations; the fit with the
largest log-likelihood is returned.
- baseline
Character string specifying the reference category in the multinomial
logit parameterization for the transition probabilities. With "initial",
the transition towards the first state is used as the reference category
for each row of the transition matrix. With "central", the self-transition
is used as the reference category for each row of the transition matrix.
- model_int
Character string specifying the equality-constraint structure for the
transition-logit intercepts. Available choices are "all",
"const", "dist1", "dist2", "dist3",
"two", "symm", "rsymm", and "diff".
See Details and design_matrices.
- model_cov
Character string specifying the equality-constraint structure for the
transition-logit regression coefficients. The available choices are the
same as for model_int. See Details and
design_matrices.
- formula_init
Optional one-sided formula specifying the covariates for the initial
latent-state probabilities. Only measurements at occasion 1 are used. If
NULL, formula is also used for this submodel. Use ~ 1
for an intercept-only initial-probability model.
- par.init
Named list of optional starting values. Component la contains the
coefficients for the initial-probability logits; psi contains the
reduced parameter vector for the constrained transition logits; and
Pr is a k by c matrix of conditional response
probabilities. Any component may be left NULL to use an internally
generated starting value.
- output
Logical value. If TRUE, the fitted subject-specific initial
probabilities Piv and transition probabilities PI are
returned in addition to the main estimation results.
- fort
Logical value selecting the numerical implementation. If TRUE, the
compiled Fortran routines are used and must be available and loaded. If
FALSE, the corresponding R routines are used.