- Change
read_preproc_scans()to return a file-ordered list ofNeuroVecobjects, one per matched preprocessed scan, instead of collapsing multiple files into a single container. - Fix derivative discovery and legacy fMRIPrep helpers for datasets that place
derivative subject folders directly under
derivatives/withprep_dir = "derivatives". - Make
read_confounds()raise informative, selection-aware errors when no matching participants, confound files, or usable requested confounds are found. - Fix
create_preproc_mask()to ignore matching JSON sidecars and only read actual NIfTI mask images. - Add
query_files()as the recommended explicit query API for new workflows, withmatch_mode,require_entity, and raw/derivativesscopecontrols. - Add
get_metadata()for inheritance-aware BIDS metadata resolution with deterministic nearest-sidecar precedence. - Extend
read_sidecar()with inheritance-aware resolution viainheritandinherit_scope. - Add permissive
bids_project(..., strict_participants = FALSE)loading for datasets that omitparticipants.tsv, while keeping compliance reporting explicit. - Add derivative discovery via
bids_project(..., derivatives = "auto")andderivative_pipelines(), while preserving legacyfmriprephelpers when an fMRIPrep pipeline is present. - Add persistent file indexing with
bids_index()and indexedquery_files()lookups. - Add
variables_table()andbids_report_data()/bids_report()for tidy run-level inventory and lightweight dataset reporting. - Expand acceptance coverage for metadata inheritance, missing-sidecar cases, conflict handling, and derivative-scope behavior.
- Keep
search_files()available for backward compatibility while steering new examples and docs towardquery_files().
- Fix
load_all_events()andread_events()to use tab delimiter for BIDS TSV event files instead of space delimiter. - Fix
read_sidecar()to handle JSON sidecars containing vector-valued fields (e.g.SliceTiming) by storing them as list-columns instead of failing with a "differing number of rows" error.
- TBD.
- Initial CRAN release.
- Read, validate, and query BIDS-compliant neuroimaging projects.
- Support for fMRIPrep derivatives including confound tables, preprocessed scans, and brain masks.
- Mock BIDS project creation for testing (
create_mock_bids()). - Confound processing with PCA reduction and canonical variable aliasing.
- Visualization of PCA confound scores and loadings (
plot.bids_confounds()). - Search and filter BIDS files by subject, session, task, run, space, and other entities.