--- title: "Examples of Latent Growth Curve Models" output: rmarkdown::html_vignette description: > This vignette provides a comprehensive exploration and practical demonstrations of the `getLGCM()` function. This function is designed to construct Latent Growth Curve Models (LGCMs) using one of five different functional forms: linear, quadratic, negative exponential, Jenss-Bayley, and bilinear spline. Notably, the negative exponential, Jenss-Bayley, and bilinear spline LGCMs can be fitted as intrinsically nonlinear models. Moreover, the function provides the flexibility to be constructed with or without the incorporation of time-invariant covariates (TICs). vignette: > %\VignetteIndexEntry{Examples of Latent Growth Curve Models} %\VignetteEngine{knitr::rmarkdown} %\VignetteEncoding{UTF-8} --- ```{r, include = FALSE} knitr::opts_chunk$set( collapse = TRUE, comment = "#>" ) has_data <- nzchar(system.file("extdata", "getLGCM_examples.RData", package = "nlpsem")) knitr::opts_chunk$set(eval = has_data) ``` The saved examples below were generated with nlpsem 1.0.0.9006; `extdata/REGENERATED.txt` records the versions and how the fits compare with the previous ones. Rendering this guide does not refit its disabled model-fitting chunks. Refit with the current version for a new analysis, use `getDiagnostics()` to check admissibility and uncertainty, and compare multiple starts for difficult nonlinear or mixture models. These examples are not evidence of numerical qualification. ## Load nlpsem package, dependent packages and set CSOLNP as the optimizer ```{r, message = FALSE} library(nlpsem) mxOption(model = NULL, key = "Default optimizer", "CSOLNP", reset = FALSE) ``` ## Load pre-computed models ```{r, message = FALSE} load(system.file("extdata", "getLGCM_examples.RData", package = "nlpsem")) ``` ## Load example data and preprocess data ```{r, message = FALSE, eval = FALSE} # Load ECLS-K (2011) data data("RMS_dat") RMS_dat0 <- RMS_dat # Re-baseline the data so that the estimated initial status is for the # starting point of the study baseT <- RMS_dat0$T1 RMS_dat0$T1 <- RMS_dat0$T1 - baseT RMS_dat0$T2 <- RMS_dat0$T2 - baseT RMS_dat0$T3 <- RMS_dat0$T3 - baseT RMS_dat0$T4 <- RMS_dat0$T4 - baseT RMS_dat0$T5 <- RMS_dat0$T5 - baseT RMS_dat0$T6 <- RMS_dat0$T6 - baseT RMS_dat0$T7 <- RMS_dat0$T7 - baseT RMS_dat0$T8 <- RMS_dat0$T8 - baseT RMS_dat0$T9 <- RMS_dat0$T9 - baseT # Standardize time-invariant covariates (TICs) ## ex1 and ex2 are standardized growth TICs in models RMS_dat0$ex1 <- scale(RMS_dat0$Approach_to_Learning) RMS_dat0$ex2 <- scale(RMS_dat0$Attention_focus) xstarts <- mean(baseT) ``` ## Example 1: Fit bilinear spline LGCMs with both a random and a fixed knot to evaluate the development of mathematics ability from Kindergarten to Grade 5. These models are then compared using a likelihood ratio test (LRT) utilizing the getLRT() function. ```{r, message = FALSE, eval = FALSE} Math_LGCM_BLS_f <- getLGCM( dat = RMS_dat0, t_var = "T", y_var = "M", curveFun = "bilinear spline", intrinsic = TRUE, records = 1:9, growth_TIC = NULL, tries = 10 ) Math_LGCM_BLS_r <- getLGCM( dat = RMS_dat0, t_var = "T", y_var = "M", curveFun = "bilinear spline", intrinsic = FALSE, records = 1:9, growth_TIC = NULL, tries = 10 ) ``` ```{r} getLRT( full = Math_LGCM_BLS_f@mxOutput, reduced = Math_LGCM_BLS_r@mxOutput, boot = FALSE, rep = NA ) ``` The stored comparison has four additional parameters for the random-knot model. Its likelihood and AIC/BIC summarize these particular fitted solutions. The ordinary chi-square p-value is not a validated significance test for the random-knot effect: the loading formulas use different smoothing, latent covariance admissibility must be checked, and the null model's regularity conditions require justification. See `?getLRT` for nesting, same-data and bootstrap requirements. Bootstrapping does not automatically correct non-nesting or an inadmissible fitted model. Use `getDiagnostics()` and repeated starts before interpreting either solution. ## Example 2: Fit the full bilinear spline LGCM to assess the development of mathematics skill from Kindergarten to Grade 5. This model includes two growth time-invariant covariates (TICs), baseline values of teacher-reported approach to learning and attentional focus. Point estimates and corresponding standard errors (SEs) of all parameters are presented within the original parameter space. The plot of the growth status of mathematics ability is also provided. ```{r, message = FALSE, eval = FALSE} Math_LGCM_TIC_BLS_f <- getLGCM( dat = RMS_dat0, t_var = "T", y_var = "M", curveFun = "bilinear spline", intrinsic = TRUE, records = 1:9, growth_TIC = c("ex1", "ex2"), tries = 10, paramOut = TRUE ) ``` ```{r, fig.alt = "Mathematics mean trajectory over months from a bilinear spline growth model with a random knot and time-invariant covariates, comparing the fitted mean and smoothed observed mean with pointwise 95 percent confidence limits."} Math_LGCM_TIC_BLS_f@Estimates Figure1 <- getFigure( model = Math_LGCM_TIC_BLS_f@mxOutput, nClass = NULL, cluster_TIC = NULL, sub_Model = "LGCM", y_var = "M", curveFun = "BLS", y_model = "LGCM", t_var = "T", records = 1:9, m_var = NULL, x_var = NULL, x_type = NULL, xstarts = xstarts, xlab = "Month", outcome = "Mathematics" ) show(Figure1) ``` In the provided output, the terms alpha0, alpha1, alpha2, and alphag denote the conditional mean values of the intercept, first slope, second slope, and knot on growth TICs. The terms mueta0, mueta1, mueta2, and mu_knot represent the mean values of the intercept, first slope, second slope, and knot. These corresponding values match as we've centered the growth TICs. The mean values of growth factors suggest that the rate of progress in mathematical ability slowed down after approximately 35.16 months since the beginning of the study. Moreover, the psi terms indicate the unexplained variance or covariance of the growth factors, while residuals corresponds to residual variance. Moreover, beta10, beta11, beta12, and beta1g are path coefficients from the first growth TIC (i.e., baseline teacher-reported approach to learning) to the intercept, first slope, second slope, and knot, respectively. Similarly, beta2's correspond to the path coefficients of the baseline teacher-reported attentional focus. The interpretations of these coefficients are rather intuitive. For instance, a beta1g value of $0.2187$ implies that a one standardized unit increase in baseline teacher-reported approach to learning delays the transition time to slower development by $0.2187$ months. Similarly, a beta2g value of $-0.9865$ indicates that a one standardized unit increase in baseline teacher-reported attentional focus advances the transition time to slower development by $0.9865$ months. However, caution is required when considering potential colinearity between growth TICs. The graphic representation of mathematical development also supports the observation that developmental pace slows down in later stages. .