hierarchical

Hierarchical Model Doc

Overview

Hierarchical clustering is a classical non-deep-learning method for data-driven brain parcellation.

• Model family: non-deep-learning unsupervised clustering method
• Typical objectives:
  • partition voxels, vertices, or ROI features into data-driven brain parcels
  • build subject-level or group-level parcellations from functional or structural similarity
  • export parcel labels and merge summaries across scales
• Primary input: preprocessed neuroimaging features, optional mask, optional similarity or connectivity representation
• Primary output: parcel label map, cluster summaries, optional dendrogram outputs

In NeuroClaw, this document is model-level guidance for Hierarchical-clustering-based brain parcellation workflows rather than supervised prediction.

Upstream preparation should usually be delegated to:

• fmri-skill for rs-fMRI or task-fMRI feature preparation when parcellation is function-driven
• smri-skill for structural feature preparation when parcellation is anatomy-driven
• nilearn-tool for concrete masking, feature matrix preparation, and hierarchical parcel export

Research use only.

---

Quick Start

1) Prepare parcellation inputs

Expected inputs:

• preprocessed feature matrix or image list
• optional brain mask
• optional subject list or cohort manifest
• target parcel number or clustering granularity

If these are not ready, delegate preprocessing to fmri-skill or smri-skill first.

2) Hierarchical route

Representative operations:

• prepare aligned feature representation
• compute similarity or distance structure across spatial units
• fit agglomerative / Ward-style hierarchical clustering
• export parcel labels and optional dendrogram or merge summaries

Example execution route:

# delegated through claw-shell after features are prepared
python skills/nilearn-tool/scripts/hierarchical_parcellation_reference.py \
  --input-list path/to/image_list.txt \
  --mask path/to/group_mask.nii.gz \
  --n-clusters 200 \
  --output-dir run_models_output/hierarchical