Create a new ggseg atlas package — setup_atlas

Scaffold an R package for distributing a brain atlas. Downloads a modern template from the ggseg-atlas-template GitHub repository and customises it for your atlas. The generated package follows ggseg conventions and includes GitHub Actions workflows, pkgdown configuration, a test suite, and a multi-method scaffold for building your atlas.

Usage

setup_atlas_repo(
  path,
  atlas_name = NULL,
  open = rlang::is_interactive(),
  rstudio = TRUE
)

Arguments

path: Where to create the package. If the directory exists, it must be empty.
atlas_name: Name of the atlas (lowercase, no spaces). The package name becomes ggseg{AtlasName}. If NULL, derived from the directory name (e.g., path ggsegDkt becomes atlas name dkt).
open: If TRUE, opens the new project in RStudio. Default is TRUE when running interactively.
rstudio: If TRUE, creates an .Rproj file for RStudio users.

Value

Invisibly returns the path to the created package.

Details

The package will be named ggseg{AtlasName} (e.g., ggsegSchaefer for a Schaefer parcellation). After creation, edit the files in data-raw/ to build your atlas, then run devtools::document() and devtools::check().

If the template cannot be downloaded (e.g. no internet), a minimal bundled fallback is used instead. The fallback omits GitHub Actions workflows; you can copy them from the template repository later.

Examples

if (FALSE) { # \dontrun{
# Create atlas package in a new directory
setup_atlas_repo("ggsegDkt", "dkt")

# Create in current directory, derive name from path
setup_atlas_repo("ggsegMyatlas")

# Specify full path
setup_atlas_repo("~/projects/ggsegSchaefer", "schaefer")

# Without opening in RStudio
setup_atlas_repo("ggsegHarvard", "harvard", open = FALSE)
} # }