rfriend

Overview

rfriend is an R package designed to streamline data analysis and statistical testing by wrapping complex or repetitive code into convenient, user-friendly functions prefixed with f_. Its primary focus is data exploration, statistical tests, and creating publication-ready output in multiple formats including PDF, Microsoft Word, and Excel.

The package helps you write shorter code while producing well-formatted summaries, visualizations, and statistical tests, automatically handling data transformations, assumption checking, and post hoc testing.

Features

• Summary Tables: f_summary() generates comprehensive summary tables.
• Data Transformations:
  • f_boxcox() for Box-Cox transformations (wrapping MASS/boxcox and rcompanion)
    
  • f_bestNormalize() wraps and extends normalization from the bestNormalize package.
• Visualizations: Easily create:
  • Boxplots (f_boxplot())
    
  • QQ-plots (f_qqnorm())
    
  • Histograms (f_hist())
    
  • Density plots
• Statistical Tests: Run and visualize tests on multiple variables and predictors, with automatic assumption checking and post hoc analysis:
  • ANOVA: f_aov()
    
  • Kruskal-Wallis: f_kruskal_test()
    
  • Generalized Linear Models: f_glm()
    
  • Chi-square Tests: f_chisq_test()
• Model Comparison: Compare models easily with f_model_comparison().
• Utilities:
  • f_clear() clears the workspace and restarts R.
    
  • f_setwd() sets working directory to the current script’s location.
    
  • f_theme() switches RStudio themes quickly.
    
  • f_factors() converts multiple dataframe columns to factors.

Installation

rfriend requires R (>= 4.4.0) and several dependencies (see DESCRIPTION for details). You can install the latest released version from CRAN with:

install.packages("rfriend")

If you want the latest development version (if available on GitHub):

# install.packages("devtools")

devtools::install_github("delde001/rfriend")

Basic Usage

library(rfriend)

# Summary of your dataset
  f_summary(your_dataframe)

# Run ANOVA on multiple response variables
  f_aov(response_var1 +  response_var1 ~ predictor1 * predictor2, data = your_dataframe)

# Create a boxplot of a variable
  data(mtcars)
  f_boxplot(hp + disp ~ gear*cyl,
             data=mtcars,
             boxplot_explanation = FALSE,
             output_type = "word"
             )

# Perform Box-Cox transformation
  transformed <- f_boxcox(your_dataframe$variable)

# Create a boxplot of a variable
  data(mtcars)
  f_boxplot(hp + disp ~ gear*cyl,
             data=mtcars,
             boxplot_explanation = FALSE,
             output_type = "word"
             )

# Perform Box-Cox transformation
transformed <- f_boxcox(your_dataframe$variable)

# Clear workspace and restart R
  f_clear()

For detailed usage and examples, please refer to the package vignettes and help files.

Known Issues

• When loading rfriend, you may see harmless warnings about S3 method overwrites related to nobs.fitdistr and nobs.multinom due to imported packages (MuMIn, rstatix). These do not affect the functionality.

Contributing

Contributions, bug reports, and feature requests are very welcome! Please open an issue or submit a pull request on GitHub.

Before contributing, please ensure:

• You have tested your changes locally.
• Code is properly documented using roxygen2.
• You follow the existing style and conventions.

License

This package is licensed under GPL-3.

Contact

Author and maintainer: Sander H. van Delden
Email: plantmind@proton.me

Feel free to reach out for support, feature requests, or collaborations.

Thank you for using rfriend!