getUNI.initial: Compute Initial Values for Parameters of Latent Growth Curve...

View source: R/UNI.initial_helper.R

getUNI.initialR Documentation

Compute Initial Values for Parameters of Latent Growth Curve Models or Latent Change Score Models with Time-invariant Covariates (If Any)

Description

This function computes the initial values of the parameters for a latent growth curve model or a latent change score model with time-invariant covariates (if any).

Usage

getUNI.initial(dat, t_var, y_var, curveFun, records, growth_TIC, res_scale)

Arguments

dat

A wide-format data frame, with each row corresponding to a unique ID. It contains the observed variables with repeated measurements and occasions, and time-invariant covariates (TICs) if any. It takes the value passed from getLGCM() or getLCSM().

t_var

A string specifying the prefix of the column names corresponding to the time variable at each study wave. It takes the value passed from getLGCM() or getLCSM().

y_var

A string specifying the prefix of the column names corresponding to the outcome variable at each study wave. It takes the value passed from getLGCM() or getLCSM().

curveFun

A string specifying the functional form of the growth curve. Supported options for latent growth curve models include: "linear" (or "LIN"), "quadratic" (or "QUAD"), "negative exponential" (or "EXP"), "Jenss-Bayley" (or "JB"), and "bilinear spline" (or "BLS"). Supported options for latent change score models include: "quadratic" (or "QUAD"), "negative exponential" (or "EXP"), "Jenss-Bayley" (or "JB"), and "nonparametric" (or "NonP"). It takes the value passed from getLGCM() or getLCSM().

records

A numeric vector specifying indices of the study waves. It takes the value passed from getLGCM() or getLCSM().

growth_TIC

A string or character vector specifying the column name(s) of time-invariant covariate(s) contributing to the variability of growth factors if any. It takes the value passed from getLGCM() or getLCSM().

res_scale

A numeric value representing the scaling factor for the initial calculation of the residual variance. This value should be between 0 and 1, exclusive. It takes the value passed from getLGCM() or getLCSM().

Value

A list containing the initial values for parameters related to growth factors, TICs (if any), and path coefficients (if any) of a latent growth curve model or a latent change score model. The returned list has the following structure:

Y_starts:

A list containing three elements:

alpha0 or mean0:

Depends on whether growth_TIC is provided,

psi_r or psi0:

Depends on whether growth_TIC is provided,

residuals.
TIC_starts:

Only provided when growth_TIC is not NULL.

beta0:

Only provided when growth_TIC is not NULL.

Each of these elements is a numeric vector or matrix containing the initial parameter estimates.


nlpsem documentation built on Sept. 13, 2023, 1:06 a.m.