Instructions to use embed2scale/TerraCodec-1.0-ELIC-S2L2A with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- TerraTorch
How to use embed2scale/TerraCodec-1.0-ELIC-S2L2A with TerraTorch:
from terratorch.registry import BACKBONE_REGISTRY model = BACKBONE_REGISTRY.build("embed2scale/TerraCodec-1.0-ELIC-S2L2A") - Notebooks
- Google Colab
- Kaggle
Update README.md
Browse files
README.md
CHANGED
|
@@ -2,6 +2,13 @@
|
|
| 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 +31,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**
|
|
@@ -38,12 +45,12 @@ Higher λ / quality → **higher reconstruction quality**
|
|
| 38 |
|
| 39 |
This repository contains the **TEC-ELIC** variants of TerraCodec.
|
| 40 |
|
| 41 |
-
|
| 42 |
|
| 43 |
TEC-ELIC is a convolutional encoder–decoder neural compression model based on the Efficient Learned Image Compression (ELIC) architecture. The model predicts the mean and scale of latent variables using spatial and channel context together with a hyperprior.
|
| 44 |
This richer entropy model improves rate–distortion performance compared to the factorized prior model, at the cost of higher computational complexity. TEC-ELIC is optimized for 12-band Sentinel-2 imagery.
|
| 45 |
|
| 46 |
-
See the paper for additional architectural and training details.
|
| 47 |
|
| 48 |
---
|
| 49 |
|
|
@@ -107,8 +114,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 |
+
tags:
|
| 9 |
+
- Compression
|
| 10 |
+
- Neutral Codecs
|
| 11 |
+
- Earth Observation
|
| 12 |
---
|
| 13 |
|
| 14 |
# TerraCodec
|
|
|
|
| 31 |
|
| 32 |
| Model | Available Checkpoints | Description |
|
| 33 |
|---|---|---|
|
| 34 |
+
| [`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. |
|
| 35 |
+
| [`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. |
|
| 36 |
+
| [`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. |
|
| 37 |
+
| [`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. |
|
| 38 |
|
| 39 |
Lower λ / quality → **higher compression**
|
| 40 |
Higher λ / quality → **higher reconstruction quality**
|
|
|
|
| 45 |
|
| 46 |
This repository contains the **TEC-ELIC** variants of TerraCodec.
|
| 47 |
|
| 48 |
+

|
| 49 |
|
| 50 |
TEC-ELIC is a convolutional encoder–decoder neural compression model based on the Efficient Learned Image Compression (ELIC) architecture. The model predicts the mean and scale of latent variables using spatial and channel context together with a hyperprior.
|
| 51 |
This richer entropy model improves rate–distortion performance compared to the factorized prior model, at the cost of higher computational complexity. TEC-ELIC is optimized for 12-band Sentinel-2 imagery.
|
| 52 |
|
| 53 |
+
See the [paper](https://arxiv.org/abs/2510.12670) for additional architectural and training details.
|
| 54 |
|
| 55 |
---
|
| 56 |
|
|
|
|
| 114 |
If you use TerraCodec in your research, please cite:
|
| 115 |
```
|
| 116 |
@article{terracodec2025,
|
| 117 |
+
title = {TerraCodec: Compressing Optical Earth Observation Data},
|
| 118 |
+
author = {Costa Watanabe, Julen and Wittmann, Isabelle and Blumenstiel, Benedikt and Schindler, Konrad},
|
| 119 |
journal = {arXiv preprint arXiv:2510.12670},
|
| 120 |
year = {2025}
|
| 121 |
}
|