TransDETR: A Python repository from weijiawu

TransDETR: End-to-end Video Text Spotting with Transformer

Introduction

End-to-end Video Text Spotting with Transformer | Youtube Demo

Video text spotting(VTS) is the task that requires simultaneously detecting, tracking and recognizing text instances in video. Recent methods typically develop sophisticated pipelines based on Intersection over Union (IoU) or appearance similarity in adjacent frames to tackle this task. In this paper, rooted in Transformer sequence modeling, we propose a novel video text DEtection, Tracking, and Recognition framework (TransDETR), which views the VTS task as a direct long-sequence temporal modeling problem.

Link to our new benchmark BOVText: A Large-Scale, Bilingual Open World Dataset for Video Text Spotting

Updates

(28/03/2024) This paper has been accepted by IJCV.
(15/07/2023) Support Chinese Recognition, Add NMS (Non-Maximum Suppression) and optimized post-processing,RuntimeTrackerBase.
(10/02/2023) Training and Inference for DSText is updated.
(09/02/2023) Script(visualization and frame extraction) for DSText is provided.
(08/07/2022) TransDETR remain under review.
(29/05/2022) Update unmatched pretrained and finetune weight.
(12/05/2022) Rotated_ROIAlig has been refined.
(08/04/2022) Refactoring the code.
(1/1/2022) The complete code has been released .

Performance

ICDAR2015(video) Tracking challenge

Methods	MOTA	MOTP	IDF1	Mostly Matched	Partially Matched	Mostly Lost
TransDETR	47.5	74.2	65.5	832	484	600

Models are also available in Google Drive.

ICDAR2015(video) Video Text Spotting challenge

Methods	MOTA	MOTP	IDF1	Mostly Matched	Partially Matched	Mostly Lost
TransDETR	58.4	75.2	70.4	614	326	427
TransDETR(aug)	60.9	74.6	72.8	644	323	400

Models are also available in Google Drive.

Notes

The training time is on 8 NVIDIA V100 GPUs with batchsize 16.
We use the models pre-trained on COCOTextV2.
We do not release the recognition code due to the company's regulations.

Demo

Installation

The codebases are built on top of Deformable DETR and MOTR.

Linux, CUDA>=9.2, GCC>=5.4
Python>=3.7

We recommend you to use Anaconda to create a conda environment:
```
conda create -n TransDETR python=3.7 pip
```
Then, activate the environment:
```
conda activate TransDETR
```
PyTorch>=1.5.1, torchvision>=0.6.1 (following instructions here)

For example, if your CUDA version is 9.2, you could install pytorch and torchvision as following:
```
conda install pytorch=1.5.1 torchvision=0.6.1 cudatoolkit=9.2 -c pytorch
```
Other requirements
```
pip install -r requirements.txt
```

Build MultiScaleDeformableAttention and Rotated ROIAlign

cd ./models/ops
sh ./make.sh

cd ./models/Rotated_ROIAlign
python setup.py build_ext --inplace

Usage

Dataset preparation

Please download ICDAR2015, COCOTextV2 dataset, DSText](https://rrc.cvc.uab.es/?ch=22&com=downloads) and organize them like FairMOT as following:

Firstly, after downloading the video data, you can use ExtractFrame_FromVideo.py to extract frames, and copy the frames to images path. labels_with_ids path is automatically generated by the generation script in tools/gen_labels.

./Data
    ├── COCOText
    │   ├── images
    │   └── labels_with_ids
    ├── ICDAR15
    │   ├── images
    │       ├── track
    │           ├── train
                    ├──Video_10_1_1
                        ├──1.jpg
                        ├──2.jpg
                    ├──Video_13_4_1
    │           ├── val
                    ├──Video_11_4_1
    │   ├── labels
    │       ├── track
    │           ├── train
    │           ├── val
    ├── DSText
    │   ├── images
    │       ├── train
    │           ├── Activity
    │           ├── Driving
    │           ├── Game
    │           ├── ....
    │       ├── test
    │           ├── Activity
    │           ├── Driving
    │           ├── Game
    │           ├── ....
    │   ├── labels_with_ids
    │       ├── train
    │           ├── Activity
    │           ├── Driving
    │           ├── Game
    │           ├── ....

You also can use the following script to generate txt file:

cd tools/gen_labels
python3 gen_labels_COCOTextV2.py
python3 gen_labels_15.py
python3 gen_labels_YVT.py
cd ../../

(These scripts are mainly intended to accomplish two tasks: 1) Generate the ground truth in the labels_with_ids path. 2) Generate the corresponding training image list (*.txt) for each dataset's training set in the ./datasets/data_path.)

Note: Before running the corresponding script, you need to modify the paths in the .py file to your own paths. Specifically, you should modify the following paths:

from_label_root: the path of the original ground truth data (e.g., the path to the .xml files for ICDAR15).
seq_root: the path of the video frames.
label_root: the path to generate the annotations. Finally, when running the gen_data_path function to generate the training image list (*.txt), modify the path accordingly.

Training and Evaluation

Training on single node

Before training, you need to modify the following paths in the .sh file: mot_path: your data path (e.g., ./Data). data_txt_path_train: the training image list file (.txt) that was generated during the data preparation. Please update these paths to match your specific setup.

You can download COCOTextV2 pretrained weights for Pretrained TransDETR Google Drive. Or training by youself:

sh configs/r50_TransDETR_pretrain_COCOText.sh

Then training on ICDAR2015 with 8 GPUs as following:

sh configs/r50_TransDETR_train_ICDAR15video.sh

Or training on DSText with 8 GPUs as following:

sh configs/r50_TransDETR_train_DSText.sh

Evaluation on ICDAR13 and ICDAR15

You can download the pretrained model of TransDETR (the link is in "Main Results" session), then run following command to evaluate it on ICDAR2015 dataset:

sh configs/r50_TransDETR_eval_ICDAR2015.sh

evaluate on ICDAR13

python tools/Evaluation_ICDAR13/evaluation.py --groundtruths "./tools/Evaluation_ICDAR13/gt" --tests "./exps/e2e_TransVTS_r50_ICDAR15/jons"

evaluate on ICDAR15

cd exps/e2e_TransVTS_r50_ICDAR15
zip -r preds.zip ./preds/*

then submit to the ICDAR2015 online metric

Evaluation on DSText

Inference , we also provide the trained weight on Google drive

sh configs/r50_TransDETR_eval_BOVText.sh

Then zip the result file and submit to the DSText online metric

cd exps/e2e_TransVTS_r50_DSText/preds
zip -r ../preds.zip ./*

Visualization

For visual in demo video, you can enable 'vis=True' in eval.py like:

--show

then run the script:

python tools/vis.py

License

TransDETR is released under MIT License.

Citing

If you use TransDETR in your research or wish to refer to the baseline results published here, please use the following BibTeX entries:

@article{wu2022transdetr,
  title={End-to-End Video Text Spotting with Transformer},
  author={Weijia Wu, Chunhua Shen, Yuanqiang Cai, Debing Zhang, Ying Fu, Ping Luo, Hong Zhou},
  journal={arxiv},
  year={2022}
}

If you have any questions, please contact me at: weijiawu@zju.edu.cn

This code uses codes from MOTR, TransVTSpotter and EAST. Many thanks to their wonderful work. Consider citing them as well:

@inproceedings{zeng2021motr,
  title={MOTR: End-to-End Multiple-Object Tracking with TRansformer},
  author={Zeng, Fangao and Dong, Bin and Zhang, Yuang and Wang, Tiancai and Zhang, Xiangyu and Wei, Yichen},
  booktitle={European Conference on Computer Vision (ECCV)},
  year={2022}
}

@article{wu2021bilingual,
  title={A bilingual, OpenWorld video text dataset and end-to-end video text spotter with transformer},
  author={Wu, Weijia and Cai, Yuanqiang and Zhang, Debing and Wang, Sibo and Li, Zhuang and Li, Jiahong and Tang, Yejun and Zhou, Hong},
  journal={arXiv preprint arXiv:2112.04888},
  year={2021}
}

@inproceedings{zhou2017east,
  title={East: an efficient and accurate scene text detector},
  author={Zhou, Xinyu and Yao, Cong and Wen, He and Wang, Yuzhi and Zhou, Shuchang and He, Weiran and Liang, Jiajun},
  booktitle={Proceedings of the IEEE conference on Computer Vision and Pattern Recognition},
  pages={5551--5560},
  year={2017}
}

weijiawu/TransDETR