Merge branch 'tjq/thumos14_doc' into 'master'

Add thumos14_doc.

See merge request open-mmlab/mmaction-lite!300

tools/data/thumos14/download_annotations.sh

+#! /usr/bin/bash env
+
+DATA_DIR="../../../data/thumos14/"
+
+if [[ ! -d "${DATA_DIR}" ]]; then
+  echo "${DATA_DIR} does not exist. Creating";
+  mkdir -p ${DATA_DIR}
+fi
+cd ${DATA_DIR}
+
+wget http://crcv.ucf.edu/THUMOS14/Validation_set/TH14_Temporal_annotations_validation.zip
+wget http://crcv.ucf.edu/THUMOS14/test_set/TH14_Temporal_annotations_test.zip
+
+if [ ! -d "./annotations_val" ]; then
+  mkdir ./annotations_val
+fi
+unzip -j TH14_Temporal_annotations_validation.zip -d annotations_val
+
+if [ ! -d "./annotations_test" ]; then
+  mkdir ./annotations_test
+fi
+unzip -j TH14_Temporal_annotations_test.zip -d annotations_test
+
+rm TH14_Temporal_annotations_validation.zip
+rm TH14_Temporal_annotations_test.zip

tools/data/thumos14/download_videos.sh

+#! /usr/bin/bash env
+
+DATA_DIR="../../../data/thumos14/"
+
+cd ${DATA_DIR}
+
+wget https://storage.googleapis.com/thumos14_files/TH14_validation_set_mp4.zip
+wget https://storage.googleapis.com/thumos14_files/TH14_Test_set_mp4.zip
+
+if [ ! -d "./videos/val" ]; then
+  mkdir ./videos
+  mkdir ./videos/val
+fi
+unzip -j TH14_validation_set_mp4.zip -d videos/val
+
+if [ ! -d "./videos/test" ]; then
+  mkdir ./videos
+  mkdir ./videos/test
+fi
+unzip -P "THUMOS14_REGISTERED" TH14_Test_set_mp4.zip -d videos/test
+
+cd "../../tools/data/thumos14/"

tools/data/thumos14/extract_frames.sh

+#! /usr/bin/bash env
+
+cd ../
+python build_rawframes.py ../../data/thumos14/videos/validation/ ../../data/thumos14/rawframes/validation/ --level 1 --flow_type tvl1 --ext mp4 --task both
+echo "Raw frames (RGB and tv-l1) Generated for val set"
+
+python build_rawframes.py ../../data/thumos14/videos/test/ ../../data/thumos14/rawframes/test/ --level 1 --flow_type tvl1 --ext mp4 --task both
+echo "Raw frames (RGB and tv-l1) Generated for test set"
+
+cd thumos14/

tools/data/thumos14/extract_rgb_frames.sh

+#! /usr/bin/bash env
+
+cd ../
+python build_rawframes.py ../../data/thumos14/videos/validation/ ../../data/thumos14/rawframes/validation/ --level 1 --ext mp4 --task rgb
+echo "Raw frames (RGB only) generated for val set"
+
+python build_rawframes.py ../../data/thumos14/videos/test/ ../../data/thumos14/rawframes/test/ --level 1 --ext mp4 --task rgb
+echo "Raw frames (RGB only) generated for test set"
+
+cd thumos14/

tools/data/thumos14/fetch_tag_proposals.sh

+#! /usr/bin/bash env
+
+PROP_DIR="../../../data/thumos14/proposals"
+
+if [[ ! -d "${PROP_DIR}" ]]; then
+  echo "${PROP_DIR} does not exist. Creating";
+  mkdir -p ${PROP_DIR}
+fi
+
+wget https://open-mmlab.s3.ap-northeast-2.amazonaws.com/mmaction/filelist/thumos14_tag_val_normalized_proposal_list.txt -P ${PROP_DIR}
+wget https://open-mmlab.s3.ap-northeast-2.amazonaws.com/mmaction/filelist/thumos14_tag_test_normalized_proposal_list.txt -P ${PROP_DIR}

tools/data/thumos14/preparing_thumos14.md

+# Preparing THUMOS-14
+
+For basic dataset information, you can refer to the dataset [website](https://www.crcv.ucf.edu/THUMOS14/download.html).
+Before we start, please make sure that the directory is located at `$MMACTION/tools/data/thumos14/`.
+
+## Step 1. Prepare Annotations
+
+First of all, run the following script to prepare annotations.
+
+```shell
+cd $MMACTION/tools/data/thumos14/
+bash download_annotations.sh
+```
+
+## Step 2. Prepare Videos
+
+Then, you can run the following script to prepare videos.
+
+```shell
+cd $MMACTION/tools/data/thumos14/
+bash download_videos.sh
+```
+
+## Step 3. Extract RGB and Flow
+
+This part is **optional** if you only want to use the video loader.
+
+Before extracting, please refer to [install.md](/docs/install.md) for installing [dense_flow](https://github.com/innerlee/denseflow).
+
+If you have plenty of SSD space, then we recommend extracting frames there for better I/O performance.
+
+You can run the following script to soft link SSD.
+
+```shell
+# execute these two line (Assume the SSD is mounted at "/mnt/SSD/")
+mkdir /mnt/SSD/thumos14_extracted/
+ln -s /mnt/SSD/thumos14_extracted/ ../data/thumos14/rawframes/
+```
+
+If you didn't install dense_flow in the installation or only want to play with RGB frames (since extracting optical flow can be time-comsuming), consider running the following script to extract **RGB-only** frames.
+
+```shell
+cd $MMACTION/tools/data/thumos14/
+bash extract_rgb_frames.sh
+```
+
+If both are required, run the following script to extract frames.
+
+```shell
+cd $MMACTION/tools/data/thumos14/
+bash extract_frames.sh tvl1
+```
+
+## Step 4. Fetch File List
+
+You can run the follow script to fetch pre-computed tag proposals.
+
+```shell
+cd $MMACTION/tools/data/thumos14/
+bash fetch_tag_proposals.sh
+```
+
+## Step 5. Check Directory Structure
+
+After the whole data process for THUMOS-14 preparation,
+you will get the rawframes (RGB + Flow), videos and annotation files for THUMOS-14.
+
+In the context of the whole project (for THUMOS-14 only), the folder structure will look like:
+
+```
+mmaction
+├── mmaction
+├── tools
+├── configs
+├── data
+│   ├── thumos14
+│   │   ├── proposals
+│   │   |   ├── thumos14_tag_val_normalized_proposal_list.txt
+│   │   |   ├── thumos14_tag_test_normalized_proposal_list.txt
+│   │   ├── annotations_val
+│   │   ├── annotations_test
+│   │   ├── videos
+│   │   │   ├── val
+│   │   │   |   ├── video_validation_0000001.mp4
+│   │   │   |   ├── ...
+│   │   |   ├── test
+│   │   │   |   ├── video_test_0000001.mp4
+│   │   │   |   ├── ...
+│   │   ├── rawframes
+│   │   │   ├── val
+│   │   │   |   ├── video_validation_0000001
+|   │   │   |   │   ├── img_00001.jpg
+|   │   │   |   │   ├── img_00002.jpg
+|   │   │   |   │   ├── ...
+|   │   │   |   │   ├── flow_x_00001.jpg
+|   │   │   |   │   ├── flow_x_00002.jpg
+|   │   │   |   │   ├── ...
+|   │   │   |   │   ├── flow_y_00001.jpg
+|   │   │   |   │   ├── flow_y_00002.jpg
+|   │   │   |   │   ├── ...
+│   │   │   |   ├── ...
+│   │   |   ├── test
+│   │   │   |   ├── video_test_0000001
+```
+
+For training and evaluating on THUMOS-14, please refer to [getting_started.md](/docs/getting_started.md).