The official repository of our paper "ASM-Loc: Action-aware Segment Modeling for Weakly-Supervised Temporal Action Localization" .

Weakly-supervised temporal action localization aims to recognize and localize action segments in untrimmed videos given only video-level action labels for training. Without the boundary information of action segments, existing methods mostly rely on multiple instance learning (MIL), where the predictions of unlabeled instances (i.e., video snippets) are supervised by classifying labeled bags (i.e., untrimmed videos). However, this formulation typically treats snippets in a video as independent instances, ignoring the underlying temporal structures within and across action segments. To address this problem, we propose ASM-Loc, a novel WTAL framework that enables explicit, action-aware segment modeling beyond standard MIL-based methods. Our framework entails three segment-centric components: (i) dynamic segment sampling for compensating the contribution of short actions; (ii) intra- and inter-segment attention for modeling action dynamics and capturing temporal dependencies; (iii) pseudo instance-level supervision for improving action boundary prediction. Furthermore, a multi-step refinement strategy is proposed to progressively improve action proposals along the model training process.

Required packages are listed in requirements.txt. You can install by running:

pip install -r requirements.txt

We evaluate our ASM-Loc on two popular benchmark datasets THUMOS-14 and ActivityNet-1.3. Before running the code, please download the dataset from the link provided in this repo. Unzip it under the data/ folder and make sure the data structure is as below.

 ├── data
     └── THUMOS14
         ├── gt.json
         ├── split_train.txt
         ├── split_test.txt
         └── train
             ├── ...
         └── test
             ├── ...
     └── ActivityNet13
         ├── gt.json
         ├── split_train.txt
         ├── split_test.txt
         └── train
             ├── ...
         └── test
             ├── ...

# For the THUMOS-14 dataset
python main_THUMOS.py --batch_size 16

# For the ActivityNet-v1.3 dataset
python main_ActivityNet.py --batch_size 64

First, download the checkpoints into "saved_model" directory and pass it as the checkpoint flag.

# For the THUMOS-14 dataset
python main_THUMOS.py --batch_size 16 --test --checkpoint saved_model/THUMOS

# For the ActivityNet-v1.3 dataset
python main_ActivityNet.py --batch_size 64 --test --checkpoint saved_model/ActivityNet

Note that the performance of checkpoints we provided is slightly different than the orignal paper! Details are as follows:

If you find our code or our paper useful for your research, please [★star] this repo and [cite] the following paper:

@article{he2022asm,
  title={ASM-Loc: Action-aware Segment Modeling for Weakly-Supervised Temporal Action Localization},
  author={Bo He and Xitong Yang and Le Kang and Zhiyu Cheng and Xin Zhou and Abhinav Shrivastava},
  journal={Proceedings of the IEEE/CVF Conference on Computer Vision and Pattern Recognition (CVPR)},
  year={2022}
}

We referenced the repos below for the code

• BasNet
• ActivityNet
• ACM-Net