Upload from Ropedia Academy

README.md

@@ -1,13 +1,54 @@
 ---
 license: mit
+library_name: pytorch
 tags:
 - ropedia-academy
 - educational
+- gaussian-splatting
 ---
 
-# B_gaussian_splatting_2d
+# 2D Gaussian Splatting
 
-Trained from scratch in **Ropedia Academy** (https://chaoyue0307.github.io/ropedia-academy/) — an educational lab. The checkpoint and full loss/eval history (`metrics.json`) are included.
+Reconstructs an image with anisotropic 2D Gaussians (with densification) — the 2D analogue of 3D Gaussian Splatting.
 
+Trained from scratch in **[Ropedia Academy](https://chaoyue0307.github.io/ropedia-academy/)** — an interactive, bilingual course on embodied & spatial AI. **Educational model:** small and quick to train; the value is the *method* and a reproducible pipeline, not a leaderboard score.
 
-![results](figure.png)
+| | |
+|---|---|
+| **Task** | differentiable image fitting |
+| **Data** | procedural target image |
+| **Track** | B · 3D & rendering |
+| **Notebook** | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/ChaoYue0307/ropedia-academy/blob/main/notebooks/training/B_gaussian_splatting_2d.ipynb) |
+
+## Results
+
+| metric | value |
+|---|---|
+| psnr (final) | 55.94 |
+
+
+![figure](figure.png)
+
+## How to use
+
+```python
+import torch
+state = torch.load("model.pt", map_location="cpu")   # some labs save pose.pt / gaussians.pt / transform.pt
+# Rebuild the model class from the Ropedia Academy notebook (linked above), then:
+# model.load_state_dict(state)
+```
+
+## Files
+
+- `figure.png`
+- `gaussians.pt`
+- `metrics.json`
+
+
+## Reproduce / train your own
+
+Open the [lab notebook in Colab](https://colab.research.google.com/github/ChaoYue0307/ropedia-academy/blob/main/notebooks/training/B_gaussian_splatting_2d.ipynb) → **Runtime → GPU → Run all**, then its *Publish to the Hugging Face Hub* cell. Browse every lab in the [Ropedia Academy Labs tab](https://chaoyue0307.github.io/ropedia-academy/labs).
+
+
+---
+*Part of the [Ropedia Academy](https://chaoyue0307.github.io/ropedia-academy/) trained-model collection.*

gaussians.pt

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:bcb8756d75ba5fd316bbcece558ec322ff1249ee1540a1a918010f921db1b41e
-size 20463
+oid sha256:166c08be34b605197f3fca73f061b7322bc0ff24cc7bf14ca6dc941dd46acbb8
+size 32047

metrics.json

@@ -2,47 +2,47 @@
   "psnr": [
     [
       0,
-      12.108373641967773
+      11.97
     ],
     [
       80,
-      35.359474182128906
+      34.73
     ],
     [
       160,
-      40.6837043762207
+      40.3
     ],
     [
       240,
-      43.21573257446289
+      45.37
     ],
     [
       320,
-      44.81652069091797
+      48.11
     ],
     [
       400,
-      45.936981201171875
+      49.83
     ],
     [
       480,
-      46.796722412109375
+      52.06
     ],
     [
       560,
-      46.285682678222656
+      51.92
     ],
     [
       640,
-      47.94150924682617
+      54.22
     ],
     [
       720,
-      48.46598815917969
+      53.28
     ],
     [
       800,
-      48.384254455566406
+      55.94
     ]
   ]
 }