mukesh-dbf/3d_urban_mesh_annotator

Annotation tool for labelling urban scenes stored with textured meshes

Urban Mesh Annotation Tool

Mesh annotation tool for labelling urban scenes. Before you import your model, please check your input mesh is in ascii *.ply format. Note that non-manifold meshes are not supported in this tool. If you still want to use it, please use MeshLab to repair it first. For more information, please visit our project website.

Citation

If you use it in a scientific work, we kindly ask you to cite it:

SUM: A Benchmark Dataset of Semantic Urban Meshes . Weixiao Gao, Liangliang Nan, Bas Boom and Hugo Ledoux. ISPRS Journal of Photogrammetry and Remote Sensing 179 (2021) 108-120.
PDF BibTeX

@article{sum2021,
author = {Weixiao Gao and Liangliang Nan and Bas Boom and Hugo Ledoux},
title = {SUM: A Benchmark Dataset of Semantic Urban Meshes},
journal = {ISPRS Journal of Photogrammetry and Remote Sensing},
volume = {179},
pages = {108-120},
year={2021},
issn = {0924-2716},
doi = {10.1016/j.isprsjprs.2021.07.008},
url = {https://www.sciencedirect.com/science/article/pii/S0924271621001854},
}

Build from source

Windows with CMake

1. Install Eigen and Qt(>5.6)
2. a modified version of CGAL is provided (folder ./CGAL/), use it in CMake.
3. cd src
4. mkdir build && cd build
5. cmake -DCMAKE_BUILD_TYPE=Release .. to compile in release mode and not debug
6. make
7. ./UrbanMeshAnnotator

macOS with CMake

1. brew instal eigen
2. brew install qt5
3. a modified version of CGAL is used (folder ./CGAL/), and you need to use that one: export CGAL_DIR=/path/to/CGAL_FOLDER
4. cd src
5. mkdir build && cd build
6. cmake -DCMAKE_BUILD_TYPE=Release .. to compile in release mode and not debug
7. make
8. ./UrbanMeshAnnotator

How to annotate data

See the instruction in Tutorial.md

Main entry point

UrbanMeshAnnotator main.cpp  

Required Plugins

classification_plugin  
selection_plugin  
ply_plugin  

Required libraries:

Qt5.9  
Eigen  
Boost  

Required sub-modules:

QT:  
	Qt5Core  
	Qt5OpenGL  
	Qt5Svg    
	Qt5Widgets  
	Qt5Gui  
	Qt5Xml  
	Qt5Script  
	imageformats/qjpeg  
	platforms/qwindows