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 the path of currently opened file, import/export data from/to files with any format, print strings with rich formats and colors); (2) multivariate computation (e.g., compute scale sums/means/... with reverse scoring); (3) reliability analyses and factor analyses (PCA, EFA, CFA); (4) descriptive statistics and correlation analyses; (5) t-test, multi-factor analysis of variance (ANOVA), simple-effect analysis, and post-hoc multiple comparison; (6) tidy report of statistical models (to R Console and Microsoft Word); (7) mediation and moderation analyses (PROCESS); 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. (2022). bruceR: Broadly useful convenient and efficient R functions. R package version 0.8.x. https://CRAN.R-project.org/package=bruceR

User Guide

NEWS (GitHub version)

Chinese Documentation for bruceR: I. Overview

Chinese Documentation for bruceR: II. FAQ

Installation

## Method 1: Install from CRAN
install.packages("bruceR")
update.packages(ask=FALSE)

## Method 2: Install from GitHub
install.packages("devtools")
devtools::install_github("psychbruce/bruceR", force=TRUE)
update.packages(ask=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]:

  • 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]:

  • emmeans: Estimates of marginal means and multiple contrasts.
  • effectsize: Estimates of effect sizes and standardized parameters.
  • performance: Estimates of regression models performance.
  • lmerTest: Tests of linear mixed effects models (LMM, also known as HLM and multilevel models).

• [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() (alias: set_wd())
   • import(), export()
   • cc()
   • pkg_depend(), pkg_install_suggested()
   • formatF(), formatN()
   • print_table()
   • Print(), Glue(), Run()
   • %^%
   • %notin%
   • %allin%, %anyin%, %nonein%, %partin%

2. Multivariate Computation

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

3. Reliability and Factor Analyses

   • Alpha()
   • EFA() / PCA()
   • CFA()

4. Descriptive Statistics and Correlation Analyses

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

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

   • TTEST()
   • MANOVA()
   • EMMEANS()

6. Tidy Report of Regression Models

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

7. Mediation and Moderation Analyses

   • PROCESS()
   • med_summary()

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

For some functions, the results can be saved to Microsoft Word using the file argument.

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
?import
?export
?Describe
?Freq
?Corr
?Alpha
?MEAN
?RECODE
?TTEST
?MANOVA
?EMMEANS
?PROCESS
?model_summary
?lavaan_summary
?GLM_summary
?HLM_summary
...