Skip to content

CNES/bulldozer-qgis-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bulldozer, a DTM extraction tool requiring only a DSM as input.

Python Contributions welcome License PyPI Version Documentation


Overview

demo

The Bulldozer QGIS Processing provider is designed to extract Digital Terrain Model (DTM) from raster format Digital Surface Model (DSM) using Bulldozer. It integrates seamlessly with QGIS's Processing framework, offering three main algorithms to cater to different user needs:

  1. Basic Algorithm: Provides a simple setup with an input DTM and an output folder.
  2. Config File Algorithm: Uses an input configuration file to dynamically set parameters.
  3. Advanced Algorithm: Gives users access to all customizable parameters of the Bulldozer.

Quickstart

Installation

Prerequisites

  • QGIS version 3.0 or higher

Installation Steps

You can install the plugin directly within QGIS:

  1. Go to Plugins > Manage and Install Plugins.
  2. Search for "BulldozerDtmProvider".
  3. Click Install Plugin.

Alternative Installation

You can also install the plugin manually:

  1. Download: Download the latest version of the plugin from the QGIS Plugin Hub or Github repository.
  2. Install: Copy the plugin files into your QGIS plugin directory, typically located at:
    • Windows: C:\Users\[username]\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\
    • Linux: ~/.local/share/QGIS/QGIS3/profiles/default/python/plugins/
  3. Restart QGIS: Restart QGIS to load the new plugin.

Running Algorithms

All the algorithms can be accessed through the QGIS Processing Toolbox under Bulldozer. Search for "Bulldozer" to find the algorithms.

  1. Basic Algorithm:

    • Inputs: DSM file path, output folder path and detailed parameters as specified in the advanced settings.
  2. Config File Algorithm:

    • Inputs: Path to configuration file.
  3. Generate Config file:

    • Inputs: Detailed parameters as specified in the advanced settings. Output: config yaml file.

Documentation

License

The Bulldozer QGIS plugin is released under GPL V2. For details, see the LICENSE file in the repository. Bulldozer is licensed under Apache License v2.0. Please refer to the LICENSE file for more details.

Citation

If you use Bulldozer in your research, please cite the following paper:

@article{bulldozer2023,
  title={Bulldozer, a free open source scalable software for DTM extraction},
  author={Dimitri, Lallement and Pierre, Lassalle and Yannick, Ott},
  journal = {The International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences},
  volume = {XLVIII-4/W7-2023},
  year = {2023},
  pages = {89--94},
  url = {https://isprs-archives.copernicus.org/articles/XLVIII-4-W7-2023/89/2023/},
  doi = {10.5194/isprs-archives-XLVIII-4-W7-2023-89-2023}
}