{"Package":"ddtlcm","Type":"Package","Title":"Latent Class Analysis with Dirichlet Diffusion Tree Process\nPrior","Version":"0.2.1","Date":"2024-03-26","Authors@R":"c(\nperson(\"Mengbing\", \"Li\",\nemail=\"mengbing@umich.edu\",\nrole=c(\"cre\",\"aut\"),\ncomment = c(ORCID = \"0000-0002-2264-8006\")),\nperson(\"Briana\", \"Stephenson\",\nemail=\"bstephenson@hsph.harvard.edu\",\nrole=c(\"ctb\")),\nperson(\"Zhenke\", \"Wu\",\nemail=\"zhenkewu@umich.edu\",\nrole=c(\"ctb\"),\ncomment = c(ORCID = \"0000-0001-7582-669X\"))\n)","Maintainer":"Mengbing Li ","Description":"Implements a Bayesian algorithm for overcoming weak separation in Bayesian latent class analysis.\nReference: Li et al. (2023) .","Depends":"R(>= 4.3)","biocViews":"","Imports":"ape (>= 5.6-2), data.table (>= 1.14.4), extraDistr (>= 1.9.1),\nggplot2 (>= 3.4.0), ggpubr (>= 0.6.0), ggtext (>= 0.1.2),\nggtree (>= 3.4.0), label.switching (>= 1.8), matrixStats (>=\n0.62.0), methods (>= 4.2.3), phylobase (>= 0.8.10), poLCA (>=\n1.6.0.1), testthat (>= 3.1.7), truncnorm (>= 1.0-8), BayesLogit\n(>= 2.1), Matrix (>= 1.5-1), Rdpack (>= 2.5), R.utils (>=\n2.12.2)","Suggests":"knitr, parallel, rmarkdown, xfun","License":"MIT + file LICENSE","Encoding":"UTF-8","LazyData":"true","VignetteBuilder":"knitr","RoxygenNote":"7.3.1","URL":"https://github.com/limengbinggz/ddtlcm","BugReports":"https://github.com/limengbinggz/ddtlcm/issues","Config/testthat/edition":"3","NeedsCompilation":"no","Packaged":"2024-04-04 00:58:26 UTC; mengbing","Author":"Mengbing Li [cre, aut] (),\nBriana Stephenson [ctb],\nZhenke Wu [ctb] ()","Repository":"CRAN","Date/Publication":"2024-04-04 02:32:57 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/ddtlcm_0.2.1.tar.gz","jsonAuthors":[{"name":"Mengbing Li","email":"mengbing@umich.edu","maintainer":true},{"name":"Briana Stephenson","email":"bstephenson@hsph.harvard.edu","maintainer":false},{"name":"Zhenke Wu","email":"zhenkewu@umich.edu","maintainer":false}],"readme":"**ddtlcm**: Dirichlet diffusion tree-latent class model (DDT-LCM)\n\nAn R package for Tree-regularized latent class mModels with a DDT process prior on class profiles\n\n**Maintainer**: Mengbing Li (mengbing@umich.edu)\n\n**Contributors**: Briana Stephenson (bstephenson@hsph.harvard.edu); Zhenke Wu (zhenkewu@umich.edu)\n\n\n\n| | Citation | Paper Link\n| ------------- | ------------- | ------------- |\n| Bayesian tree-regularized LCM | Li M, Stephenson B, Wu Z (2023). Tree-Regularized Bayesian Latent Class Analysis for Improving Weakly Separated Dietary Pattern Subtyping in Small-Sized Subpopulations. *ArXiv:2306.04700*. |[Link](https://arxiv.org/abs/2306.04700)| \n\n## Table of content\n- [1. Installation](#id-section1)\n- [2. Overview](#id-section2)\n- [3. Example](#id-section3)\n\n

\n\nInstallation\n--------------\n```r\n# install bioconductor package `ggtree` for visualizing results:\nif (!require(\"BiocManager\", quietly = TRUE))\n install.packages(\"BiocManager\")\nBiocManager::install(\"ggtree\")\n\ninstall.packages(\"devtools\",repos=\"https://cloud.r-project.org\")\ndevtools::install_github(\"limengbinggz/ddtlcm\")\n```\n\n\n\n\n

\n\nOverview\n----------\n`ddtlcm` is designed for analyzing multivariate binary observations over grouped items in a tree-regularized Bayesian LCM framework. Between-class similarities are guided by an unknown tree, where classes positioned closer on the tree are more similar _a priori_. This framework facilitates the sharing of information between classes to make better estimates of parameters using less data. The model is built upon equipping LCMs with a DDT process prior on the class profiles, with varying degrees of shrinkage across major item groups. The model is particularly promising for addressing weak separation of latent classes when sample sizes are small. The posterior inferential algorithm is based on a hybrid Metropolis-Hastings-within-Gibbs algorithm and can provide posterior uncertainty quantifications.\n\n\n**ddtlcm** works for \n\n* multivariate binary responses over pre-specified grouping of items\n\n\n* The functions' relations in the package `ddtlcm` can be visualized by\n\n```r\nlibrary(DependenciesGraphs) # if not installed, try this-- devtools::install_github(\"datastorm-open/DependenciesGraphs\")\nlibrary(QualtricsTools) # devtools::install_github(\"emmamorgan-tufts/QualtricsTools\")\ndep <- funDependencies('package:ddtlcm','ddtlcm_fit')\nplot(dep)\n```\n\n\n

\n\nExamples \n---------\n\n* A simple [workflow](vignettes/ddtlcm-demo.Rmd) using semi-synthetic data is provided.\n\n* *ddtlcm* estimates the tree over classes and class profiles simultaneously ![](inst/ddtlcm_output_example.png)\n\n\nA Quickstart\n---------\n```r\nlibrary(ddtlcm)\n\ndata(parameter_diet)\n# unlist the elements into variables in the global environment\nlist2env(setNames(parameter_diet, names(parameter_diet)), envir = globalenv()) \n\nN <- 496\nseed_parameter = 1 # random seed to generate node parameters given the tree\nseed_response = 1 # random seed to generate multivariate binary observations from LCM\n\n# simulate data given the parameters\nsim_data <- simulate_lcm_given_tree(tree_phylo, N, \n class_probability, item_membership_list, Sigma_by_group, \n root_node_location = 0, seed_parameter = seed_parameter,\n seed_response = seed_response)\n\nK <- 6 # number of latent classes, same as number of leaves on the tree\nresult_diet <- ddtlcm_fit(K = K, data = sim_data$response_matrix, \n item_membership_list = item_membership_list, total_iters = 100)\nprint(result_diet)\n```\n\n\n\nContributing And Getting Help\n---------\nPlease report bugs by opening an [issue](https://github.com/limengbinggz/ddtlcm/issues/new). If you wish to contribute, please make a pull request. If you have questions, you can open a [discussion thread](https://github.com/limengbinggz/ddtlcm/discussions).\n\n\n\nNote\n---------\n\n* When running some functions in the package, such as ``ddtlcm_fit``, a warning that \"Tree contains singleton nodes\" may be displayed. This warning originates from the ``checkPhylo4`` function in the phylobase package to perform basic checks on the validity of S4 phylogenetic objects. We would like to point out that seeing such warnings shall not pose any concerns about the statistical validity of the implemented algorithm. This is because any tree generaetd from a DDT process contains a singleton node (having only one child node) as the root node. To avoid repeated appearances of this warning, we recommend either of the followings:\n\n - Wrapping around the code via ``suppressWarnings({ code_that_will_generate_singleton_warning })``;\n\n - Setting ``options(warn = -1)`` globally. This may be dangerous because other meaningful warnings may be ignored.\n\n\n\n\n\n","jobInfo":{"package":"ddtlcm","version":"0.2.1","parsingStatus":"success","parserVersion":2,"parsedAt":"2024-04-04T05:30:30+0000"}}

Description

Usage

Arguments