Skip to content

Deep Fashion3D: A Dataset and Benchmark for 3D Garment Reconstruction from Single Images (ECCV2020)

License

Notifications You must be signed in to change notification settings

GAP-LAB-CUHK-SZ/deepFashion3D

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 

Repository files navigation

Deep Fashion3D: A Dataset and Benchmark for 3D Garment Reconstruction from Single Images (ECCV 2020)

Heming Zhu · Yu Cao · Hang Jin · Weikai Chen · Dong Du · Zhangye Wang · Shuguang Cui · Xiaoguang Han*


News

2023-6-25 Deep Fashion3D V2 is available, where the dense garment point clouds are equiped with more accurate feature line annotation, registered mesh with category-specific toplogy and high-resolution texture maps! Click Here to browse the release note.

2020-8-24 Deep Fashion3D is released with garment models. Feature line annotations and garment pose annotations will be released soon are released. Click Here to browse the project page.


Download

You may find both DeepFashion3D and Deep Fashion3D V2 in the following link. Please fill in the form to get password for unzipping the compressed file for DeepFashion3D and Deep Fashion3D V2.

The download link for Deep Fashshion3D V2:
Google Drive: [Google Drive]
Baiduyun Drive: [Baidu Drive], Password:df3d

The download link for the original Deep Fashshion3D:
Google Drive: [Google Drive]
Baiduyun Drive: [Baidu Drive], Password:df3d


Data Organization

Deep Fashion3D V2

plot

Dense Point Cloud

The dense garment point cloud provided in Deep Fashion3D V2 follows the below structure, note that we coarsely aligned the garments with respect to a t-posed SMPL model. Therefore, the rotation and translation for Deep Fashion3D V2 may be slightly different from the original version.

deepFashion3DV2/point_cloud
|--- 1---1-1.ply # 1-1 indicates the first pose of garment #1
|    |---1-2.ply # high-resolution GT point cloud
|
|--- 2---2-1.ply
|    ....
|
|--- cloth_type_list.txt # clothes and types

Registered Garment Mesh

The registered garment mesh provided in Deep Fashion3D V2 follows the below structure. Note that we filtered the implausible registrations manually so that the number of registered garment meshes may not match the number of dense garment point clouds.

deepFashion3DV2/filtered_registered_mesh
|-- 1-1
|   |-- 1-1_tex.png  
|   |-- model_cleaned.obj 
|   |-- model_cleaned.obj.mtl
|
|-- 2-2
    |-- 2-2_tex.png  
    |-- model_cleaned.obj
    |-- model_cleaned.obj.mtl
    

For each successful registration, we provide registered garment mesh with category-specific triangulation and high resolution(2048px x 2048px) textures.

Garment Feature Line Annotation

The garment feature line annotation provided in Deep Fashion3D V2 follows the below structure. Note that we filtered the implausible annotations manually so that the number of annotations may not match the number of dense garment point clouds.

deepFashion3DV2/featureline_annotation
| --- 1 --- 1_1
|     |      |--- 1_1_1.ply # feature line annotations     
|     |      |--- 1_1_2.ply     
|     |      |--- ...   
|     |            
|     | --- 1_2
|
| --- 2
| --- ...

Different from the annotations in the original Deep Fashion3D, we only annotate the "outermost" curves of the garments as the feature line. For the upper-body clothing, i.e., long/short/no sleeve uppers, and long/short/no sleeve dresses, Deep Fashion3D V2 contains following types of feature line annotations:

  • 1 : Neck line
  • 2 : Left cuff
  • 3 : Right cuff
  • 4 : Hemline

For long/short pants, Deep Fashion3D V2 contains following types of feature line annotations:

  • 1 : Waist Line
  • 2 : Left hemline of the trousers
  • 3 : Right hemline of the trousers

For long/short skirts, Deep Fashion3D V2 contains following types of feature line annotations:

  • 1 : Waist Line
  • 2 : Hemline

Garment Pose Annotations

The garment pose annotations provided in Deep Fashion3D V2 follow the below structure. Each file contains the SMPL pose parameters, scale, and translation. Please also checkout the discussion here regarding loading the pose annotations.

deepFashion3DV2/pose_estimation
|-- 1
|   |-- 1_1.pkl
|   |-- 1_2.pkl
|-- 2
    |-- 2_1.pkl

Deep Fashion3D

The original Deep Fashion3D dataset follows the below structure:

deepFashion3D/deep_fashion_3d_point_cloud
|--- 1---1-1.ply # 1-1 indicates the first pose of garment #1
|    |---1-2.ply # high-resolution GT point cloud
|
|--- 2---2-1.ply
|    ....
|
|--- cloth_type_list.txt # clothes and types

deepFashion3D/deep_fashion_3d_point_cloud_annotations
| --- 1 --- 1-1
|     |      |--- 1-1-1.ply # feature line annotations        
|     |      |--- 1-1-2.ply    
|     |      |--- ...      
|     |            
|     | --- 1-2
|
| --- 2
| --- ...

Upper-body clothes in Deep Fashion3D contain following types of annotations:

  • 1 : Neck line
  • 2 : Left shoulder line
  • 3 : Left elbow line
  • 4 : Left wrist line
  • 7 : Right shoulder line
  • 8 : Right elbow line
  • 9 : Right wrist line
  • 10: Waist line
  • 11: Hemline

Lower body clothes in Deep Fashion3D contain following types of annotations

  • 1 : Waist Line
  • 2 : Left Knee
  • 3 : Left Ankle
  • 4 : Right Knee
  • 5 : Right Ankle
  • 6 : Hemline


Citation

If you use Deep Fashion3D or Deep Fashion3D V2 in your work, please consider citing our paper!

@inproceedings{zhu2020deep,
    title={Deep Fashion3D: A Dataset and Benchmark for 3D Garment Reconstruction from Single Images}, 
    booktitle={Computer Vision -- ECCV 2020},
    author={Heming, Zhu and Yu, Cao and Hang, Jin and Weikai, Chen and Dong, Du and Zhangye, Wang and Shuguang, Cui and Xiaoguang, Han},
    year={2020},
    publisher={Springer International Publishing},
    pages={512--530},
    isbn={978-3-030-58452-8}
}