filtering

Filtering Model Doc

Overview

Filtering is a classical non-deep-learning method for neuroimaging signal denoising.

• Model family: non-deep-learning preprocessing and denoising method
• Typical objectives:
  • remove unwanted frequency content from BOLD time series
  • retain frequency bands relevant to resting-state or task analysis
  • prepare cleaner voxel-wise or ROI-wise time series for downstream connectivity, decoding, or statistical analysis
• Primary input: preprocessed fMRI time series, optional confounds, optional mask, TR
• Primary output: denoised BOLD image, cleaned ROI time series, optional QC summaries

In NeuroClaw, this document is model-level guidance for temporal filtering workflows rather than predictive modeling.

Upstream preparation should usually be delegated to:

• fmri-skill for modality-level denoising planning and validated preprocessing sequences
• nilearn-tool for concrete filtering and cleaned image export

Research use only.

---

Quick Start

1) Prepare denoising inputs

Expected inputs:

• preprocessed BOLD image
• repetition time (TR)
• optional confounds TSV
• optional brain mask
• optional requested frequency band

If images are not preprocessed yet, delegate to fmri-skill first.

2) Filtering route

Representative operations:

• load preprocessed BOLD time series
• apply temporal high-pass / low-pass or band-pass filtering
• optionally combine filtering with standardization or confound regression
• export denoised image and cleaned summaries

Example execution route:

# delegated through claw-shell after preprocessing is confirmed
python skills/nilearn-tool/scripts/preprocess_bold_reference.py \
  --bold path/to/sub-001_rest_preproc_bold.nii.gz \
  --tr 2.0 \
  --high-pass 0.01 \
  --low-pass 0.08 \
  --output run_models_output/filtering/sub-001_rest_filtered_bold.nii.gz

---

Input / Output Contract

Required inputs

• preprocessed BOLD image or extracted time series
• TR for temporal filtering