Summary

This branch updates functions create_bar(), create_stacked(), and create_dist() to improve consistent look and feel and behaviours. This version is the last pull request to the main branch before submission to CRAN for v1.5.0.

Changes

The changes made in this PR are:

1. Refactored create_bar() to depend on create_stacked().
2. Changes to create_bar() and create_stacked()
   • Added a rank argument that enables bars to be ranked in descending, ascending, or 'free' order.
   • Added a percent argument to enable the display of data labels and axis labels in percentages.
   • Added xlim as an argument to set the maximum value in the horizontal axis.
3. Better handling of minimum and maximum bounds for create_dist(). Also solves issue mentioned in Bug: update one to one frequency distribution buckets #114 for one2one_freq().
4. Update check_query() to print single-value HR attributes as a string (previously this depends only on the Domain variable being present in the dataset.
5. Updated pull request template to update NEWS.md.
6. Added a link to the Microsoft Learn module to README.md and the Additional resources section of the Analyst Guide.
7. A new function hrvar_trend() is added which shows a heatmapped view of the number of employees grouped by HR attribute. A new argument legend_title is added to the underlying function create_trend().
8. New abbreviated groups are added to the outputs of workingpatterns_classify().

Some documentation clean-up and spellchecks have also been conducted in preparation for the CRAN submission.

Highlights

• Same format for axis
• Same format for titles and subtitles
• Same size of side panel for number of observations per row
• Option to modify titles in create_bar, as it was was possible in create_stacked
• Legends always present

Examples

New consistent formats

Ordering functionality

create_bar(
  sq_data,
  metric = "Email_hours",
  rank = "ascending"
)

create_bar(
  sq_data,
  metric = "Email_hours",
  rank = "descending"
)

create_bar(
  sq_data,
  metric = "Email_hours",
  rank = NULL
)

Checks

• All R CMD checks pass
• roxygen2::roxygenise() has been run prior to merging to ensure that .Rd and NAMESPACE files are up to date.
• NEWS.md has been updated.