Skip to content

IGNF/myria3d

Repository files navigation

Myria3D: Aerial Lidar HD Semantic Segmentation with Deep Learning

PyTorch Lightning Config: Hydra

CICD Documentation Build



Myria3D is a deep learning library designed with a focused scope: the multiclass semantic segmentation of large scale, high density aerial Lidar points cloud.

The library implements the training of 3D Segmentation neural networks, with optimized data-processing and evaluation logics at fit time. Inference on unseen, large scale point cloud is also supported. It allows for the evaluation of single-class IoU on the full point cloud, which results in reliable model evaluation.

Myria3D is built upon PyTorch. It keeps the standard data format from Pytorch-Geometric. Its structure was bootstraped from this code template, which heavily relies on Hydra and Pytorch-Lightning to enable flexible and rapid iterations of deep learning experiments.

Although the library can be extended with new neural network architectures or new data signatures, it makes some opiniated choices in terms of neural network architecture, data processing logics, and inference logic. Indeed, it is initially built with the French "Lidar HD" project in mind, with the ambition to map France in 3D with 10 pulse/m² aerial Lidar by 2025. The data will be openly available, including a semantic segmentation with a minimal number of classes: ground, vegetation, buildings, vehicles, bridges, others.

→ For installation and usage, please refer to Documentation.

→ A stable, production-ready version of Myria3D is tracked by a Production Release. In the release's assets are a trained multiclass segmentation model as well as the necessary configuration file to perform inference on French "Lidar HD" data. Those assets are provided for convenience, and are subject to change in time to reflect latest model training.


Please cite Myria3D if it helped your own research. Here is an example BibTex entry:

@misc{gaydon2022myria3d,
  title={Myria3D: Deep Learning for the Semantic Segmentation of Aerial Lidar Point Clouds},
  url={https://github.com/IGNF/myria3d},
  author={Charles Gaydon},
  year={2022},
  note={IGN (French Mapping Agency)},
}