# Analyze and Visualize Data from 'Microsoft Viva Insights'

## Documentation for package ‘vivainsights’ version 0.7.1

- DESCRIPTION file
- Package NEWS
- Package README

## Help Pages

A C E F G H I J K M N O P R T U V W X

## -- A --

afterhours_dist | Distribution of After-hours Collaboration Hours as a 100% stacked bar
afterhours_fizz | Distribution of After-hours Collaboration Hours (Fizzy Drink plot)
afterhours_line | After-hours Collaboration Time Trend - Line Chart
afterhours_rank | Rank groups with high After-Hours Collaboration Hours
afterhours_sum | Summary of After-Hours Collaboration Hours
afterhours_summary | Summary of After-Hours Collaboration Hours
afterhours_trend | After-Hours Time Trend
analysis_scope | Create a count of distinct people in a specified HR variable
anonymise | Anonymise a categorical variable by replacing values
anonymize | Anonymise a categorical variable by replacing values
any_idate | Identify whether variable is an IDate class.

## -- C --

camel_clean | Convert "CamelCase" to "Camel Case"
check_inputs | Check whether a data frame contains all the required variable
check_query | Check a query to ensure that it is suitable for analysis
collaboration_area | Collaboration - Stacked Area Plot
collaboration_dist | Distribution of Collaboration Hours as a 100% stacked bar
collaboration_fizz | Distribution of Collaboration Hours (Fizzy Drink plot)
collaboration_line | Collaboration Time Trend - Line Chart
collaboration_rank | Collaboration Ranking
collaboration_sum | Collaboration Summary
collaboration_summary | Collaboration Summary
collaboration_trend | Collaboration Time Trend
collab_area | Collaboration - Stacked Area Plot
collab_dist | Distribution of Collaboration Hours as a 100% stacked bar
collab_fizz | Distribution of Collaboration Hours (Fizzy Drink plot)
collab_line | Collaboration Time Trend - Line Chart
collab_rank | Collaboration Ranking
collab_sum | Collaboration Summary
collab_summary | Collaboration Summary
comma | Add comma separator for thousands
copy_df | Copy a data frame to clipboard for pasting in Excel
create_bar | Mean Bar Plot for any metric
create_bar_asis | Create a bar chart without aggregation for any metric
create_boxplot | Box Plot for any metric
create_bubble | Create a bubble plot with two selected Viva Insights metrics (General Purpose), with size representing the number of employees in the group.
create_density | Create a density plot for any metric
create_dist | Horizontal 100 percent stacked bar plot for any metric
create_dt | Create interactive tables in HTML with 'download' buttons.
create_fizz | Fizzy Drink / Jittered Scatter Plot for any metric
create_hist | Create a histogram plot for any metric
create_inc | Create an incidence analysis reflecting proportion of population scoring above or below a threshold for a metric
create_incidence | Create an incidence analysis reflecting proportion of population scoring above or below a threshold for a metric
create_itsa | Estimate an effect of intervention on every Viva Insights metric in input file by applying single-group Interrupted Time-Series Analysis (ITSA)
create_IV | Compute Information Value for Predictive Variables
create_line | Time Trend - Line Chart for any metric
create_line_asis | Create a line chart without aggregation for any metric
create_lorenz | Calculate the Lorenz Curve and Gini Coefficient in a Person Query
create_period_scatter | Period comparison scatter plot for any two metrics
create_rank | Rank all groups across HR attributes on a selected Viva Insights metric
create_rank_combine | Create combination pairs of HR variables and run 'create_rank()'
create_rogers | Generate Rogers Adoption Curve plots for Copilot usage
create_sankey | Create a sankey chart from a two-column count table
create_scatter | Create a Scatter plot with two selected Viva Insights metrics (General Purpose)
create_stacked | Horizontal stacked bar plot for any metric
create_tracking | Create a line chart that tracks metrics over time with a 4-week rolling average
create_trend | Heat mapped horizontal bar plot over time for any metric
cut_hour | Convert a numeric variable for hours into categorical

## -- E --

email_dist | Distribution of Email Hours as a 100% stacked bar
email_fizz | Distribution of Email Hours (Fizzy Drink plot)
email_line | Email Time Trend - Line Chart
email_rank | Email Hours Ranking
email_sum | Email Summary
email_summary | Email Summary
email_trend | Email Hours Time Trend
export | Export 'vivainsights' outputs to CSV, clipboard, or save as images
external_dist | Distribution of External Collaboration Hours as a 100% stacked bar
external_fizz | Distribution of External Collaboration Hours (Fizzy Drink plot)
external_line | External Collaboration Hours Time Trend - Line Chart
external_rank | Rank groups with high External Collaboration Hours
external_sum | External Collaboration Summary
external_summary | External Collaboration Summary
extract_date_range | Extract date period
extract_hr | Extract HR attribute variables

## -- F --

flag_ch_ratio | Flag unusual high collaboration hours to after-hours collaboration hours ratio
flag_em_ratio | Flag Persons with unusually high Email Hours to Emails Sent ratio
flag_extreme | Warn for extreme values by checking against a threshold
flag_outlooktime | Flag unusual outlook time settings for work day start and end time

## -- G --

g2g_data | Sample Group-to-Group dataset
generate_report | Generate HTML report with list inputs
generate_report2 | Generate HTML report based on existing RMarkdown documents

## -- H --

heat_colors | Generate a vector of 'n' contiguous colours, as a red-yellow-green palette.
heat_colours | Generate a vector of 'n' contiguous colours, as a red-yellow-green palette.
hrvar_count | Create a count of distinct people in a specified HR variable
hrvar_count_all | Create count of distinct fields and percentage of employees with missing values for all HR variables
hrvar_trend | Track count of distinct people over time in a specified HR variable
hr_trend | Employee count over time

## -- I --

identify_churn | Identify employees who have churned from the dataset
identify_datefreq | Identify date frequency based on a series of dates
identify_habit | Identify whether a habitual behaviour exists over a given interval of time
identify_holidayweeks | Identify Holiday Weeks based on outliers
identify_inactiveweeks | Identify Inactive Weeks
identify_nkw | Identify Non-Knowledge workers in a Person Query using Collaboration Hours
identify_outlier | Identify metric outliers over a date interval
identify_privacythreshold | Identify groups under privacy threshold
identify_shifts | Identify shifts based on outlook time settings for work day start and end time
identify_tenure | Tenure calculation based on different input dates, returns data summary table or histogram
identify_usage_segments | Identify Usage Segments based on a metric
import_query | Import a query from Viva Insights Analyst Experience
is_date_format | Identify whether string is a date format
IV_report | Generate a Information Value HTML Report

## -- J --

jitter_metrics | Jitter metrics in a data frame

## -- K --

keymetrics_scan | Run a summary of Key Metrics from the Standard Person Query data
keymetrics_scan_asis | Run a summary of Key Metrics without aggregation

## -- M --

maxmin | Max-Min Scaling Function
meeting_dist | Distribution of Meeting Hours as a 100% stacked bar
meeting_fizz | Distribution of Meeting Hours (Fizzy Drink plot)
meeting_line | Meeting Time Trend - Line Chart
meeting_rank | Meeting Hours Ranking
meeting_sum | Meeting Summary
meeting_summary | Meeting Summary
meeting_tm_report | Generate a Meeting Text Mining report in HTML
meeting_trend | Meeting Hours Time Trend
mt_data | Sample Meeting Query dataset

## -- N --

network_g2g | Create a network plot with the group-to-group query
network_p2p | Perform network analysis with the person-to-person query
network_summary | Summarise node centrality statistics with an igraph object

## -- O --

one2one_dist | Distribution of Manager 1:1 Time as a 100% stacked bar
one2one_fizz | Distribution of Manager 1:1 Time (Fizzy Drink plot)
one2one_freq | Frequency of Manager 1:1 Meetings as bar or 100% stacked bar chart
one2one_line | Manager 1:1 Time Trend - Line Chart
one2one_rank | Manager 1:1 Time Ranking
one2one_sum | Manager 1:1 Time Summary
one2one_summary | Manager 1:1 Time Summary
one2one_trend | Manager 1:1 Time Trend

## -- P --

p2p_data | Sample person-to-person dataset
p2p_data_sim | Simulate a person-to-person query using a Watts-Strogatz model
pad2 | Create the two-digit zero-padded format
pairwise_count | Perform a pairwise count of words by id
plot_ts_us | Plot Usage Segments over time
pq_data | Sample Person Query dataset
prep_query | Prepare variable names and types in query data frame for analysis

## -- R --

read_preamble | Read preamble
rgb2hex | Convert rgb to HEX code

## -- T --

theme_wpa | Main theme for 'vivainsights' visualisations
theme_wpa_basic | Basic theme for 'vivainsights' visualisations
tm_clean | Clean subject line text prior to analysis
tm_cooc | Analyse word co-occurrence in subject lines and return a network plot
tm_freq | Perform a Word or Ngram Frequency Analysis and return a Circular Bar Plot
tm_wordcloud | Generate a wordcloud with meeting subject lines
totals_bind | Row-bind an identical data frame for computing grouped totals
totals_col | Fabricate a 'Total' HR variable
track_HR_change | Sankey chart of organizational movement between HR attributes and missing values (outside company move) (Data Overview)
tstamp | Generate a time stamp

## -- U --

us_to_space | Replace underscore with space

## -- V --

validation_report | Generate a Data Validation report in HTML

## -- W --

wrap | Add a character at the start and end of a character string
wrap_text | Wrap text based on character threshold

## -- X --

xicor | Calculate Chatterjee's Rank Correlation Coefficient