{"id":33174724,"url":"https://github.com/ericsujw/Matterport3DLayoutAnnotation","last_synced_at":"2025-11-20T20:01:41.288Z","repository":{"id":62729036,"uuid":"216430565","full_name":"ericsujw/Matterport3DLayoutAnnotation","owner":"ericsujw","description":"Layout annotation on a subset of Matterport3D dataset","archived":false,"fork":false,"pushed_at":"2020-12-28T12:47:47.000Z","size":1594,"stargazers_count":61,"open_issues_count":4,"forks_count":9,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-04-30T20:33:44.438Z","etag":null,"topics":["3d-layout","3d-reconstruction","computer-vision","room-layout"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ericsujw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-20T21:35:08.000Z","updated_at":"2024-03-14T07:57:40.000Z","dependencies_parsed_at":"2022-11-05T08:01:01.111Z","dependency_job_id":null,"html_url":"https://github.com/ericsujw/Matterport3DLayoutAnnotation","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ericsujw/Matterport3DLayoutAnnotation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericsujw%2FMatterport3DLayoutAnnotation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericsujw%2FMatterport3DLayoutAnnotation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericsujw%2FMatterport3DLayoutAnnotation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericsujw%2FMatterport3DLayoutAnnotation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ericsujw","download_url":"https://codeload.github.com/ericsujw/Matterport3DLayoutAnnotation/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ericsujw%2FMatterport3DLayoutAnnotation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":285503668,"owners_count":27182913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-20T02:00:05.334Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-layout","3d-reconstruction","computer-vision","room-layout"],"created_at":"2025-11-16T02:00:33.687Z","updated_at":"2025-11-20T20:01:41.285Z","avatar_url":"https://github.com/ericsujw.png","language":null,"funding_links":[],"categories":["Datasets"],"sub_categories":["Scene level"],"readme":"# The MatterportLayout dataset\n\nThis dataset extends the Matterport3D dataset with general Manhattan layout annotations and is used in our work \"[Manhattan Room Layout Reconstruction from a Single 360\u0026deg; image: A Comparative Study of State-of-the-art Methods](http://arxiv.org/abs/1910.04099)\" for performance evaluation.\n\n## Pre-processing\nWe released only the annotated layout files. To generate the corresponding RGB panoramas, use the following instructions:\n1. Download the **[Matterport3D](https://github.com/niessner/Matterport)** dataset.\n2. Follow the Matlab codes in **[PanoBasic/demo_matterport.m](https://github.com/yindaz/PanoBasic/blob/master/demo_matterport.m#L44)** to stitch the skybox images of the Matterport3D into the equirectangular panoramas.\n3. Run the script provided in **[PanoAnnotator/pre-process](https://github.com/SunDaDenny/PanoAnnotator#pre-process)** to generate Manhattan-aligned panoramas.\n\n## Data format\n* **Panorama list**: The dataset includes 2295 panoramas selected from the Matterport3D dataset and we split the images into [train](data_list/mp3d_train.txt)/[val](data_list/mp3d_val.txt)/[test](data_list/mp3d_test.txt) lists.\n* **Annotation format**: We use the same the annotation format as [DuLa-Net](https://github.com/SunDaDenny/DuLa-Net) and [PanoAnnotator](https://github.com/SunDaDenny/PanoAnnotator). An example json file is shown below. Please refer to these two repos for more details. Note that we've aligned all the annotated layouts to the camera height of 1.6m.\n```javascript\n{\n    \"cameraHeight\": 1.6, // distance between camera and floor\n    \"layoutHeight\": 2.9809624004364013, // distance between floor and ceiling\n    \"layoutObj2ds\": { // door or window labeling block\n        \"num\": 0,\n        \"obj2ds\": []\n    },\n    \"layoutPoints\": { // corner labeling block, we only annotate the corner in the horizontal direction because you can easily get the corner in the vertical direction from cameraHeight and layoutHeight.\n        \"num\": 6, // corner number in the horizontal direction\n        \"points\": [ // List of the corner\n            {\n                \"coords\": [ // uv coordintate of the corner on the panorama\n                    0.7081447345651483, // u coordintate of the corner on the panorama\n                    0.5 // v coordintate of the corner on the panorama. We annotate on horizon line, then calculate the vertical position by cameraHeight and layoutHeight.\n                ],\n                \"id\": 0, // id number\n                \"xyz\": [ // project the corner on to the 3D coordinate \n                    3.0078125, // x value\n                    0.0, // y value\n                    -0.8097623087756155 // z value\n                ]\n            },\n            {...}\n        ]\n    },\n    \"layoutWalls\": { // layout walls represented by plane equation\n        \"num\": 6, // wall number\n        \"walls\": [ // list of wall\n            {\n                \"id\": 0, // id number\n                \"normal\": [ // plane equation's normal\n                    1.0,\n                    0.0,\n                    -0.0\n                ],\n                \"planeEquation\": [ // plane equation\n                    1.0, // a\n                    0.0, // b\n                    -0.0, // c\n                    -3.0078125 // d\n                ],\n                \"pointsIdx\": [ // which two points construct this wall\n                    0,\n                    1\n                ],\n                \"width\": 2.8476272687756152 // the wall width\n            },\n            {...}\n        ]\n    },\n    \"panoId\": \"nothing\" // a simple ID of panorama\n}\n```\n* **File name**: We zip all the annotation files in the [label_data.zip](label_data.zip). The filename `\u003cdir1\u003e_\u003cdir2\u003e_label.json` follows the folder structure of Matterport3D dataset.\n\n## Citation\nIf you use this dataset for your research, please cite our paper as follows:\n```\n@article{zou20193d,\n  title={Manhattan Room Layout Reconstruction from a Single 360$^{\\circ}$ image: A Comparative Study of State-of-the-art Methods},\n  author={Zou, Chuhang and Su, Jheng-Wei and Peng, Chi-Han and Colburn, Alex and Shan, Qi and Wonka, Peter and Chu, Hung-Kuo and Hoiem, Derek},\n  journal={arXiv preprint arXiv:1910.04099},\n  year={2019}\n}\n```\n\n## License\n\nThe data is released under the [Matterport3D Terms of Use](http://kaldir.vc.in.tum.de/matterport/MP_TOS.pdf), and the code is released under the MIT license. By using this dataset, you agree to all the terms in the [Matterport3D Terms of Use](http://kaldir.vc.in.tum.de/matterport/MP_TOS.pdf).\n\n## Acknowledgement\nFor all the layouts in the dataset, we started with initial layouts from [LayoutMP3D](https://arxiv.org/abs/2011.11498), which is also annotated with **[PanoAnnotator](https://github.com/SunDaDenny/PanoAnnotator)**.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericsujw%2FMatterport3DLayoutAnnotation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fericsujw%2FMatterport3DLayoutAnnotation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericsujw%2FMatterport3DLayoutAnnotation/lists"}