README.md

In souravbose1991/TexTrove: A Shiny App to run Topic Models

TexTapience: A Simple Shiny App for Topic Modeling

This GitHub repo provides an interactive app for running small (< 100 MB) text datasets. For larger datasets, we recommend a separate GitHub repo that provides code examples of how to run manually topic modeling.

Prerequisites for Windows users

Typically, R packages will automatically install dependent CRAN packages via the install_github function from devtools. However, for Windows (R >= 3.4.0), this function does not work.

Therefore, if you're running Windows, please run the following code to ensure you have the dependent packages before running the next step.

This may take a few minutes but you only need to run once.

packages <- c("Matrix","shiny","quanteda","shinydashboard","RColorBrewer","DT","visNetwork","tm",
              "igraph","wordcloud","scatterD3","reshape","grid","tidyverse","shinyjs","shinyBS","stm","treemap",
              "slickR","slam","tidytext","tidyverse","devtools","dendextend","textclean","data.table",
              "textstem","tokenizers","ggExtra","sentimentr","plotly","networkD3","network","networkDynamic",
              "ndtv","sna")

install.packages(packages)

Download and Running

To install and the run the app, open R/R Studio and run the following code:

install.packages("devtools")
devtools::install_github("jbkunst/d3wordcloud") #non CRAN dependency
devtools::install_github("souravbose1991/TexTapience")
topicApp::runApp()

FAQ/Help

1. I'm getting an error message when trying to install the slam package (a dependency for several other packages).

Try to run this command in your R (or R Studio) Console:

slam_url <- "https://cran.r-project.org/src/contrib/Archive/slam/slam_0.1-37.tar.gz" 
devtools::install_url(slam_url)

This should manually install the slam package.

1. I want to use more features of the stm packages (e.g., include covariates).

This app has been created for only simple analyses (e.g., small datasets, no covariates, limited functionality). If you're interested in more functionality of the stm package, you should considering either running the code individually or use Dan Zangri's stmgui package (see stmGUI GitHub)

1. I received an error that the file uploaded exceeded the maximum size (100MB+).

Yes. You will either (1) need to reduce the size of your dataset (e.g., remove unnecessary columns, sample records) or (2) consider running code manually. topicApp is only intended for small datasets and a starter solution for researchers new to R and topic modeling. For more advanced researchers, we recommend the code provided in a separate code repo https://github.com/souravbose1991/text-analysis-org-science.

souravbose1991/TexTrove documentation built on May 6, 2019, 11:44 a.m.