Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 

Repository files navigation

[ACMMM 2026] Paths: Prompt-aware Spatio-temporal Transformer with Hierarchical Multi-modal Fusion for RGB-Event Video Person Re-Identification

Paper Code

Yakun Huo, Yingquan Wang, Yangyang Liu, Tianyu Yan, Yunzhi Zhuge, Pingping Zhang, Huchuan Lu

Framework

Paths framework

Repository Structure

Paths/
├── config/                 # Default configuration and compatibility aliases
├── configs/                # Dataset/backbone experiment configurations
│   ├── EvReID_Degrade/
│   ├── MARS/
│   ├── PRID/
│   └── iLIDSVID/
├── data/                   # Dataset parsers, video loader, transforms, sampler
├── engine/                 # Training and inference loops
├── layers/                 # ID, triplet, center, and auxiliary losses
├── modeling/
│   ├── backbones/          # ViT backbones
│   ├── clip/               # CLIP visual encoder
│   ├── dinov3/             # DINOv3 backbone code
│   ├── modules/
│   │   ├── mab/            # Memory-Augmented Backbone
│   │   ├── pst/            # Prompt-aware Spatio-temporal Transformer
│   │   └── hmf/            # Hierarchical Multi-modal Fusion
│   ├── backbone_router.py
│   └── paths_model.py      # Top-level Paths model
├── solver/                 # Optimizer and cosine scheduler
├── utils/                  # Metrics, logging, reranking, and utilities
├── visualize/              # Test-time visualization utilities
├── train.py
└── test.py

Installation

1. Clone the repository

git clone https://github.com/Reflection0427/Paths.git
cd Paths

2. Create an environment

conda create -n paths python=3.10 -y
conda activate paths

# Install the PyTorch build that matches your CUDA driver first.
pip install torch torchvision

pip install yacs timm scipy scikit-learn pandas matplotlib seaborn \
    tqdm pillow ftfy regex omegaconf torchmetrics fvcore termcolor submitit

For a DINOv3 environment that enables optional optimized operators, install a compatible xformers build separately. It is not required by every Paths execution path.

Dataset Preparation

EvReID

DATA_ROOT/
├── rgb_degrade/
│   ├── train/<pid>/*.jpg
│   ├── test/<pid>/*.jpg
│   └── info/
│       ├── train_name.txt
│       ├── test_name.txt
│       ├── tracks_train_info.mat
│       ├── tracks_test_info.mat
│       └── query_IDX.mat
└── event/
    ├── train/<pid>/*.jpg
    └── test/<pid>/*.jpg

Set DATASETS.ROOT_DIR to DATA_ROOT/rgb_degrade.

MARS

MARS_ROOT/
├── rgb/
│   ├── bbox_train/<pid>/*.jpg
│   └── bbox_test/<pid>/*.jpg
├── event/
│   ├── bbox_train/<pid>/*.jpg
│   └── bbox_test/<pid>/*.jpg
└── info/
    ├── train_name.txt
    ├── test_name.txt
    ├── tracks_train_info.mat
    ├── tracks_test_info.mat
    └── query_IDX.mat

Set DATASETS.ROOT_DIR to MARS_ROOT.

Training

EvReID with DINOv3

python train.py --config_file configs/EvReID_Degrade/Paths.yml \
    DATASETS.ROOT_DIR /absolute/path/to/EvReID/rgb_degrade \
    MODEL.PRETRAIN_PATH_T /absolute/path/to/Dinov3.pth \
    OUTPUT_DIR logs/EvReID_DINOv3

EvReID with CLIP-B/16

python train.py --config_file configs/EvReID_Degrade/Paths.yml \
    MODEL.TRANSFORMER_TYPE ViT-B-16 \
    DATASETS.ROOT_DIR /absolute/path/to/EvReID/rgb_degrade \
    OUTPUT_DIR logs/EvReID_CLIP

MARS with CLIP-B/16

python train.py --config_file configs/MARS/Paths.yml \
    DATASETS.ROOT_DIR /absolute/path/to/MARS \
    OUTPUT_DIR logs/MARS_CLIP

MARS with DINOv3

python train.py --config_file configs/MARS/Path_Dino.yml \
    DATASETS.ROOT_DIR /absolute/path/to/MARS \
    MODEL.PRETRAIN_PATH_T /absolute/path/to/Dinov3.pth \
    OUTPUT_DIR logs/MARS_DINOv3

The best validation model is saved automatically as:

<OUTPUT_DIR>/Paths_best.pth

Evaluation

python test.py --config_file configs/EvReID_Degrade/Paths.yml \
    DATASETS.ROOT_DIR /absolute/path/to/EvReID/rgb_degrade \
    TEST.WEIGHT /absolute/path/to/Paths_best.pth \
    OUTPUT_DIR logs/EvReID_eval

Citation

@inproceedings{huo2026paths,
  title     = {Paths: Prompt-aware Spatio-temporal Transformer with Hierarchical Multi-modal Fusion for RGB-Event Video Person Re-Identification},
  author    = {Huo, Yakun and Wang, Yingquan and Liu, Yangyang and Yan, Tianyu and Zhuge, Yunzhi and Zhang, Pingping and Lu, Huchuan},
  booktitle = {Proceedings of the 34th ACM International Conference on Multimedia},
  year      = {2026},
  doi       = {10.1145/3767308.3835505}
}

About

[ACMMM 2026] Paths: Prompt-aware Spatio-temporal Transformer with Hierarchical Multi-modal Fusion for RGB-Event Video Person Re-Identification

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors