---
title: multi-modal_soonet_video-temporal-grounding
canonical_url: "https://www.modelscope.cn/models/iic/multi-modal_soonet_video-temporal-grounding"
md_url: "https://www.modelscope.cn/models/iic/multi-modal_soonet_video-temporal-grounding.md"
repository: iic/multi-modal_soonet_video-temporal-grounding
chinese_name: "SOONet: 基于自然语言输入的长视频片段时序定位模型"
last_updated: 2023-03-20
license: "Apache License 2.0"
pipeline_tag: video-temporal-grounding
tasks:
  - video-temporal-grounding
model_type:
  - Transformer
library_name:
  - pytorch
frameworks:
  - pytorch
domain:
  - multi-modal
downloads: 4651
stars: 48
tags:
  - Alibaba
  - "Long Video Temporal Grounding"
  - "Natural Language Video Localization"
---

# multi-modal_soonet_video-temporal-grounding

> multi-modal_soonet_video-temporal-grounding - iic 在 ModelScope 开源的模型。SOONet是一种给定自然语言输入条件下，快速定位长视频片段的算法。模型基于CLIP对视频和文本提取特征，并通过先粗排序后精排序两段式逻辑快速定位目标片段，在效果和效率上都有不错的表现。

iic/multi-modal_soonet_video-temporal-grounding 是 ModelScope 魔搭社区上的video-temporal-grounding模型，采用 Apache License 2.0 许可。

- **Repository**: iic/multi-modal_soonet_video-temporal-grounding
- **License**: Apache License 2.0
- **Tasks**: video-temporal-grounding
- **Tags**: Alibaba, Long Video Temporal Grounding, Natural Language Video Localization
- **Downloads**: 4651
- **Stars**: 48
- **Last updated**: 2023-03-20

Source: https://www.modelscope.cn/models/iic/multi-modal_soonet_video-temporal-grounding

---

# SOONet: 基于自然语言输入的长视频时序片段定位

[**论文链接**](https://arxiv.org/pdf/2303.08345.pdf)


## 模型描述
![模型结构](figs/framework.png)

SOONet是第一个端到端的长视频时序定位框架。不同于现有基于滑动窗口的方法需要将长视频切割成多个短视频进行重复推理，SOONet进行小时长度视频的推理只需要经过一次网络前向计算，从而避免了滑动窗口方法造成的低效率问题。同时，SOONet提出了一种“粗筛-精筛”二阶段召回的策略以及精细定制化的网络结构和损失函数，很好的融合了anchor间的上下文信息和anchor内的内容信息，从而达到精准的时序定位。SOONet在MAD和Ego4d两个长视频数据集上均取得了SOTA的定位准确度，同时分别将推理效率提升14.6倍和102.8倍。

## 期望模型使用方式以及适用范围

### 如何使用

SOONet是一种快速的视频时序定位框架。只需要提供查询文本及对应的待检索视频，即可快速输出与查询文本语义相关的视频片段的起止时间。

#### 代码范例

```python
import cv2
from modelscope.pipelines import pipeline
from modelscope.utils.constant import Tasks

# pipeline初始化
soonet_pipeline = pipeline(Tasks.video_temporal_grounding, 
                       model='damo/multi-modal_soonet_video-temporal-grounding')

# 输入文本query
input_text = "a man takes food out of the refrigerator."
# 输入视频地址
input_video = "soonet_video_temporal_grounding_test_video.mp4"
# 运行pipeline获得结果
result = soonet_pipeline((input_text, input_video))

print(f'soonet output: {result}.')
print('finished!')
```

### 模型局限性以及可能的偏差

- 考虑GPU精度、视频解码工具的差异，可能带来一定的性能差异(<0.5%)
- 训练及测试使用的GPU是Tesla A100，显存81251MiB，其他型号的GPU可能带来显著的推理效率差异
- pytorch版本为1.10.1，其他版本的性能差异待测试
- 当前版本在python 3.7.9环境测试通过，其他环境下可用性待测试

## 训练数据介绍

- MAD 包含超过384K个查询文本以及1200小时的视频，每个视频的平均时长达到110分钟
- Ego4d 包含3670小时的视频。我们在两种不同的评估设置下进行训练和测试。其中，*Ego4d-NLQ*是官方提供的评估设置，平均每个检索视频只有8分钟。为了验证我们的方法在长视频上的有效性，我们提出了*Ego4d-Video-NLQ*，使用全部视频而非某个片段作为待检索视频，从而将平均检索视频长度扩展至25分钟


## 数据评估及结果

SOONet在MAD测试集上的准确率及推理耗时对比如下，详细的实验结果请参考我们的[论文](https://arxiv.org/pdf/2303.08345.pdf)

### 准确率对比
| Method | R1@0.1 | R5@0.1 | R50@0.1 | R1@0.3 | R5@0.3 | R50@0.3 | R1@0.5 | R5@0.5 | R50@0.5 |
|:------:|:------:|:------:|:-------:|:------:|:------:|:-------:|:------:|:------:|:-------:|
| VLG-Net | 3.64  | 11.66  | 39.78   | 2.76   | 9.31   | 34.27   | 1.65   | 5.99   | 24.93   |
| CLIP    | 6.57  | 15.05  | 37.92   | 3.13   | 9.85   | 28.71   | 1.39   | 5.44   | 18.80   |
| CONE    | 8.90  | 20.51  | 43.36   | 6.87   | 16.11  | 34.73   | 4.10   | 9.59   | 20.56   |
| **SOONet** | **11.26** | **23.21** | **50.32** | **9.00** | **19.64** | **44.78** | **5.32** | **13.14** | **32.59** |

### 推理效率对比
| Method  | Params | FLOPs | GPU Mem. | Execution Time |
|:-------:|:------:|:-----:|:--------:|:--------------:|
| CLIP    |  0     | 0.2G  | 2.9G     |  7387.8s       |
| VLG-Net | 5,330,435 | 1757.3G | 20.0G | 29556.0s     |
| **SOONet** | 22,970,947 | 70.2G | 2.4G | **505.0s**  |

## 可视化结果展示

SOONet在MAD数据集上的一些推理结果展示如下，更多的可视化结果请参考我们的[论文](https://arxiv.org/pdf/2303.08345.pdf)

![MAD可视化](figs/visualization.png)

## 相关论文以及引用信息

如果该模型对您有所帮助，请引用我们的论文：

```BibTeX
@article{pan2023scanning,
  title={Scanning Only Once: An End-to-end Framework for Fast Temporal Grounding in Long Videos},
  author={Pan, Yulin and He, Xiangteng and Gong, Biao and Lv, Yiliang and Shen, Yujun and Peng, Yuxin and Zhao, Deli},
  journal={arXiv preprint arXiv:2303.08345},
  year={2023}
}
```