Simplified Vertex-Wise Analyses of Whole-Brain and Subcortical Surface
Overview
Provides functions to run statistical analyses on surface-based neuroimaging data, computing measures including cortical thickness and surface area of the whole-brain and of the hippocampi. It can make use of 'FreeSurfer', 'fMRIprep', 'XCP-D', 'HCP' and 'CAT12' preprocessed datasets, 'HippUnfold' hippocampal outputs and 'SubCortexMesh' subcortical outputs for a given sample by restructuring the data values into a single file. The single file can then be used by the package for analyses independently from its base dataset and without need for its access.
NEW FEATURES
- New decode_surf_data() function now uses internal R data and code to do the decoding, reproducing NiMARE's ROIAssociationDecoder without calling the python module. It was tested on Example 1, yielding identical results for less than half the original duration.
- SCMvextract() is now much faster with more preloaded tables/lists and a different way of extracting the scalars
- Silent parameter and end messaging added to HIPvextract().
FIXES
- Extraction functions now fail prematurely if the filename argument given has a non-existent path, instead of failing after the full matrix is built.
From NEWS.md in the release
Install
Health
ERRORexamplesr-patched-linux-x86_64
Running examples in ‘VertexWiseR-Ex.R’ failed
The error most likely occurred in:
> base::assign(".ptime", proc.time(), pos = "CheckExEnv")
> ### Name: RFT_vertex_analysis
> ### Title: Vertex-wise analysis with random field theory cluster correction
> ### Aliases: RFT_vertex_analysis
>
> ### ** Examples
>
> demodata = readRDS(system.file('demo_data/SPRENG_behdata_site1.rds',
+ package = 'VertexWiseR'))[1:100,]
> CTv = readRDS(file = url(paste0("https://github.com",
+ "/CogBrainHealthLab/VertexWiseR/blob/main/inst/demo_data/",
+ "SPRENG_CTv_site1.rds?raw=TRUE")))[1:100,]
Warning in readRDS(file = url(paste0("https://github.com", "/CogBrainHealthLab/VertexWiseR/blob/main/inst/demo_data/", :
cannot open URL 'https://github.com/CogBrainHealthLab/VertexWiseR/blob/main/inst/demo_data/SPRENG_CTv_site1.rds?raw=TRUE': HTTP status was '503 Service Unavailable'
Error in readRDS(file = url(paste0("https://github.com", "/CogBrainHealthLab/VertexWiseR/blob/main/inst/demo_data/", :
cannot open the connection to 'https://github.com/CogBrainHealthLab/VertexWiseR/blob/main/inst/demo_data/SPRENG_CTv_site1.rds?raw=TRUE'
Execution halted- ERROR12 OK, 1 ERRORNow
- ERROR10 OK, 3 ERROR2026-10-15
- OK13 OK2026-10-14
- ERROR12 OK, 1 ERROR2026-10-13
- OK13 OK2026-10-04
- ERROR12 OK, 1 ERROR2026-10-03
Show 15 earlier changesHide 15 earlier changes
- OK13 OK2026-09-08
- ERROR12 OK, 1 ERROR2026-09-07
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-07-08
- ERROR12 OK, 1 ERROR2026-07-07
- OK13 OK2026-06-27
- ERROR11 OK, 2 ERROR2026-06-21
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK13 OK2026-05-30
- ERROR12 OK, 1 ERROR2026-05-29
- OK14 OK2026-04-10
- ERROR13 OK, 1 ERROR2026-04-09
- OK14 OK2026-03-10
Documentation
- Help pages
- 36
- Examples that run
- 100%25 run in a plain check
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 96%
- Help pages citing references
- 0%
- Example analyses with VertexWiseR - Example 1 HTML
- Example analyses with VertexWiseR - Example 1 HTML
- Example analyses with VertexWiseR - Example 2 HTML
- Example analyses with VertexWiseR - Example 2 HTML
- Example analyses with VertexWiseR - Example 3 HTML
- Example analyses with VertexWiseR - Example 3 HTML
- Extracting surface data in VertexWiseR HTML
- Extracting surface data in VertexWiseR HTML
- Overlaying plots and transparent thresholding HTML
- Overlaying plots and transparent thresholding HTML
Show 2 moreHide 2 vignettes
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 18
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Issues over time
Commits over time
3 development-tooling and community-health practices detected across 2 families in the upstream repository
Checks run against github.com/cogbrainhealthlab/vertexwiser on 2026-10-11.
GitHub Pages site last deployed 2026-09-25
pkgdown site last built 2026-09-24, before release 1.5.5 (2026-10-16)
Dependencies
Installing VertexWiseR adds 82 packages (40 with compiled code, 75 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, data.table 5.7 MB.
CRAN will archive these unless their check problems are fixed by the date shown. This package needs each one to install.
- freesurferformatsfix by Oct 20
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 1.5.5Latest
- 1.5.42026-09-16 · diff ↗
- 1.5.32026-09-03 · diff ↗
- 1.5.2
- RR 4.6.0 released · 2026-04-24
- 1.5.1
- 1.5.0
- 1.4.52025-12-15 · diff ↗
- 1.4.42025-12-04 · diff ↗
- 1.4.32025-10-21 · diff ↗
- 1.4.22025-10-01 · diff ↗
- 1.4.12025-08-19 · diff ↗
- 1.4.0
- 1.3.22025-06-11 · diff ↗
- 1.3.12025-04-14 · diff ↗
- RR 4.5.0 released · 2025-04-11
Show 7 earlier eventsHide 7 earlier events
- 1.3.02025-03-18 · diff ↗
- 1.2.12025-03-10 · diff ↗
- 1.2.0
- 1.1.0
- 1.0.12024-09-06 · diff ↗ ·
removed 4 exports
TFCE.threshold, TFCE.vertex_analysis, TFCE.vertex_analysis.mixed, vertex_analysisadded 6 exports
FSLRvextract, RFT_vertex_analysis, TFCE_threshold, TFCE_vertex_analysis, TFCE_vertex_analysis_mixed, fs_stats - 1.0.02024-06-13
- RR 4.4.0 released · 2024-04-24
Package metadata
- First published
- 2024-06-13
- Total releases
- 20 / 2 yrs
- License
- GPL-3 OSI
- Minimum R
- ≥ 4.0.0
- Bundled data
- 885 KB / 8 files
- Download size
- 2.4 MB
Cite
Cite this package
Run in R for the authors' entry:
citation("VertexWiseR")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.1162/imag_a_00372.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-18, which the citation names so these numbers can be found later. More on citing and the projects behind them.