tm_freq: Perform a Word or Ngram Frequency Analysis and return a...

In vivainsights: Analyze and Visualize Data from 'Microsoft Viva Insights'

Perform a Word or Ngram Frequency Analysis and return a Circular Bar Plot

Description

Generate a circular bar plot with frequency of words / ngrams. This function is used within meeting_tm_report().

Usage

tm_freq(data, token = "words", stopwords = NULL, keep = 100, return = "plot")

Arguments

data	A Meeting Query dataset in the form of a data frame.
token	A character vector accepting either "words" or "ngram", determining type of tokenisation to return.
stopwords	A character vector OR a single-column data frame labelled 'word' containing custom stopwords to remove.
keep	A numeric vector specifying maximum number of words to keep.
return	String specifying what to return. This must be one of the following strings: "plot" "table" See Value for more information.

Details

This function uses tm_clean() as the underlying data wrangling function. There is an option to remove stopwords by passing a data frame into the stopwords argument.

Value

A different output is returned depending on the value passed to the return argument:

• "plot": 'ggplot' object. A circular bar plot.

• "table": data frame. A summary table.

See Also

Other Text-mining: meeting_tm_report(), pairwise_count(), tm_clean(), tm_cooc(), tm_wordcloud()

Examples

# circular network plot with words
tm_freq(mt_data, token = "words")

# circular network plot with ngrams
tm_freq(mt_data, token = "ngrams")

# summary table of text frequency
tm_freq(mt_data, token = "words", return = "table")

vivainsights documentation built on Aug. 8, 2025, 6:21 p.m.