org

Overview

org is a framework for organizing R projects with a standardized structure. It helps manage the three main components of most analyses:

• Code: Version-controlled analysis scripts
• Results: Date-organized output files
• Data: Securely stored input data

Each component has specific requirements and best practices that org helps enforce. The package provides tools to:

• Set up and manage project directories
• Handle file paths consistently across operating systems
• Manage results with date-based organization
• Source code from specified directories
• Create and manage Quarto documents
• Handle file operations safely

Installation

From CRAN

install.packages("org")

Development Version

To install the development version or access packages that haven’t been released on CRAN:

1. Edit your .Rprofile:

usethis::edit_r_profile()

2. Add the following configuration:

options(
  repos = structure(c(
    CSVERSE = "https://www.csids.no/drat/",
    CRAN    = "https://cran.rstudio.com"
  ))
)

3. Restart R and install:

install.packages("org")

Getting Started

1. Read the introduction vignette
2. Run help(package="org") for detailed function documentation

Quick Example

# Initialize a new project
org::initialize_project(
  env = .GlobalEnv,
  home = "/path/to/project",      # Contains Run.R and R/ folder
  results = "/path/to/results",   # Where results will be stored
  data_raw = "/path/to/data"      # Raw data location
)

# Access project settings
org::project$results_today  # Today's results folder
org::project$data_raw      # Raw data folder

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This package is licensed under the MIT License - see the LICENSE file for details.