scalesurfer-stats

ScaleSurfer v567 (combined FreeSurfer 5/6/7) Stats Prediction Model

This repository contains a ScaleSurfer multi-head model for predicting FreeSurfer-style .stats targets from a T1w image and an aparc+aseg segmentation.

The v567 stats model uses the frozen combined ScaleSurfer v567 encoder and is trained on all available stats targets across FreeSurfer versions. The encoder itself starts from the original cross-entropy ScaleSurfer checkpoint and was continued with the FastSurferCNN v2.5.4-style soft-Dice plus weighted cross-entropy objective. Only the stats heads are initialized from the earlier all-data stats model; the legacy encoder weights are not loaded.

Files

• stats_model.safetensors: model weights and inference metadata in safetensors format.
• config.json: architecture and feature-schema metadata needed by ScaleSurferStatsPredictor.
• metadata.json: checksums and training/evaluation metadata.
• summary.csv, history.csv, target_metrics.csv: copied training diagnostics.

Test Summary

Loading

from scalesurfer.stats import ScaleSurferStatsPredictor

predictor = ScaleSurferStatsPredictor.from_pretrained()
features = predictor.predict_subjects(subjects_dir, subjects, return_format="wide")

This model is intended for research workflows and is not a clinical diagnostic device.