Upload README.md with huggingface_hub

README.md

@@ -12,8 +12,16 @@ datasets:
 
 Pretrained checkpoint for **GlassNet** from the CVPR 2021 paper:
 
-> **Rich Context Aggregation with Reflection Prior for Glass Surface Detection**
-> Jiaying Lin, Zebang He, Rynson W.H. Lau
+> **Rich Context Aggregation with Reflection Prior for Glass Surface Detection**  
+> Jiaying Lin, Zebang He, Rynson W.H. Lau  
+> *Proceedings of CVPR 2021*  
+> Project page: https://jiaying.link/cvpr2021-gsd/
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `GSD.pth` | GlassNet weights trained on the GSD training split |
 
 ## Usage
 
@@ -28,8 +36,20 @@ net.load_state_dict(torch.load(ckpt, map_location="cpu"))
 net.eval()
 ```
 
-See the [dataset page](https://huggingface.co/datasets/garrying/GSD) and the
-[project homepage](https://jiaying.link/cvpr2021-gsd/) for full inference instructions.
+For full inference code (data loading, CRF post-processing, saving outputs) see `infer.py` in the original release.
+
+## Model Architecture
+
+**GlassNet** uses a ResNeXt-101 backbone with:
+
+- **DenseContrastModule** — multi-scale dilated convolutions (rates 1/2/4/8) with pairwise feature subtraction to capture cross-context contrast
+- **SELayer** — grouped squeeze-and-excitation for context-aware channel reweighting
+- **RefNet** — a lightweight U-Net-style decoder that jointly predicts the binary glass mask and reconstructs the reflection image as auxiliary output
+- **CRF post-processing** — dense CRF refinement of predicted masks at inference time
+
+## Dataset
+
+The GSD dataset is available at [garrying/GSD](https://huggingface.co/datasets/garrying/GSD).
 
 ## Citation
 
@@ -41,3 +61,7 @@ See the [dataset page](https://huggingface.co/datasets/garrying/GSD) and the
     year      = {2021}
 }
 ```
+
+## Contact
+
+jiayinlin5-c@my.cityu.edu.hk