timm documentation

HieraDet (SAM 2)

You are viewing main version, which requires installation from source. If you'd like regular pip install, checkout the latest stable version (v1.0.30).
Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

HieraDet (SAM 2)

Category: ViT · Code: timm/models/hieradet_sam2.py · Architectures: 5 · Pretrained weights: 8 (0 with ImageNet-1k results)

HieraDet, the Hiera based image encoder of Segment Anything 2 (SAM 2), with windowed attention and windowed position embeddings.

Papers

Usage

See the Quickstart for loading pretrained weights, image preprocessing and fine-tuning, and Feature Extraction for using the models as backbones.

>>> import timm
>>> model = timm.create_model('sam2_hiera_base_plus.fb_r896', pretrained=True)
>>> data_config = timm.data.resolve_model_data_config(model)

Model API support

FeatureHieraDet
features_only=True feature maps✓ (strides 4, 8, 16, 32)
forward_intermediates()✓
prune_intermediate_layers()✓
Any input size, no changes needed✓
set_input_size()–
dynamic_img_size=True–
set_grad_checkpointing()✓
Layer-wise LR decay (group_matcher())✓
reset_classifier()✓

✓ supported, ✓ (square) works for square sizes only, ✗ not supported, – not needed (the model already accepts any input size). Checked by running each feature on a randomly initialized model (HieraDet with sam2_hiera_tiny at 256), other architectures of the same class are expected to behave the same. See the Model API page for details.

Architectures

ArchitectureParams (M)GMACsInput sizePretrained weights
hieradet_small34.738.512560
sam2_hiera_base_plus68.68227.488962
sam2_hiera_large212.15907.4810242
sam2_hiera_small33.95123.998962
sam2_hiera_tiny26.8599.868962

GMACs and parameter counts are for the default input size and classifier of each architecture, from the benchmark results.

Pretrained weights

Top-1 is ImageNet-1k validation accuracy from results-imagenet.csv at the listed eval size, - if the weight has no ImageNet-1k result (e.g. pretraining or image-text weights). Classes is the size of the pretrained classifier, none for weights without one.

WeightInput sizeTop-1 (%)Eval sizeClassesLicenseHub
sam2_hiera_base_plus.fb_r896896--noneapache-2.0timm
sam2_hiera_base_plus.fb_r896_2pt1896--noneapache-2.0timm
sam2_hiera_large.fb_r10241024--noneapache-2.0timm
sam2_hiera_large.fb_r1024_2pt11024--noneapache-2.0timm
sam2_hiera_small.fb_r896896--noneapache-2.0timm
sam2_hiera_small.fb_r896_2pt1896--noneapache-2.0timm
sam2_hiera_tiny.fb_r896896--noneapache-2.0timm
sam2_hiera_tiny.fb_r896_2pt1896--noneapache-2.0timm
Update on GitHub