Update README.md

README.md

@@ -2,6 +2,13 @@
 license: apache-2.0
 paper: https://arxiv.org/abs/2510.12670
 homepage: https://github.com/IBM/TerraCodec
+datasets:
+- embed2scale/SSL4EO-S12-v1.1
+library_name: terratorch
+tags:
+- Compression
+- Neutral Codecs
+- Earth Observation
 ---
 
 # TerraCodec
@@ -16,7 +23,7 @@ TerraCodec (TEC) is a family of pretrained neural compression codecs for **multi
 
 Compared to classical codecs such as JPEG2000 or WebP, TerraCodec achieves **3–10× higher compression at comparable reconstruction quality** on multispectral satellite imagery. Temporal models further improve compression by exploiting redundancy across seasonal image sequences of satellite imagery.
 
-![Reconstructions](assets/reconstructions.png)
+![Reconstructions](https://raw.githubusercontent.com/IBM/TerraCodec/main/assets/reconstructions.jpg)
 
 ---
 
@@ -24,10 +31,10 @@ Compared to classical codecs such as JPEG2000 or WebP, TerraCodec achieves **3
 
 | Model | Available Checkpoints | Description |
 |---|---|---|
-| `terracodec_v1_fp_s2l2a` | λ = 0.5, 2, 10, 40, 200 | Factorized-prior image codec. Smallest model and strong baseline for multispectral image compression. |
-| `terracodec_v1_elic_s2l2a` | λ = 0.5, 2, 10, 40, 200 | Enhanced entropy model with spatial and channel context for improved rate–distortion performance. |
-| `terracodec_v1_tt_s2l2a` | λ = 0.4, 1, 5, 20, 100, 200, 700 | Temporal Transformer codec modeling redundancy across seasonal image sequences. |
-| `flextec_v1_s2l2a` | **Single checkpoint** (quality = 1–16) | Flexible-rate temporal codec. One model supports multiple compression levels via token-based quality settings. |
+| [`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. |
+| [`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. |
+| [`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. |
+| [`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. |
 
 Lower λ / quality → **higher compression**  
 Higher λ / quality → **higher reconstruction quality**
@@ -39,13 +46,14 @@ Higher λ / quality → **higher reconstruction quality**
 
 This repository contains the **FlexTEC** variant of TerraCodec.
 
-[![TEC-TT Architecture](assets/TEC_TT_architecture.png)](assets/TEC_TT_architecture.png)
+![assets/TEC_TT_architecture.png](https://raw.githubusercontent.com/IBM/TerraCodec/main/assets/TEC_TT_architecture.png)
+
 
 FlexTEC builds on the TerraCodec Temporal Transformer (TEC-TT) architecture and introduces **flexible-rate compression within a single model**.
 
 Instead of training separate checkpoints for different rate–distortion settings, FlexTEC supports multiple compression levels through Latent Repacking and missing token prediction. During training, tokens are randomly masked to simulate different compression budgets. At inference time, the number of transmitted tokens controls the compression level: fewer tokens yield higher compression, while more tokens improve reconstruction quality.
 
-See the paper for additional architectural and training details.
+See the [paper](https://arxiv.org/abs/2510.12670) for additional architectural and training details.
 
 ---
 
@@ -106,8 +114,8 @@ GitHub repository: https://github.com/IBM/TerraCodec
 If you use TerraCodec in your research, please cite:
 ```
 @article{terracodec2025,
-  title   = {TerraCodec: Neural Codecs for Earth Observation},
-  author  = {Costa Watanabe, Julen and Wittmann, Isabelle and Blumenstiel, Benedikt},
+  title   = {TerraCodec: Compressing Optical Earth Observation Data},
+  author  = {Costa Watanabe, Julen and Wittmann, Isabelle and Blumenstiel, Benedikt and Schindler, Konrad},
   journal = {arXiv preprint arXiv:2510.12670},
   year    = {2025}
 }