bruceR

BRoadly Useful Convenient and Efficient R functions that BRing Users Concise and Elegant R data analyses.

This package includes easy-to-use functions for (1) basic R programming (e.g., set working directory to where the current file is, print strings with rich formats and colors); (2) multivariate computation (e.g., compute scale sums/means/... with reverse scoring); (3) reliability and factor analyses; (4) descriptive statistics and correlation analyses; (5) multi-factor analysis of variance (ANOVA), simple-effect analysis, and post-hoc multiple comparison; (6) tidy report of regression models and other results (to R Console and MS Word); (7) mediation and moderation analyses; and (8) additional toolbox for statistics and graphics.

Author

包寒吴霜 | Bao H.-W.-S.

E-mail: baohws@foxmail.com

Website: psychbruce.github.io

ResearchGate | GitHub | 知乎

Citation

• Bao, H.-W.-S. (2021). bruceR: Broadly useful convenient and efficient R functions. R package version 0.x.x. https://CRAN.R-project.org/package=bruceR or https://github.com/psychbruce/bruceR

User Guide

Release Notes

Installation

## Method 1: Install from CRAN
install.packages("bruceR")

## Method 2: Install from GitHub
install.packages("devtools")
devtools::install_github("psychbruce/bruceR", force=TRUE, upgrade=FALSE)

Tips:

1. Please restart (close and reopen) RStudio before installation.
2. If you see a dialog asking "Do you want to install from sources the package which needs compilation?", it would be better to choose "No" (to save your time).
3. If you fail to install, please read carefully the warning messages and find out the key R package(s) causing the failure, manually uninstall and reinstall these R package(s), and then retry the main installation.
4. It would be better to update R to its latest version (v4.0+).
5. It would be better to download and install Rtools.exe on Windows system.

Package Dependency

bruceR depends on many important R packages.

Loading bruceR by library(bruceR) will also load these R packages for you:

• [Data]:

  • rio: Data import and export (for all file formats).
  • dplyr: Data manipulation and processing.
  • tidyr: Data cleaning and reshaping.
  • stringr: Toolbox for string operation (with regular expressions).
  • forcats: Toolbox for factor manipulation (for categorical variables).
  • data.table: Advanced data.frame with higher efficiency.

• [Stat]:

  • psych: Toolbox for psychological and psychometric research.
  • emmeans: Toolbox for estimated marginal means and contrasts.
  • effectsize: Indices of effect size and standardized parameters.
  • performance: Assessment of regression models performance.

• [Plot]:

  • ggplot2: Data visualization.
  • ggtext: Markdown/HTML rich text format for ggplot2 (geoms and themes).
  • cowplot: Advanced toolbox for ggplot2 (arrange multiple plots and add labels).
  • see: Advanced toolbox for ggplot2 (geoms, scales, themes, and color palettes).

Main Functions in bruceR

1. Basic R Programming

   • set.wd()
   • pkg_depend(), pkg_install_suggested()
   • formatF(), formatN()
   • Print(), Glue(), Run()
   • %^%
   • %notin%
   • %allin%, %anyin%, %nonein%, %partin%

2. Multivariate Computation

   • SUM(), MEAN(), STD(), MODE(), COUNT(), CONSEC()
   • RECODE(), RESCALE(), RANDBETWEEN()
   • LOOKUP()

3. Reliability and Factor analyses

   • Alpha()
   • EFA()
   • CFA()

4. Descriptive Statistics and Correlation Analyses

   • Describe()
   • Freq()
   • Corr()
   • cor_diff()

5. Multi-Factor ANOVA, Simple-Effect Analysis, and Post-Hoc Multiple Comparison

   • MANOVA()
   • EMMEANS()

6. Tidy Report of Regression Models

   • model_summary()
   • GLM_summary()
   • HLM_summary()
   • HLM_ICC_rWG()
   • regress()

7. Mediation and Moderation Analyses

   • med_summary()
   • PROCESS() (coming soon...)

8. Additional Toolbox for Statistics and Graphics

   • grand_mean_center()
   • group_mean_center()
   • ccf_plot()
   • granger_test()
   • granger_causality()
   • theme_bruce()
   • show_colors()

Function Output

Some functions in bruceR allow table output to Microsoft Word (by setting file="xxx.doc" in the function).

Examples:

## Correlation analysis (and descriptive statistics)
Corr(airquality, file="cor.doc")

## Regression analysis
lm1=lm(Temp ~ Month + Day, data=airquality)
lm2=lm(Temp ~ Month + Day + Wind + Solar.R, data=airquality)
model_summary(list(lm1, lm2), file="reg.doc")
model_summary(list(lm1, lm2), std=TRUE, file="reg_std.doc")

Learn More From Help Pages

library(bruceR)

## Overview
help("bruceR")
help(bruceR)
?bruceR

## See help pages of functions
## (use `?function` or `help(function)`)
?set.wd
?Describe
?Freq
?Corr
?Alpha
?MEAN
?MANOVA
?EMMEANS
?model_summary
?med_summary
?GLM_summary
?HLM_summary
...