convnextv2-atto-1k-224-galaxy10-decals-head-v2

facebook/convnextv2-atto-1k-224 adapted to galaxy morphology classification on Galaxy10 DECaLS (10 classes) by head-only fine-tuning (backbone frozen, linear head trained), under the revised protocol of the paper When foundation models meet astronomical data (Astronomy and Computing, revised version, 2026). One of the 80 configurations (40 pretrained backbones x two adaptation regimes) of the collection Vision Foundation Models Benchmark.

This repository contains the complete model: the backbone weights are those of the base checkpoint (frozen during training, including the statistics of its normalisation layers) and the classification head is the trained one.

Results (held-out test set, 1,774 images)

Scores are computed at the epoch of minimum validation loss. The per-epoch metrics of all runs, the tables of the paper and the data split are in the dataset vision-foundation-models-benchmark-runs.

Training protocol

• Data: Galaxy10 DECaLS (17,736 images). The public test split (1,774 images) is the held-out test set; the public train split is divided, with stratification by class, into 14,188 training and 1,774 validation images (indices in the dataset repository above). The validation set is used only to select the epoch.
• Recipe (identical for the 40 backbones): AdamW (betas 0.9/0.999, eps 1e-8, weight decay 0.1, gradient clipping 1.0), learning rate 1e-4, linear schedule with 10% warm-up, batches of 32 images with gradient accumulation over 8 steps (effective batch 256), 30 epochs, single precision (fp32, TF32 disabled), one GPU. Augmentation: random resized crop to the input resolution and random horizontal flip. Evaluation: resize and centre crop to 224x224 px, normalisation of the checkpoint's image processor. Seed 42 (seeds 1 and 2 give the mean and s.d. above).
• Regime: head-only fine-tuning (backbone frozen, linear head trained). The head is a single linear layer with ten outputs.
• Selection: epoch of minimum validation loss (epoch 30 here); the weights of this repository are those of that epoch.
• Software: PyTorch 2.3.0, transformers 4.37.2, datasets 2.19.1, torchvision 0.18.0.

Per-epoch metrics (seed 42)

How to use

from transformers import AutoImageProcessor, AutoModelForImageClassification
from torchvision.transforms import Compose, Resize, CenterCrop, ToTensor, Normalize

model = AutoModelForImageClassification.from_pretrained("matthieulel/convnextv2-atto-1k-224-galaxy10-decals-head-v2").eval()
processor = AutoImageProcessor.from_pretrained("matthieulel/convnextv2-atto-1k-224-galaxy10-decals-head-v2")
# Pre-processing used in the paper: resize and centre-crop to 224x224 px, then the processor's normalisation
transform = Compose([Resize(224), CenterCrop((224, 224)), ToTensor(), Normalize(processor.image_mean, processor.image_std)])
# logits = model(pixel_values=transform(image).unsqueeze(0)).logits

Integrity check

The model stored in this repository was reloaded and run on the first 96 test images: predictions identical to the saved logits of the selected epoch for 100.0% of them (maximum absolute logit difference 2.38e-06).

Citation

Paper under revision for Astronomy and Computing; citation to be completed upon publication.