nlive: an R package to facilitate the application of the sigmoidal and random changepoint mixed models

Abstract Background The use of mixed effect models with a specific functional form such as the Sigmoidal Mixed Model and the Piecewise Mixed Model (or Changepoint Mixed Model) with abrupt or smooth random change allows the interpretation of the defined parameters to understand longitudinal trajector...

Full description

Bibliographic Details
Main Authors: Ana W. Capuano, Maude Wagner
Format: Article
Language:English
Published: BMC 2023-11-01
Series:BMC Medical Research Methodology
Subjects:
Online Access:https://doi.org/10.1186/s12874-023-02075-4
_version_ 1797376925715398656
author Ana W. Capuano
Maude Wagner
author_facet Ana W. Capuano
Maude Wagner
author_sort Ana W. Capuano
collection DOAJ
description Abstract Background The use of mixed effect models with a specific functional form such as the Sigmoidal Mixed Model and the Piecewise Mixed Model (or Changepoint Mixed Model) with abrupt or smooth random change allows the interpretation of the defined parameters to understand longitudinal trajectories. Currently, there are no interface R packages that can easily fit the Sigmoidal Mixed Model allowing the inclusion of covariates or incorporating recent developments to fit the Piecewise Mixed Model with random change. Results To facilitate the modeling of the Sigmoidal Mixed Model, and Piecewise Mixed Model with abrupt or smooth random change, we have created an R package called nlive. All needed pieces such as functions, covariance matrices, and initials generation were programmed. The package was implemented with recent developments such as the polynomial smooth transition of the piecewise mixed model with improved properties over Bacon-Watts, and the stochastic approximation expectation-maximization (SAEM) for efficient estimation. It was designed to help interpretation of the output by providing features such as annotated output, warnings, and graphs. Functionality, including time and convergence, was tested using simulations. We provided a data example to illustrate the package use and output features and interpretation. The package implemented in the R software is available from the Comprehensive R Archive Network (CRAN) at https://CRAN.R-project.org/package=nlive . Conclusions The nlive package for R fits the Sigmoidal Mixed Model and the Piecewise Mixed: abrupt and smooth. The nlive allows fitting these models with only five mandatory arguments that are intuitive enough to the less sophisticated users.
first_indexed 2024-03-08T19:45:37Z
format Article
id doaj.art-9f0f1269a4964d13a002b0dd9505188c
institution Directory Open Access Journal
issn 1471-2288
language English
last_indexed 2024-03-08T19:45:37Z
publishDate 2023-11-01
publisher BMC
record_format Article
series BMC Medical Research Methodology
spelling doaj.art-9f0f1269a4964d13a002b0dd9505188c2023-12-24T12:22:23ZengBMCBMC Medical Research Methodology1471-22882023-11-0123111510.1186/s12874-023-02075-4nlive: an R package to facilitate the application of the sigmoidal and random changepoint mixed modelsAna W. Capuano0Maude Wagner1RUSH Alzheimer’s Disease Center, Rush University Medical Center, 1750 HarrisonRUSH Alzheimer’s Disease Center, Rush University Medical Center, 1750 HarrisonAbstract Background The use of mixed effect models with a specific functional form such as the Sigmoidal Mixed Model and the Piecewise Mixed Model (or Changepoint Mixed Model) with abrupt or smooth random change allows the interpretation of the defined parameters to understand longitudinal trajectories. Currently, there are no interface R packages that can easily fit the Sigmoidal Mixed Model allowing the inclusion of covariates or incorporating recent developments to fit the Piecewise Mixed Model with random change. Results To facilitate the modeling of the Sigmoidal Mixed Model, and Piecewise Mixed Model with abrupt or smooth random change, we have created an R package called nlive. All needed pieces such as functions, covariance matrices, and initials generation were programmed. The package was implemented with recent developments such as the polynomial smooth transition of the piecewise mixed model with improved properties over Bacon-Watts, and the stochastic approximation expectation-maximization (SAEM) for efficient estimation. It was designed to help interpretation of the output by providing features such as annotated output, warnings, and graphs. Functionality, including time and convergence, was tested using simulations. We provided a data example to illustrate the package use and output features and interpretation. The package implemented in the R software is available from the Comprehensive R Archive Network (CRAN) at https://CRAN.R-project.org/package=nlive . Conclusions The nlive package for R fits the Sigmoidal Mixed Model and the Piecewise Mixed: abrupt and smooth. The nlive allows fitting these models with only five mandatory arguments that are intuitive enough to the less sophisticated users.https://doi.org/10.1186/s12874-023-02075-4Longitudinal outcomenliveNon-linear mixed modelRandom changepoint modelR packageSaemix
spellingShingle Ana W. Capuano
Maude Wagner
nlive: an R package to facilitate the application of the sigmoidal and random changepoint mixed models
BMC Medical Research Methodology
Longitudinal outcome
nlive
Non-linear mixed model
Random changepoint model
R package
Saemix
title nlive: an R package to facilitate the application of the sigmoidal and random changepoint mixed models
title_full nlive: an R package to facilitate the application of the sigmoidal and random changepoint mixed models
title_fullStr nlive: an R package to facilitate the application of the sigmoidal and random changepoint mixed models
title_full_unstemmed nlive: an R package to facilitate the application of the sigmoidal and random changepoint mixed models
title_short nlive: an R package to facilitate the application of the sigmoidal and random changepoint mixed models
title_sort nlive an r package to facilitate the application of the sigmoidal and random changepoint mixed models
topic Longitudinal outcome
nlive
Non-linear mixed model
Random changepoint model
R package
Saemix
url https://doi.org/10.1186/s12874-023-02075-4
work_keys_str_mv AT anawcapuano nliveanrpackagetofacilitatetheapplicationofthesigmoidalandrandomchangepointmixedmodels
AT maudewagner nliveanrpackagetofacilitatetheapplicationofthesigmoidalandrandomchangepointmixedmodels