Create a Research Project with R Markdown and rUM

Introduction

This is a collection of document templates, available through R, from your friends at the University of Miami (UM). \(R+UM=rUM\)

The rUM package will help you create research manuscripts by removing the configuration hassles commonly encountered when learning to write papers using R. rUM will initialize a new RStudio project and a Markdown file that includes the outline for a research paper. The Markdown file comes preconfigured with a YAML header (don’t worry if you don’t know what that means yet) with code chunks to load the tidyverse and conflicted packages. Manuscript sections have been created for Introduction, Methods, Results, Conclusion, and References. The project also includes a .gitignore file which is designed to help protect against accidentally leaking data when using git with websites like www.github.com.

rUM’s documentation can be found here:

How do I get RMarkdown and rUM? (Add a “quart o’ rUM”!)

  1. Modern version RStudio (v2022.07 or later) ships with R Markdown integrated into the RStudio IDE.

  2. Add rUM to your computer by:

    • using RStudio: click on the Packages tab in the bottom right windowpane, click the Install button, type rUM, and click Install.
    • downloading rUM from CRAN and installing it by running this code in R console:
    install.packages("rUM")
    • downloading the latest version of rUM from GitHub by running commands into the R console:
    if (!requireNamespace("remotes")) install.packages("remotes")
    remotes::install_github("RaymondBalise/rUM")
  3. Use rUM by running this in the console of RStudio:

library(rUM)

Ordering rUM from the Menu

To create a research project that uses rUM, follow these steps. This will initialize a new RStudio project that has an analysis.Rmd R Markdown file using the tidyverse and conflicted packages and some other useful files which are described below.

  1. Using the RStudio menus, choose: File > New Project > New Directory

  2. Scroll down and then select rUM Research Project Template

  3. Specify the location of where your research project will be saved

Add rUM into an existing folder/directory that does not have an RStudio project.

What if you have already created a folder containing the important files for your project? Create a new project in your existing folder! This will now be your project directory (complete with a .Rproj file).

  1. Navigate to File > New Project > Existing Directory

  2. Specify the location of where your research project will be saved

  3. Run the following script in your console:

# Change the text inside the quotes on the next line to indicate the path to your folder/directory.
PATH <- "~/Documents/blah"   

make_project(PATH, type = "R Markdown (analysis.Rmd)")

After your rUM has been served

A new project directory has been created and it will be populated with these files:

Newly created files:


analysis.Rmd:


rUM infused Markdown headers

  1. Navigate to File > New File > R Markdown