Quickly setup ‘SpaDES’ project directories, get modules, and deal with a number of issues related to reproducibility and reusabililty. This package was designed with a PERFICT approach in mind (See McIntire et al. 2022).

Why Choose This Package

Achieving PERFICT in your projects can be challenging, but it becomes more accessible with the use of SpaDES. The SpaDES.project tool is designed to streamline the setup of SpaDES projects. Complementing the R scripting language, there are three valuable tools at your disposal:

  1. Integrated Development Environment (IDE): This IDE encourages the organization of your work into projects, enhancing your workflow efficiency.
  2. Modular Coding Approach: Embrace a modular approach to coding, allowing for easier maintenance and collaboration.
  3. Version Control (Optional): For those interested in code development, SpaDES supports version control through platforms like GitHub, giving you control over project history and collaboration.

Our preferred toolset includes Posit (specifically, RStudio), SpaDES, and GitHub. While these are our recommendations, there are alternative options available. We acknowledge that not all users are familiar with Git, and that’s perfectly acceptable. SpaDES.project has been designed to cater to all users, whether they choose to use a Git-controlled project or not.

Project Challenges

Beyond these tools, our extensive experience in managing projects with diverse developers, operating systems, users, data sources, and packages has revealed various challenges. These challenges arise due to the nature of open, modular, and interoperable projects. As project complexity increases, typical reproducible workflows may falter. Issues include:

  • Variations in .Rprofile files.
  • Non-transferable file paths.
  • Incompatibilities between packages on different operating systems.
  • Conflicts between package versions.
  • Problems with the order of package loading and installation (e.g., inability to install a different version of a package while it’s already loaded).
  • Spaghetti code, where objects are defined in one file and used in another.
  • Differences in users’ familiarity with GitHub.
  • The presence of cryptic code and objects (“just run that line, don’t worry about what it does”).
  • Objects defined by a user lingering in the .GlobalEnv, leading to undetected issues.
  • Varying competencies among different users.

Given these complexities, it’s not enough to create a “reproducible” script; it must be a “reusable” script that functions flawlessly on any machine, operating system, and for any user.

Users can certainly attempt to address these issues individually, but we’ve developed SpaDES.project as a solution. It’s derived from our most intricate projects to date, yet it’s designed with beginners in mind. We’ve anticipated these challenges so that users won’t encounter them unexpectedly during their project journeys.

Getting Started

See this package readme and vignettes to get started.

  1. Getting started vignette
  2. Using git and GitHub
  3. Installing R
  4. Finding other SpaDES modules

Website: https://SpaDES.PredictiveEcology.org

Wiki: https://github.com/PredictiveEcology/SpaDES/wiki

Installation

Current stable release

R build status Codecov test coverage

Install from CRAN:

# Not yet on CRAN
# install.packages("SpaDES.project")

Development version (unstable)

R build status Codecov test coverage

install.packages("SpaDES.project", repos = c("predictiveecology.r-universe.dev", getOption("repos")))

Get modules in a new project

setupProject(paths = list(projectPath = tempdir()),
             modules = c("PredictiveEcology/Biomass_borealDataPrep@development",
                         "PredictiveEcology/Biomass_core@development"))

More examples

See Getting Started Vignette

Contributions

Please see CONTRIBUTING.md for information on how to contribute to this project.