Fast AR and ARMA Noise Whitening for Functional MRI (fMRI) Design and Data
Overview
Lightweight utilities to estimate autoregressive (AR) and autoregressive moving average (ARMA) noise models from residuals and apply matched generalized least squares to whiten functional magnetic resonance imaging (fMRI) design and data matrices. The ARMA estimator follows a classic 1982 approach doi:10.1093/biomet/69.1.81, and a restricted AR family mirrors workflows described by Cox (2012) doi:10.1016/j.neuroimage.2011.08.056.
fit_noise()gains acensorparameter for motion scrubbing support. Censored timepoints (e.g., frames with high framewise displacement) are excluded from AR parameter estimation. Accepts either integer indices or a logical vector. The time series is segmented at censor points and ACVF is pooled across valid segments with proper length-weighting.whiten()now passescensorto bothfit_noise()andwhiten_apply().- The returned
fmriAR_planobject now includes thecensorindices for downstream reference. - Fixed a bug where
fit_noise(method = "ar", p = <integer>)could ignore the requested fixed AR order and still perform order selection, sometimes returning a different order. - Fixed parcel-mode AR fitting so fixed-order requests only trigger multiscale pooling when that mode is explicitly requested, preserving the expected non-multiscale behavior by default.
Show all changes in 0.3.2Hide the rest of the changes in 0.3.2
- Fixed the parcel
pacf_weightedmultiscale path forp_target = 1, where a dimension drop could break coefficient averaging.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK12 OK2026-04-25
- ERROR13 OK, 1 ERROR2026-04-17
- OK14 OK2026-03-10
Documentation
- Help pages
- 9 (2 internal)includes a package overview page
- Examples that run
- 100%8 run in a plain check
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- not measured
- Median days to close, 50 most recently updated closed PRs
- not measured
Issues over time
PRs over time
7 development-tooling and community-health practices detected across 3 families in the upstream repository
Checks run against github.com/bbuchsbaum/fmriar on 2026-10-25.
The R CMD check workflow runs on Linux, macOS and Windows
GitHub Pages site last deployed 2026-10-11 · The repository has a site deploy workflow
pkgdown site last built 2026-10-11
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2025-09-18Seen in the repository: CLAUDE.mdNamed in .Rbuildignore: .claude, CLAUDE.mdPull request it wrote: opened by a project memberCommits: 7 by its own account · at least 31 crediting it in the message
- Cursorfirst seen 2026-08-07Pull request it wrote: opened by a project memberCommits: 4 by its own account
- Claude Fable 519 commits · Aug 2026
- Claude Opus 5.57 commits · Oct 2026
- Claude Opus 4.52 commits · Jan 2026
Dependencies
Installing fmriAR adds 2 packages (2 with compiled code, 2.8 MB of source tarballs). Heaviest: Rcpp 1.8 MB, RcppArmadillo 1.0 MB.
Code & Tests
People & History
Package metadata
- First published
- 2025-11-03
- Total releases
- 3 / 1 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 4.0
- Download size
- 131 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("fmriAR")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-26, which the citation names so these numbers can be found later. More on citing and the projects behind them.