/Building-PCC-Building-Point-Cloud-Completion-Benchmarks

Building-PCC: Building Point Cloud Completion Benchmarks

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

Building-PCC-Building-Point-Cloud-Completion-Benchmarks

This is the implementation of the Builiding-PCC paper: Building-PCC: Building Point Cloud Completion Benchmarks. This repository contains scripts for generating Building-PCC data, links for data downloads, test codes for state-of-the-art methods, pre-trained models, and evaluation results.

Code and Data generation

In the code directory, methods such as PCN, FoldingNet, TopNet, GRNet, SnowflakeNet, PoinTr, and AdaPoinTr are organized within the PoinTr folder, while AnchorFormer is located in its own separate folder. For usage and testing instructions for each method, please refer to the README files in the corresponding subfolders.

The fme folder houses the building instance generation pipeline, and the scripts directory contains scripts for point cloud sampling.

Download dataset

You can access the datasets via the links provided below, which include a small demo dataset for initial testing, as well as the full dataset comprising training, validation, and testing splits.

dataset url Size
BuildingPCC-demo [SurfDrive] / [BaiDuYun] (code:as24) 4.6 MB
BuildingPCC-50k [SurfDrive] / [BaiDuYun] (code:h2b9) 7.43 GB

Download pretrained models

Pre-trained models for all the methods tested are provided:

dataset url CD-L1 F-Score
PCN [SurfDrive] / [BaiDuYun] (code:2s62) 6.12 39.5%
FoldingNet [SurfDrive] / [BaiDuYun] (code:vvqm) 4.92 34.0%
TopNet [SurfDrive] / [BaiDuYun] (code:k9hd) 6.43 26.5%
GRNet [SurfDrive] / [BaiDuYun] (code:mr4l) 5.05 43.1%
SnowflakeNet [SurfDrive] / [BaiDuYun] (code:sga2) 6.61 60.9%
PoinTr [SurfDrive] / [BaiDuYun] (code:qmsd) 1.40 54.8%
AnchorFormer [SurfDrive] / [BaiDuYun] (code:7hev) 1.46 65.8%
AdaPoinTr [SurfDrive] / [BaiDuYun] (code:xf1q) 1.42 70.2%

Citation

If you find our work useful in your research, please consider citing:

@Article{isprs-annals-X-4-W5-2024-179-2024,
AUTHOR = {Gao, W. and Peters, R. and Stoter, J.},
TITLE = {Building-PCC: Building Point Cloud Completion Benchmarks},
JOURNAL = {ISPRS Annals of the Photogrammetry, Remote Sensing and Spatial Information Sciences},
VOLUME = {X-4/W5-2024},
YEAR = {2024},
PAGES = {179--186},
URL = {https://isprs-annals.copernicus.org/articles/X-4-W5-2024/179/2024/},
DOI = {10.5194/isprs-annals-X-4-W5-2024-179-2024}
}

License

This implementation is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License or (at your option) any later version. The full text of the license can be found in the accompanying 'License' file.

If you have any questions, comments, or suggestions, please contact me at gaoweixiaocuhk@gmail.com

Weixiao GAO

May. 1st, 2024