# Google Word Tree with R googleChartName \<- "wordtree" gvisChartName \<- "gvisWordTree" A word tree depicts multiple parallel sequences of words. It could be used to show which words most often follow or precede a target word (e.g., "Cats are...") or to show a hierarchy of terms (e.g., a decision tree). ```r gvisWordTree( data, textvar = "", sizevar = "", stylevar = "", idvar = "", parentvar = "", options = list(), method = "implicit", chartid ) ``` ## Arguments - `data`: `data.frame` that contains the data to be visualised - `textvar`: a string that refers to the column name in `data` that contains the text to be used. - `sizevar`: a string that refers to the column name in `data` that contains the size of the words in the word tree. - `stylevar`: a string that refers to the column name in `data` that contains the stlye of the text. For no warning message in plot, should be called `.style`. - `idvar`: (only when format is explicit) a string that refers to the column name in `data` that contains the unique ID of the text. - `parentvar`: (only when format is explicit) a string that refers to the column name in `data` that contains the ID of the parent of the text. - `options`: list of configuration options, see: gsub("CHARTNAME", googleChartName, readLines(file.path(".", "inst","mansections", "GoogleChartToolsURLConfigOptions.txt"))) paste(readLines(file.path(".", "inst", "mansections","gvisOptions.txt"))) - `method`: a string to say whether the word tree is either: - **`implicit`**: - will weight and connect automatically, or - **`explicit`**: - can specify weights and connections - `chartid`: character. If missing (default) a random chart id will be generated based on chart type and `tempfile` ## Returns paste(gvisChartName) returns list of `class` paste(readLines(file.path(".", "inst", "mansections","gvisOutputStructure.txt"))) ## Warning The word tree chart may be undergoing substantial revisions in future Google Charts releases. ## Examples ```r ## Please note that by default the googleVis plot command ## will open a browser window and requires Internet ## connection to display the visualisation. wt1 <- gvisWordTree(Cats, textvar = "Phrase") plot(wt1) Cats2 <- Cats Cats2$Phrase.style <- ifelse(Cats$Sentiment >= 7, "green", ifelse(Cats$Sentiment <= 3, "red", "black")) wt2 <- gvisWordTree(Cats2, textvar = "Phrase", stylevar = "Phrase.style", options = list(fontName = "Times-Roman", wordtree = "{word: 'cats'}", backgroundColor = "#cba")) plot(wt2) # Explicit word tree exp.data <- data.frame(id = as.numeric(0:9), label = letters[1:10], parent = c(-1, 0, 0, 0, 2, 2, 4, 6, 1, 7), size = c(10, 5, 3, 2, 2, 2, 1, 1, 5, 1), stringsAsFactors = FALSE) wt3 <- gvisWordTree(exp.data, idvar = "id", textvar = "label", parentvar = "parent", sizevar = "size", options = list(wordtree = "{format: 'explicit'}"), method = "explicit") plot(wt3) ``` ## References Google Chart Tools API: gsub("CHARTNAME", googleChartName, readLines(file.path(".", "inst","mansections", "GoogleChartToolsURL.txt"))) ## Author(s) Ashley Baldry

gvisWordTree function