Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bair-climate-initiative/xT


https://github.com/bair-climate-initiative/xT

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

        

# 🌐 xT: Nested Tokenization for Larger Context in Large Images
![xT](assets/xt.png "xT")

> **xT: Nested Tokenization for Larger Context in Large Images**\
> Ritwik Gupta*, Shufan Li*, Tyler Zhu*, Jitendra Malik, Trevor Darrell, Karttikeya Mangalam\
> Paper: https://arxiv.org/abs/2403.01915

[arXiv](https://arxiv.org/abs/2403.01915) | [Project page](https://ai-climate.berkeley.edu/xt-website)

## About
_xT_ enables you to model large images, end-to-end, on contemporary, memory-limited GPUs. It is a simple framework for vision transformers which effectively aggregates global context with local details.

## Installation
* `conda env create -f environment.yml`

The code has been tested on Linux on NVIDIA A100 GPUs with PyTorch 2+. We use custom CUDA kernels as implemented by the `Mamba` and `OpenAI Triton` projects. Therefore, modifications may be required to use this repository on other operating systems or GPUs.

## Training
Training can be launched through
```./run_submit.sh config=```

We also provide [SubmitIt](https://github.com/facebookincubator/submitit) scripts in `launch_scripts` to submit training jobs on Slurm clusters.

## Pretrained Models

Weights and configs for our experiments are available on [Hugging Face](https://huggingface.co/bair-climate-initiative/swin-xt/tree/main).

|Name | Resolution | Top1-ACC | Params | Mem (GB) | Thrpt (region/s) |
|-------------------------|----:|-----:| ---:| ---:|---:|
|[Swin-T](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-t/weights/swin-t-nonxl-256-top1.ckpt) | 256 | 53.76| 31M | 0.30 | 76.43 |
|[Swin-T \ Hyper](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-t/weights/swin-t-hyper-256-256-top1.ckpt) | 256/256 | 52.93| 47M | 0.31 | 47.81 |
|[Swin-T \ Hyper](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-t/weights/swin-t-hyper-512-256-top1.ckpt) | 512/256 | 60.56| 47M | 0.29 | 88.28 |
|Swin-T \ XL | 512/256 | 58.92| 47M | 0.17 | 80.00 |
|[Swin-T \ Mamba](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-t/weights/swin-t-mamba-512-256-top1.ckpt) | 512/256 | **61.97**| 44M | 0.29 | 84.77 |
| |
|[Swin-S](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-s/weights/swin-s-nonxl-256-top1.ckpt) | 256 | 58.45| 52M | 0.46 | 44.44 |
|[Swin-S \ Hyper](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-s/weights/swin-s-hyper-256-256-top1.ckpt) | 256/256 | 57.04| 69M | 0.46 | 39.80 |
|[Swin-S \ Hyper](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-s/weights/swin-s-hyper-512-256-top1.ckpt) | 512/256 | **63.62**| 69M | 0.46 | 41.45 |
|Swin-S \ XL | 512/256 | 62.68| 69M | 0.23 | 36.36 |
| |
|[Swin-B](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-b/weights/swin-b-nonxl-256-top1.ckpt) | 256 | 58.57| 92M | 0.50 | 36.14 |
|[Swin-B \ Hyper](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-b/weights/swin-b-hyper-256-256-top1.ckpt) | 256/256 | 55.52| 107M | 0.61 | 29.85 |
|[Swin-B \ Hyper](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-b/weights/swin-b-hyper-512-256-top1.ckpt) | 512/256 | **64.08**| 107M | 0.74 | 24.00 |
|Swin-B \ XL | 512/256 | 62.09| 107M | 0.39 | 41.03 |
|[Swin-B \ Mamba](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-b/weights/swin-b-mamba-512-256-top1.ckpt) | 512/256 | 63.73| 103M | 0.58 | 29.09 |
| |
|[Swin-L](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-l/weights/swin-l-nonxl-256-top1.ckpt) | 256 | 68.78| 206M | 0.84 | 17.02 |
|[Swin-L \ Hyper](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-l/weights/swin-l-hyper-256-256-top1.ckpt) | 256/256 | 67.84| 215M | 1.06 | 16.08 |
|[Swin-L \ Hyper](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-l/weights/swin-l-hyper-512-256-top1.ckpt) | 512/256 | 72.42| 215M | 1.03 | 16.58 |
|Swin-L \ XL | 512/256 | **73.47**| 215M | 0.53 | 14.10 |
|[Swin-L \ Mamba](https://huggingface.co/bair-climate-initiative/xt/blob/main/swin-l/weights/swin-l-mamba-512-256-top1.ckpt) | 512/256 | 73.36| 212M | 1.03 | 15.61 |

## Citation

```
@article{xTLargeImageModeling,
title={xT: Nested Tokenization for Larger Context in Large Images},
author={Gupta, Ritwik and Li, Shufan and Zhu, Tyler and Malik, Jitendra and Darrell, Trevor and Mangalam, Karttikeya},
journal={arXiv preprint arXiv:2403.01915},
year={2024}
}
```