Tools for Reading, Writing, Viewing and Manipulating CIFTI Files
Overview
CIFTI files contain brain imaging data in "grayordinates," which represent the gray matter as cortical surface vertices (left and right) and subcortical voxels (cerebellum, basal ganglia, and other deep gray matter). 'ciftiTools' provides a unified environment for reading, writing, visualizing and manipulating CIFTI-format data. It supports the "dscalar," "dlabel," and "dtseries" intents. Grayordinate data is read in as a "xifti" object, which is structured for convenient access to the data and metadata, and includes support for surface geometry files to enable spatially-dependent functionality such as static or interactive visualizations and smoothing.
Install
Health
ERRORre-building of vignette outputsr-oldrel-macos-arm64, r-oldrel-macos-x86_64, r-release-macos-arm64, r-release-macos-x86_64
r-oldrel-macos-arm64
Error(s) in re-building vignettes:
--- re-building ‘ciftiTools_vignette_mini.Rmd’ using rmarkdown
2026-10-18 16:44:54.979 R[38810:364865] XType: Using static font registry.
Quitting from ciftiTools_vignette_mini.Rmd:85-92 [unnamed-chunk-7]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/rlang_error>
Error in `knitr::include_graphics()`:
! Cannot find the file(s): "../../../../../../../../../Temp/tmp/RtmpidncMr/file979afe50f74.png"
---
Backtrace:
▆
1. └─knitr::include_graphics(xii_plt, dpi = 200)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Error: processing vignette 'ciftiTools_vignette_mini.Rmd' failed with diagnostics:
Cannot find the file(s): "../../../../../../../../../Temp/tmp/RtmpidncMr/file979afe50f74.png"
--- failed re-building ‘ciftiTools_vignette_mini.Rmd’
SUMMARY: processing the following file failed:
‘ciftiTools_vignette_mini.Rmd’
Error: Vignette re-building failed.
Execution haltedr-oldrel-macos-x86_64
Error(s) in re-building vignettes:
--- re-building ‘ciftiTools_vignette_mini.Rmd’ using rmarkdown
Quitting from ciftiTools_vignette_mini.Rmd:85-92 [unnamed-chunk-7]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/rlang_error>
Error in `knitr::include_graphics()`:
! Cannot find the file(s): "../../../../../../../../../Temp/tmp/Rtmp2xSJXq/fileb712147a63c3.png"
---
Backtrace:
▆
1. └─knitr::include_graphics(xii_plt, dpi = 200)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Error: processing vignette 'ciftiTools_vignette_mini.Rmd' failed with diagnostics:
Cannot find the file(s): "../../../../../../../../../Temp/tmp/Rtmp2xSJXq/fileb712147a63c3.png"
--- failed re-building ‘ciftiTools_vignette_mini.Rmd’
SUMMARY: processing the following file failed:
‘ciftiTools_vignette_mini.Rmd’
Error: Vignette re-building failed.
Execution haltedr-release-macos-arm64
Error(s) in re-building vignettes:
--- re-building ‘ciftiTools_vignette_mini.Rmd’ using rmarkdown
Quitting from ciftiTools_vignette_mini.Rmd:85-92 [unnamed-chunk-7]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/rlang_error>
Error in `knitr::include_graphics()`:
! Cannot find the file(s): "../../../../../../../../../Temp/tmp/RtmpsMf1Lo/file34621c91b7c9.png"
---
Backtrace:
▆
1. └─knitr::include_graphics(xii_plt, dpi = 200)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Error: processing vignette 'ciftiTools_vignette_mini.Rmd' failed with diagnostics:
Cannot find the file(s): "../../../../../../../../../Temp/tmp/RtmpsMf1Lo/file34621c91b7c9.png"
--- failed re-building ‘ciftiTools_vignette_mini.Rmd’
SUMMARY: processing the following file failed:
‘ciftiTools_vignette_mini.Rmd’
Error: Vignette re-building failed.
Execution haltedr-release-macos-x86_64
Error(s) in re-building vignettes:
--- re-building ‘ciftiTools_vignette_mini.Rmd’ using rmarkdown
Quitting from ciftiTools_vignette_mini.Rmd:85-92 [unnamed-chunk-7]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
<error/rlang_error>
Error in `knitr::include_graphics()`:
! Cannot find the file(s): "../../../../../../../../../Temp/tmp/RtmpK5sQwX/file52833a8c58d.png"
---
Backtrace:
▆
1. └─knitr::include_graphics(xii_plt, dpi = 200)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Error: processing vignette 'ciftiTools_vignette_mini.Rmd' failed with diagnostics:
Cannot find the file(s): "../../../../../../../../../Temp/tmp/RtmpK5sQwX/file52833a8c58d.png"
--- failed re-building ‘ciftiTools_vignette_mini.Rmd’
SUMMARY: processing the following file failed:
‘ciftiTools_vignette_mini.Rmd’
Error: Vignette re-building failed.
Execution halted- ERROR9 OK, 4 ERRORNow
- ERROR8 OK, 2 NOTE, 3 ERROR2026-09-10
- NOTE12 OK, 1 NOTE2026-07-11
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
- OK12 OK2026-04-25
Show 1 earlier changeHide 1 earlier change
- NOTE11 OK, 3 NOTE2026-03-10
Documentation
- Help pages
- 193 (113 internal)includes a package overview page
- Examples that run
- 0%1 never run
- Exported functions with examples
- 1%
- Documented parameters
- 81%
- Return-value docs
- 97%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 93%
- Median days to close, 50 most recently updated closed issues
- 4
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
Commit identities over time
8 development-tooling and community-health practices detected across 6 families in the upstream repository
Checks run against github.com/mandymejia/ciftitools on 2026-10-11.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
Show all practicesHide 2 practices
Dependencies
Installing ciftiTools adds 44 packages (24 with compiled code, 42 MB of source tarballs). Heaviest: bslib 5.6 MB, oro.nifti 5.0 MB, rgl 4.0 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 0.21.1Latest
- RR 4.6.0 released · 2026-04-24
- 0.19.02026-03-19 · diff ↗
- 0.18.02025-12-20 · diff ↗
- RR 4.5.0 released · 2025-04-11
- 0.17.4
- 0.16.1
- 0.15.12024-06-25 · diff ↗
- RR 4.4.0 released · 2024-04-24
- 0.14.02024-02-24 · diff ↗
- 0.13.42024-01-21 · diff ↗ ·
added 11 exports
convert_to_dlabel, convert_to_dscalar, convert_to_dtseries, parc_add_subcortex, parc_vals_to_xifti, remapCIfTI, remap_cifti, remap_gifti, remap_xifti, remapcii, surf_area - 0.12.2
- RR 4.3.0 released · 2023-04-21
- 0.11.02023-01-23 · diff ↗ ·
removed 1 export
unmask_cortexadded 5 exports
boundary_mask_surf, dilate_mask_surf, edit_mask_surf, erode_mask_surf, mask_surf - 0.10.22022-07-01 · diff ↗
- 0.9.02022-05-16 · diff ↗
Show 10 earlier eventsHide 10 earlier events
- RR 4.2.0 released · 2022-04-22
- 0.8.0
- 0.7.0
- 0.6.12021-09-16 · diff ↗
- 0.4.32021-08-19 · diff ↗ ·
removed 2 exports
demo_files, unmask_voladded 9 exports
apply_xifti, ciftiTools.files, fix_xifti, load_parc, load_surf, move_from_mwall, move_to_mwall, unmask_subcortex, write_surf - 0.3.12021-06-17 · diff ↗ ·
removed 4 exports
concat_xifti, convert_to_dlabel, convert_to_dscalar, gifti_to_surfadded 8 exports
combine_xifti, convert_xifti, merge_xifti, read_surf, read_xifti2, smoothGIfTI, smooth_gifti, smoothgii - RR 4.1.0 released · 2021-05-18
- 0.2.22021-03-16 · diff ↗ ·
added 10 exports
concat_xifti, convert_to_dlabel, convert_to_dscalar, newdata_xifti, remove_xifti, rotate_surf, run_wb_cmd, select_xifti, smooth_xifti, transform_xifti - 0.1.6.02020-11-20
- RR 4.0.0 released · 2020-04-24
Package metadata
- First published
- 2020-11-20
- Total releases
- 19 / 6 yrs
- License
- GPL-3 OSI
- Minimum R
- ≥ 3.5.0
- Download size
- 5.2 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("ciftiTools")The package provides a citation file that builds its entry when R runs it. Run citation() to see it.
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.