update docs for 300VW

open-mmlab · Mar 26, 2024 · 512211b · 512211b
1 parent 7480919
commit 512211b
Show file tree

Hide file tree

Showing 7 changed files with 132 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -243,6 +243,7 @@ A summary can be found in the [Model Zoo](https://mmpose.readthedocs.io/en/lates
 - [x] [Human3.6M](https://mmpose.readthedocs.io/en/latest/model_zoo_papers/datasets.html#human3-6m-tpami-2014) \[[homepage](http://vision.imar.ro/human3.6m/description.php)\] (TPAMI'2014)
 - [x] [COCO](https://mmpose.readthedocs.io/en/latest/model_zoo_papers/datasets.html#coco-eccv-2014) \[[homepage](http://cocodataset.org/)\] (ECCV'2014)
 - [x] [CMU Panoptic](https://mmpose.readthedocs.io/en/latest/model_zoo_papers/datasets.html#cmu-panoptic-iccv-2015) \[[homepage](http://domedb.perception.cs.cmu.edu/)\] (ICCV'2015)
+- [x] [300VW](https://mmpose.readthedocs.io/en/latest/model_zoo_papers/datasets.html#300w-imavis-2016) \[[homepage](https://ibug.doc.ic.ac.uk/resources/300-VW/)\] (ICCV'2015)
 - [x] [DeepFashion](https://mmpose.readthedocs.io/en/latest/model_zoo_papers/datasets.html#deepfashion-cvpr-2016) \[[homepage](http://mmlab.ie.cuhk.edu.hk/projects/DeepFashion/LandmarkDetection.html)\] (CVPR'2016)
 - [x] [300W](https://mmpose.readthedocs.io/en/latest/model_zoo_papers/datasets.html#300w-imavis-2016) \[[homepage](https://ibug.doc.ic.ac.uk/resources/300-W/)\] (IMAVIS'2016)
 - [x] [RHD](https://mmpose.readthedocs.io/en/latest/model_zoo_papers/datasets.html#rhd-iccv-2017) \[[homepage](https://lmb.informatik.uni-freiburg.de/resources/datasets/RenderedHandposeDataset.en.html)\] (ICCV'2017)

diff --git a/docs/en/dataset_zoo/2d_face_keypoint.md b/docs/en/dataset_zoo/2d_face_keypoint.md
@@ -6,6 +6,7 @@ If your folder structure is different, you may need to change the corresponding
 MMPose supported datasets:
 
 - [300W](#300w-dataset) \[ [Homepage](https://ibug.doc.ic.ac.uk/resources/300-W/) \]
+- [300VW](#300vw-dataset) \[ [Homepage](https://ibug.doc.ic.ac.uk/resources/300-VW/) \]
 - [WFLW](#wflw-dataset) \[ [Homepage](https://wywu.github.io/projects/LAB/WFLW.html) \]
 - [AFLW](#aflw-dataset) \[ [Homepage](https://www.tugraz.at/institute/icg/research/team-bischof/lrs/downloads/aflw/) \]
 - [COFW](#cofw-dataset) \[ [Homepage](http://www.vision.caltech.edu/xpburgos/ICCV13/) \]
@@ -94,6 +95,60 @@ mmpose
                      ...
 ```
 
+## 300VW Dataset
+
+<!-- [DATASET] -->
+
+<details>
+<summary align="right"><a href="https://www.cv-foundation.org/openaccess/content_iccv_2015_workshops/w25/papers/Shen_The_First_Facial_ICCV_2015_paper.pdf">300VW (ICCVW'2015)</a></summary>
+
+```bibtex
+@inproceedings{shen2015first,
+  title={The first facial landmark tracking in-the-wild challenge: Benchmark and results},
+  author={Shen, Jie and Zafeiriou, Stefanos and Chrysos, Grigoris G and Kossaifi, Jean and Tzimiropoulos, Georgios and Pantic, Maja},
+  booktitle={Proceedings of the IEEE international conference on computer vision workshops},
+  pages={50--58},
+  year={2015}
+}
+```
+
+</details>
+
+For 300VW data, please register and download images from [300VW Dataset](https://ibug.doc.ic.ac.uk/download/300VW_Dataset_2015_12_14.zip/).
+Unzip and use the "tools/dataset_converters/300vw2coco.py" to process the data.
+
+<!-- Please download the annotation files from [300w_annotations](https://download.openmmlab.com/mmpose/datasets/300w_annotations.tar). -->
+
+Put the 300VW under {MMPose}/data, and make them look like this:
+
+```text
+mmpose
+├── mmpose
+├── docs
+├── tests
+├── tools
+├── configs
+`── data
+    │── 300vw
+        |── annotations
+        |   |── train.json
+        |   |── test_1.json
+        |   |── test_2.json
+        |   `── test_3.json
+        `── images
+            |── 001
+            |   `── imgs
+            |       |── 000001.png
+            |       |── 000002.png
+            |       ...
+            |── 002
+            |   `── imgs
+            |       |── 000001.png
+            |       |── 000002.png
+            |       ...
+            |   ...
+```
+
 ## WFLW Dataset
 
 <!-- [DATASET] -->

diff --git a/docs/src/papers/datasets/300vw.md b/docs/src/papers/datasets/300vw.md
@@ -0,0 +1,18 @@
+# 300 faces in-the-wild challenge: Database and results
+
+<!-- [DATASET] -->
+
+<details>
+<summary align="right"><a href="https://www.cv-foundation.org/openaccess/content_iccv_2015_workshops/w25/papers/Shen_The_First_Facial_ICCV_2015_paper.pdf">300VW (ICCVW'2015)</a></summary>
+
+```bibtex
+@inproceedings{shen2015first,
+  title={The first facial landmark tracking in-the-wild challenge: Benchmark and results},
+  author={Shen, Jie and Zafeiriou, Stefanos and Chrysos, Grigoris G and Kossaifi, Jean and Tzimiropoulos, Georgios and Pantic, Maja},
+  booktitle={Proceedings of the IEEE international conference on computer vision workshops},
+  pages={50--58},
+  year={2015}
+}
+```
+
+</details>
diff --git a/docs/zh_cn/dataset_zoo/2d_face_keypoint.md b/docs/zh_cn/dataset_zoo/2d_face_keypoint.md
@@ -6,6 +6,7 @@ If your folder structure is different, you may need to change the corresponding
 MMPose supported datasets:
 
 - [300W](#300w-dataset) \[ [Homepage](https://ibug.doc.ic.ac.uk/resources/300-W/) \]
+- [300VW](#300vw-dataset) \[ [Homepage](https://ibug.doc.ic.ac.uk/resources/300-VW/) \]
 - [WFLW](#wflw-dataset) \[ [Homepage](https://wywu.github.io/projects/LAB/WFLW.html) \]
 - [AFLW](#aflw-dataset) \[ [Homepage](https://www.tugraz.at/institute/icg/research/team-bischof/lrs/downloads/aflw/) \]
 - [COFW](#cofw-dataset) \[ [Homepage](http://www.vision.caltech.edu/xpburgos/ICCV13/) \]
@@ -94,6 +95,61 @@ mmpose
                      ...
 ```
 
+## 300VW Dataset
+
+<!-- [DATASET] -->
+
+<details>
+<summary align="right"><a href="https://www.cv-foundation.org/openaccess/content_iccv_2015_workshops/w25/papers/Shen_The_First_Facial_ICCV_2015_paper.pdf">300VW (ICCVW'2015)</a></summary>
+
+```bibtex
+@inproceedings{shen2015first,
+  title={The first facial landmark tracking in-the-wild challenge: Benchmark and results},
+  author={Shen, Jie and Zafeiriou, Stefanos and Chrysos, Grigoris G and Kossaifi, Jean and Tzimiropoulos, Georgios and Pantic, Maja},
+  booktitle={Proceedings of the IEEE international conference on computer vision workshops},
+  pages={50--58},
+  year={2015}
+}
+```
+
+</details>
+
+300VW dataset follows the same mark-up (i.e. set of facial landmarks) used in the 300W.
+For 300VW data, please register and download images from [300VW Dataset](https://ibug.doc.ic.ac.uk/download/300VW_Dataset_2015_12_14.zip) .
+Unzip and use the "tools/dataset_converters/300vw2coco.py" to process the data.
+
+<!-- Please download the annotation files from [300w_annotations](https://download.openmmlab.com/mmpose/datasets/300w_annotations.tar). -->
+
+Put the 300VW under {MMPose}/data, and make them look like this:
+
+```text
+mmpose
+├── mmpose
+├── docs
+├── tests
+├── tools
+├── configs
+`── data
+    │── 300vw
+        |── annotations
+        |   |── train.json
+        |   |── test_1.json
+        |   |── test_2.json
+        |   `── test_3.json
+        `── images
+            |── 001
+            |   `── imgs
+            |       |── 000001.png
+            |       |── 000002.png
+            |       ...
+            |── 002
+            |   `── imgs
+            |       |── 000001.png
+            |       |── 000002.png
+            |       ...
+            |   ...
+```
+
 ## WFLW Dataset
 
 <!-- [DATASET] -->

diff --git a/tests/data/300vw/test_300vw.json → tests/data/300vw/anno_300vw.json b/tests/data/300vw/test_300vw.json → tests/data/300vw/anno_300vw.json
diff --git a/tests/test_datasets/test_datasets/test_face_datasets/test_face_300vw_dataset.py b/tests/test_datasets/test_datasets/test_face_datasets/test_face_300vw_dataset.py
@@ -14,7 +14,7 @@ class TestFace300VWDataset(TestCase):
     def build_face_300vw_dataset(self, **kwargs):
 
         cfg = dict(
-            ann_file='test_300vw.json',
+            ann_file='anno_300vw.json',
             bbox_file=None,
             data_mode='topdown',
             data_root='tests/data/300vw',

diff --git a/tools/dataset_converters/300vw2coco.py b/tools/dataset_converters/300vw2coco.py
@@ -199,7 +199,7 @@ def _calculate_annotation_properties(self, annotation, keypoints):
 
     def convert_annotations(self,
                             video_list=None,
-                            json_save_name='test_300vw.json'):
+                            json_save_name='anno_300vw.json'):
         """Convert 300vw original annotations to coco format."""
         video_list = self._get_video_list(video_list)
         image_id = 0