Instructions to use embed2scale/TerraCodec-1.0-FP-S2L2A with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- TerraTorch
How to use embed2scale/TerraCodec-1.0-FP-S2L2A with TerraTorch:
from terratorch.registry import BACKBONE_REGISTRY model = BACKBONE_REGISTRY.build("embed2scale/TerraCodec-1.0-FP-S2L2A") - Notebooks
- Google Colab
- Kaggle
Update README.md
Browse files
README.md
CHANGED
|
@@ -2,6 +2,9 @@
|
|
| 2 |
license: apache-2.0
|
| 3 |
paper: https://arxiv.org/abs/2510.12670
|
| 4 |
homepage: https://github.com/IBM/TerraCodec
|
|
|
|
|
|
|
|
|
|
| 5 |
---
|
| 6 |
|
| 7 |
# TerraCodec
|
|
@@ -24,10 +27,10 @@ Compared to classical codecs such as JPEG2000 or WebP, TerraCodec achieves **3
|
|
| 24 |
|
| 25 |
| Model | Available Checkpoints | Description |
|
| 26 |
|---|---|---|
|
| 27 |
-
| `terracodec_v1_fp_s2l2a` | λ = 0.5, 2, 10, 40, 200 | Factorized-prior image codec. Smallest model and strong baseline for multispectral image compression. |
|
| 28 |
-
| `terracodec_v1_elic_s2l2a` | λ = 0.5, 2, 10, 40, 200 | Enhanced entropy model with spatial and channel context for improved rate–distortion performance. |
|
| 29 |
-
| `terracodec_v1_tt_s2l2a` | λ = 0.4, 1, 5, 20, 100, 200, 700 | Temporal Transformer codec modeling redundancy across seasonal image sequences. |
|
| 30 |
-
| `flextec_v1_s2l2a` | **Single checkpoint** (quality = 1–16) | Flexible-rate temporal codec. One model supports multiple compression levels via token-based quality settings. |
|
| 31 |
|
| 32 |
Lower λ / quality → **higher compression**
|
| 33 |
Higher λ / quality → **higher reconstruction quality**
|
|
@@ -43,7 +46,7 @@ This repository contains the **TEC-FP (Factorized Prior)** variants of TerraCode
|
|
| 43 |
TEC-FP is a convolutional encoder–decoder neural compression model with a fully factorized entropy model for the latent representation. Each quantized latent variable is modeled independently without spatial or channel context.
|
| 44 |
This design enables efficient parallel entropy coding. TEC-FP is the smallest and fastest image codec in the TerraCodec family and is optimized for 12-band Sentinel-2 imagery.
|
| 45 |
|
| 46 |
-
See the paper for additional architectural and training details.
|
| 47 |
|
| 48 |
---
|
| 49 |
|
|
@@ -107,8 +110,8 @@ GitHub repository: https://github.com/IBM/TerraCodec
|
|
| 107 |
If you use TerraCodec in your research, please cite:
|
| 108 |
```
|
| 109 |
@article{terracodec2025,
|
| 110 |
-
title = {TerraCodec:
|
| 111 |
-
author = {Costa Watanabe, Julen and Wittmann, Isabelle and Blumenstiel, Benedikt},
|
| 112 |
journal = {arXiv preprint arXiv:2510.12670},
|
| 113 |
year = {2025}
|
| 114 |
}
|
|
|
|
| 2 |
license: apache-2.0
|
| 3 |
paper: https://arxiv.org/abs/2510.12670
|
| 4 |
homepage: https://github.com/IBM/TerraCodec
|
| 5 |
+
datasets:
|
| 6 |
+
- embed2scale/SSL4EO-S12-v1.1
|
| 7 |
+
library_name: terratorch
|
| 8 |
---
|
| 9 |
|
| 10 |
# TerraCodec
|
|
|
|
| 27 |
|
| 28 |
| Model | Available Checkpoints | Description |
|
| 29 |
|---|---|---|
|
| 30 |
+
| [`terracodec_v1_fp_s2l2a`](https://huggingface.co/embed2scale/TerraCodec-1.0-ELIC-S2L2A) | λ = 0.5, 2, 10, 40, 200 | Factorized-prior image codec. Smallest model and strong baseline for multispectral image compression. |
|
| 31 |
+
| [`terracodec_v1_elic_s2l2a`](https://huggingface.co/embed2scale/TerraCodec-1.0-FP-S2L2A) | λ = 0.5, 2, 10, 40, 200 | Enhanced entropy model with spatial and channel context for improved rate–distortion performance. |
|
| 32 |
+
| [`terracodec_v1_tt_s2l2a`](https://huggingface.co/embed2scale/TerraCodec-1.0-TT-S2L2A) | λ = 0.4, 1, 5, 20, 100, 200, 700 | Temporal Transformer codec modeling redundancy across seasonal image sequences. |
|
| 33 |
+
| [`flextec_v1_s2l2a`](https://huggingface.co/embed2scale/TerraCodec-1.0-FlexTEC-S2L2A) | **Single checkpoint** (quality = 1–16) | Flexible-rate temporal codec. One model supports multiple compression levels via token-based quality settings. |
|
| 34 |
|
| 35 |
Lower λ / quality → **higher compression**
|
| 36 |
Higher λ / quality → **higher reconstruction quality**
|
|
|
|
| 46 |
TEC-FP is a convolutional encoder–decoder neural compression model with a fully factorized entropy model for the latent representation. Each quantized latent variable is modeled independently without spatial or channel context.
|
| 47 |
This design enables efficient parallel entropy coding. TEC-FP is the smallest and fastest image codec in the TerraCodec family and is optimized for 12-band Sentinel-2 imagery.
|
| 48 |
|
| 49 |
+
See the [paper](https://arxiv.org/abs/2510.12670) for additional architectural and training details.
|
| 50 |
|
| 51 |
---
|
| 52 |
|
|
|
|
| 110 |
If you use TerraCodec in your research, please cite:
|
| 111 |
```
|
| 112 |
@article{terracodec2025,
|
| 113 |
+
title = {TerraCodec: Compressing Optical Earth Observation Data},
|
| 114 |
+
author = {Costa Watanabe, Julen and Wittmann, Isabelle and Blumenstiel, Benedikt and Schindler, Konrad},
|
| 115 |
journal = {arXiv preprint arXiv:2510.12670},
|
| 116 |
year = {2025}
|
| 117 |
}
|