timm documentation

NesT

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

NesT

Category: ViT · Code: timm/models/nest.py · Architectures: 6 · Pretrained weights: 3 (3 with ImageNet-1k results)

Nested Transformers (NesT) apply self-attention locally within non-overlapping image blocks and aggregate neighbouring blocks between stages. Weights converted from the official JAX release.

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('nest_tiny_jx.goog_in1k', pretrained=True)
>>> data_config = timm.data.resolve_model_data_config(model)

Model API support

FeatureNest
features_only=True feature maps✓ (strides 4, 8, 16)
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 (Nest with nest_tiny at 224), 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
nest_base67.7217.962240
nest_base_jx67.7217.962241
nest_small38.3510.352240
nest_small_jx38.3510.352241
nest_tiny17.065.832240
nest_tiny_jx17.065.832241

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
nest_base_jx.goog_in1k22483.5522241000apache-2.0timm
nest_small_jx.goog_in1k22483.1322241000apache-2.0timm
nest_tiny_jx.goog_in1k22481.4282241000apache-2.0timm
Update on GitHub