From 512211b4fda1026081773d26554b662d18a2b9ae Mon Sep 17 00:00:00 2001 From: KeqiangSun Date: Tue, 26 Mar 2024 06:02:27 +0000 Subject: [PATCH] update docs for 300VW --- README.md | 1 + docs/en/dataset_zoo/2d_face_keypoint.md | 55 ++++++++++++++++++ docs/src/papers/datasets/300vw.md | 18 ++++++ docs/zh_cn/dataset_zoo/2d_face_keypoint.md | 56 +++++++++++++++++++ .../{test_300vw.json => anno_300vw.json} | 0 .../test_face_300vw_dataset.py | 2 +- tools/dataset_converters/300vw2coco.py | 2 +- 7 files changed, 132 insertions(+), 2 deletions(-) create mode 100644 docs/src/papers/datasets/300vw.md rename tests/data/300vw/{test_300vw.json => anno_300vw.json} (100%) diff --git a/README.md b/README.md index 6d0fcb2134..a45e03ec9f 100644 --- 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 index 62f66bd82b..9cc14eb548 100644 --- 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 + + + +
+300VW (ICCVW'2015) + +```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} +} +``` + +
+ +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. + + + +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 diff --git a/docs/src/papers/datasets/300vw.md b/docs/src/papers/datasets/300vw.md new file mode 100644 index 0000000000..53859f6da5 --- /dev/null +++ b/docs/src/papers/datasets/300vw.md @@ -0,0 +1,18 @@ +# 300 faces in-the-wild challenge: Database and results + + + +
+300VW (ICCVW'2015) + +```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} +} +``` + +
diff --git a/docs/zh_cn/dataset_zoo/2d_face_keypoint.md b/docs/zh_cn/dataset_zoo/2d_face_keypoint.md index 62f66bd82b..b66ad47a1d 100644 --- 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 + + + +
+300VW (ICCVW'2015) + +```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} +} +``` + +
+ +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. + + + +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 diff --git a/tests/data/300vw/test_300vw.json b/tests/data/300vw/anno_300vw.json similarity index 100% rename from tests/data/300vw/test_300vw.json rename to 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 index f4c26a17cd..1ec2348458 100644 --- 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 index 09759c34eb..8be0083266 100644 --- 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