Package: bulldozer-dtm
Bulldozer, a DTM extraction tool requiring only a DSM as input.Key Features•Installation•Quick Start•Documentation•Contribute•Licence•ReferenceKey featuresBulldozeris designed as a pipeline of standalone functions that aims to extract aDigital Terrain Model(DTM) from aDigital Surface Model(DSM).But you can also use one of the following function without running the full pipeline:DSM preprocessingNodata extraction:a group of methods to differentiate and extract nodata related to failed correlations during the DSM computation and those of the image borderDisturbed areas detection:a method to locate disturbed areas. These noisy areas are mainly related to areas in which the correlator has incorrectly estimated the elevation (water or shadow areas).DTM extractionDTM computation:the main method that extracts the DTM from the preprocessed DSM.DTM postprocessingPits detection:a method to detect pits in the provided raster and return the corresponding mask.Pits filling:a method to fill pits in the generated DTM (or input raster).DHM computation:a method to extract theDigital Height Model(DHM).For more information about these functions and how to call them, please refer to thenotebook documentation section.InstallationUsing PypiYou can installBulldozerby running the following command:pipinstallbulldozer-dtmUsing GithubIt is recommended to installBulldozerinto a virtual environment, likecondaorvirtualenv.Installation withvirtualenv:# Clone the projectgitclonehttps://github.com/CNES/bulldozer.gitcdbulldozer/# Create the environmentpython-mvenvbulldozer_venvsourcebulldozer_venv/bin/activate# Install the librarypipinstall.Quick StartFirst you have to create a configuration file or edit theconfiguration_template.yamlavailable in theconfdirectory. You have to update at least the following parameters:# Input DSM path (expected format: "<folder_1>/<folder_2>/<file>.<[tif/tiff]>")dsm_path:"<input_dsm.tif>"# Output directory path (if the directory doesn't exist, create it)output_dir:"<output_dir>"Run the pipeline:Through CLI(Command Line Interface)bulldozer --conf conf/configuration_template.yamlThrough Python API using the config filefrombulldozer.pipeline.bulldozer_pipelineimportdsm_to_dtmdsm_to_dtm(config_path="conf/configuration_template.yaml")Through Python API providing directly the input parameters (missing parameters will be replaced by default values)frombulldozer.pipeline.bulldozer_pipelineimportdsm_to_dtm# Example with a specific number of workersdsm_to_dtm(dsm_path="<input_dsm.tif>",output_dir="<output_dir>",nb_max_workers=16)✅ Done! Your DTM is available in the<output_dir>DocumentationNotebooksFor each section described inKey Featuressection you can follow one of the tutorial notebook:Running Bulldozer (full pipeline)Preprocessing standalone functionsExtraction stepPostprocessing standalone functionsFull documentation (WIP)Bulldozeralso has a more detailed documentation.A high-level overview of how it’s organized will help you know where to look for certain things:Tutorialstake you by the hand through a series of steps to create a DLCooker application. Start here if you’re new to DLCooker.How-to guidesare recipes. They guide you through the steps involved in addressing key problems and use-cases. They are more advanced than tutorials and assume some knowledge of how DLCooker works.Explanation guidesdiscuss key topics and concepts at a fairly high level and provide useful background information and explanation.NOTE:The documentation is not available online yet, it needs to be built manually.To do so, please execute the following command at the root:mkdocs serveContributeTo do a bug report or a contribution, see theContribution Guide.for any help or suggestion, feel free to contact the authors:Dimitri Lallement :dimitri.lallement@cnes.frPierre Lassalle :pierre.lassalle@cnes.frLicenceBulldozerhas a Apache V2.0 license, as found in theLICENSEfile.CreditsPlease refer to theAuthors file.ReferenceD. Lallement, P. Lassalle, Y. Ott, R. Demortier, and J. Delvit, 2022. BULLDOZER: AN AUTOMATIC SELF-DRIVEN LARGE SCALE DTM EXTRACTION METHOD FROM DIGITAL SURFACE MODEL. ISPRS - International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences.