Add pipeline tag and improve model card
Browse filesHi! I'm Niels from the Hugging Face community team. I've improved the model card for PFGNet by:
- Adding the `image-to-video` pipeline tag to the metadata to improve discoverability on the Hub.
- Adding links to the official GitHub repository and project page.
- Including a BibTeX citation section.
- Providing sample training and testing commands as found in the official repository.
- Organizing the content for better readability.
README.md
CHANGED
|
@@ -1,31 +1,35 @@
|
|
| 1 |
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
license: mit
|
|
|
|
| 3 |
tags:
|
| 4 |
- computer-vision
|
| 5 |
- video-prediction
|
| 6 |
- spatiotemporal-prediction
|
| 7 |
- pytorch
|
| 8 |
-
datasets:
|
| 9 |
-
- moving-mnist
|
| 10 |
-
- taxibj
|
| 11 |
-
- kth
|
| 12 |
-
- human3.6m
|
| 13 |
paper:
|
| 14 |
- https://huggingface.co/papers/2602.20537
|
| 15 |
---
|
| 16 |
-
# PFGNet
|
| 17 |
|
| 18 |
-
PFGNet
|
|
|
|
|
|
|
| 19 |
|
| 20 |
-
|
| 21 |
|
| 22 |
-
**
|
| 23 |
-
**Paper:** https://huggingface.co/papers/2602.20537
|
| 24 |
-
**
|
| 25 |
-
**Project
|
| 26 |
|
| 27 |
## Available checkpoints
|
| 28 |
|
|
|
|
|
|
|
| 29 |
| Dataset | Checkpoint |
|
| 30 |
|---|---|
|
| 31 |
| Moving MNIST | `pfg_mmnist.ckpt` |
|
|
@@ -37,4 +41,31 @@ This repository provides dataset-specific trained checkpoints of PFGNet on multi
|
|
| 37 |
|
| 38 |
## Usage
|
| 39 |
|
| 40 |
-
Please refer to the official
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
datasets:
|
| 3 |
+
- moving-mnist
|
| 4 |
+
- taxibj
|
| 5 |
+
- kth
|
| 6 |
+
- human3.6m
|
| 7 |
license: mit
|
| 8 |
+
pipeline_tag: image-to-video
|
| 9 |
tags:
|
| 10 |
- computer-vision
|
| 11 |
- video-prediction
|
| 12 |
- spatiotemporal-prediction
|
| 13 |
- pytorch
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 14 |
paper:
|
| 15 |
- https://huggingface.co/papers/2602.20537
|
| 16 |
---
|
|
|
|
| 17 |
|
| 18 |
+
# PFGNet: A Fully Convolutional Frequency-Guided Peripheral Gating Network for Efficient Spatiotemporal Predictive Learning
|
| 19 |
+
|
| 20 |
+
PFGNet is a fully convolutional framework for efficient spatiotemporal predictive learning (STPL), presented at CVPR 2026. It aims to forecast future frames from past observations by dynamically modulating receptive fields through pixel-wise frequency-guided gating.
|
| 21 |
|
| 22 |
+
Inspired by biological center-surround organization, the core Peripheral Frequency Gating (PFG) block extracts localized spectral cues to adaptively fuse multi-scale large-kernel peripheral responses with learnable center suppression, forming spatially adaptive band-pass filters.
|
| 23 |
|
| 24 |
+
**Resources:**
|
| 25 |
+
- **Paper:** [PFGNet: A Fully Convolutional Frequency-Guided Peripheral Gating Network for Efficient Spatiotemporal Predictive Learning](https://huggingface.co/papers/2602.20537)
|
| 26 |
+
- **Code:** [Official GitHub Repository](https://github.com/fhjdqaq/PFGNet)
|
| 27 |
+
- **Project Page:** [kaimaoge.github.io](https://kaimaoge.github.io)
|
| 28 |
|
| 29 |
## Available checkpoints
|
| 30 |
|
| 31 |
+
This repository provides dataset-specific trained checkpoints of PFGNet on multiple benchmarks:
|
| 32 |
+
|
| 33 |
| Dataset | Checkpoint |
|
| 34 |
|---|---|
|
| 35 |
| Moving MNIST | `pfg_mmnist.ckpt` |
|
|
|
|
| 41 |
|
| 42 |
## Usage
|
| 43 |
|
| 44 |
+
PFGNet directly inherits the codebase and dependencies of [OpenSTL](https://github.com/chengtan9907/OpenSTL). Please refer to the official repository for detailed environment setup and data preparation instructions.
|
| 45 |
+
|
| 46 |
+
### Training (Moving MNIST example)
|
| 47 |
+
From the repository root, run:
|
| 48 |
+
```bash
|
| 49 |
+
python tools/train.py -d mmnist -c configs/mmnist/PFG.py --ex_name mmnist_pfg --test
|
| 50 |
+
```
|
| 51 |
+
|
| 52 |
+
### Testing (Moving MNIST example)
|
| 53 |
+
From the repository root, run:
|
| 54 |
+
```bash
|
| 55 |
+
python tools/test.py -d mmnist -c configs/mmnist/PFG.py --ex_name mmnist_pfg --test
|
| 56 |
+
```
|
| 57 |
+
|
| 58 |
+
## Citation
|
| 59 |
+
|
| 60 |
+
If you find this work helpful, please consider citing:
|
| 61 |
+
|
| 62 |
+
```bibtex
|
| 63 |
+
@misc{cai2026pfgnetfullyconvolutionalfrequencyguided,
|
| 64 |
+
title={PFGNet: A Fully Convolutional Frequency-Guided Peripheral Gating Network for Efficient Spatiotemporal Predictive Learning},
|
| 65 |
+
author={Xinyong Cai and Changbin Sun and Yong Wang and Hongyu Yang and Yuankai Wu},
|
| 66 |
+
year={2026},
|
| 67 |
+
eprint={2602.20537},
|
| 68 |
+
archivePrefix={arXiv},
|
| 69 |
+
primaryClass={cs.CV}
|
| 70 |
+
}
|
| 71 |
+
```
|