fmri-bids
Inspect and audit BIDS fMRI datasets with bidser: inherited metadata, derivatives, events, confounds, and acquisition matching. Use for dataset discovery or analysis readiness; do not fit models or preprocess images.
- License 许可
- MIT
- 最近更新
- 2026-11-11
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- fmri-bids
- license
- MIT
- metadata
- { "version": "0.1.0", "reviewed": "2026-09-27" }
- description
- Inspect and audit BIDS fMRI datasets with bidser: inherited metadata, derivatives, events, confounds, and acquisition matching. Use for dataset discovery or analysis readiness; do not fit models or preprocess images.
- compatibility
- Requires local filesystem access; R for package execution and Python 3.10+ for optional helpers.
02 资源文件 18
- 参考文档agents/openai.yaml266 B
- 许可证LICENSE1.1 KB
- 参考文档references/artifact-contracts.md3.8 KB
- 参考文档references/capabilities.md2.7 KB
- 参考文档references/discovery.md4.4 KB
- 参考文档references/events-to-design.md9.9 KB
- 参考文档references/nifti-handoff.md9.9 KB
- 参考文档references/operating-contract.md5.1 KB
- 参考文档references/sources.md5.5 KB
- 参考文档references/timing-and-joins.md3.8 KB
- 参考文档references/trial-patterns-rsa.md4.9 KB
- 参考文档schemas/inventory.schema.json1.1 KB
- 参考文档schemas/plan.schema.json3.9 KB
- 参考文档schemas/preferences.schema.json1.4 KB
- 脚本scripts/discover_bids.R5.5 KB
- 脚本scripts/probe_capabilities.R2.7 KB
- 脚本scripts/profile_table.py3.2 KB
- 脚本scripts/workbench.py20.8 KB
03 SKILL.md 正文
BIDS discovery with bidser
Produce a traceable inventory and an analysis-readiness assessment before asking the user questions answered by files. This skill stands alone; group analysis and first-level fitting are not required.
For a new analysis, read the operating contract.
Use capability checks before relying on unfamiliar
installed arguments. Read the discovery procedure, then
use scripts/discover_bids.R for an initial file/metadata/header inventory. This
script is a first pass, not a BIDS validator or complete scientific audit.
Finish the timing and join checks explicitly.
Discover cheaply, then selectively inspect
Separate raw and derivative roots, pipeline/version, file representation, task,
subject, session, acquisition, direction, run, echo, space, and resolution/density.
Use bidser::query_files() with explicit scope and exact entity selection.
Resolve effective metadata with get_metadata(..., inherit=TRUE, provenance=TRUE) and retain its sources. Never ask for a TR already established
per acquisition; never silently take the first TR when values differ. Check
metadata against headers with units. Detect inherited events/sidecars, ambiguous
same-level sidecars, stale indexes, alternate representations, and missing files.
Inspect events and confounds locally: schema/units, timing origin, durations, condition counts, missingness, available confound sets, rows vs volumes, and nonsteady-state handling. Condition labels and metadata can suggest a task but cannot establish the user's hypothesis or contrast direction. Negative onsets and zero-duration events are not inherently invalid. Do not shift onsets merely because metadata records volumes discarded before the stored image.
For onboarding, use events to candidate designs to identify factors, modulators, phases and candidate contrasts from those files. Return evidence-backed proposals and remaining questions; proposing a design does not require fitting a model or inventing the study's primary hypothesis.
Match by meaning, not order
Use full acquisition keys and explicit projection rules for event/confound joins. One event file may legitimately serve several echoes; several BOLD representations must not become extra runs or subjects. Check cardinalities and exclusions. A mask and a space label are insufficient without grid/affine compatibility. Report unsupported CIFTI/surface, nonuniform timing, or other adapter limits rather than coercing data to a different representation without approval.
For the source-reviewed fmrireg importer, from_bids() is a convenience path,
not a universal discovery oracle: it orders by numeric run, selects the first TR,
and uses a single supplied mask. Certify its preconditions or create explicit
bindings through as_manifest() downstream. Do not send session/echo filters in
... and assume they filter scans; those arguments go to confounds.
Handoff
Write inventory/provenance, validation states, exact selections, unresolved scientific questions, and a concise dataset card. Use the artifact contract. Run the official BIDS validator locally when available and authorized; preserve version and structured findings. Missing validator or unchecked header/joins must remain "not checked". File discovery alone never certifies readiness. Only ask about gaps that affect the requested scope. Read only the applicable preference fields; do not save new preferences without explicit consent.
04 同仓库更多 Skills
neuromosaic
Create neuromosaic fMRI map montages, atlas-annotated cluster reports, or interactive explorers from existing statistical outputs. Use without refitting analyses; distinguish display thresholds from statistical inference.
fmrireg
Specify, diagnose, fit, or export first-level task-fMRI GLMs with fmrireg, including HRFs, nuisance baselines, contrasts, and native batch jobs. Use independently of group analysis and reports; not for preprocessing.
fmrigds
Build and validate group-level fMRI analyses with fmrigds from existing effect/statistic maps or tables: covariates, uncertainty, repeated measures, corrections, and cohort examination. Does not require first-level refitting.
fmri
Coordinate end-to-end task-fMRI analyses across BIDS discovery, fmrireg models, fmrigds group inference, and neuromosaic reports. Use for multi-stage analysis plans or execution, not a single-package question.
neuromosaic
Create neuromosaic fMRI map montages, atlas-annotated cluster reports, or interactive explorers from existing statistical outputs. Use without refitting analyses; distinguish display thresholds from statistical inference.
fmrireg
Specify, diagnose, fit, or export first-level task-fMRI GLMs with fmrireg, including HRFs, nuisance baselines, contrasts, and native batch jobs. Use independently of group analysis and reports; not for preprocessing.