Structured3D

Structured3D is a large-scale photo-realistic dataset containing 3.5K house designs (a) created by professional designers with a variety of ground truth 3D structure annotations (b) and generate photo-realistic 2D images (c).

Paper

Structured3D: A Large Photo-realistic Dataset for Structured 3D Modeling

Jia Zheng*, Junfei Zhang*, Jing Li*, Rui Tang, Shenghua Gao, Zihan Zhou

(* Equal contribution)

Data

The dataset consists of rendering images and corresponding ground truth annotations (e.g., semantic, albedo, depth, surface normal, layout) under different lighting and furniture configurations. Please refer to data organization for more details.

To download the dataset, please fill the agreement form that indicate you agree to the Structured3D Terms of Use. After we receive your agreement form, we will provide download access to the dataset.

Tools

We provide the basic code for viewing the structure annotations of our dataset.

Installation

Clone repository:

git clone [email protected]:bertjiazheng/Structured3D.git

Please use Python 3, then follow installation to install PyMesh (only for plane visualization) and the other dependencies:

conda install -y open3d -c open3d-admin
conda install -y descartes shapely matplotlib

Visualize 3D Annotation

We use open3D for wireframe and plane visualization, please refer to interaction control here.

python visualize_3d.py --path /path/to/dataset --name scene_id --type wireframe/plane/floorplan

Wireframe	Plane	Floorplan

Visualize 2D Layout

python visualize_layout.py --path /path/to/dataset --name scene_id --type empty/simple/full

Citation

Please cite our paper for any purpose of usage.

@article{Structured3D,
  title   = {Structured3D: A Large Photo-realistic Dataset for Structured 3D Modeling},
  author  = {Jia Zheng and Junfei Zhang and Jing Li and Rui Tang and Shenghua Gao and Zihan Zhou},
  journal = {CoRR},
  volume  = {abs/1908.00222},
  year    = {2019}
}

License

The data is released under the Structured3D Terms of Use, and the code is released under the MIT license.

Acknowledgements

We would like to thank Kujiale.com for providing the database of house designs and the rendering engine.