/demcompare

3D DEM compare CNES tool

Primary LanguagePythonApache License 2.0Apache-2.0

Demcompare

DEMcompare, a DEM comparison tool

Python Contributions welcome License Docs

OverviewInstallUsageOutputs processingReferences

Overview

Demcompare is a python software that aims at comparing two DEMs together.

A DEM is a 3D computer graphics representation of elevation data to represent terrain.

Demcompare has several characteristics:

  • Works whether or not the two DEMs share common format projection system, planimetric resolution, and altimetric unit.
  • Performs the coregistration based on the Nuth & Kääb universal coregistration method.
  • Offers two coregistration modes to choose which of both DEMs is to be adapted during coregistration.
  • Provides a wide variety of standard metrics which can be classified.
  • Classifies the stats by slope ranges by default, but one can provide any other data to classify the stats.

Install

Only Linux Plaforms are supported (virtualenv or bare machine) with Python >= 3.7 installed.

Demcompare is available on Pypi and can be typically installed through a virtualenv:

python3 -m venv venv
source venv/bin/activate
pip install demcompare

Usage

Download our data sample and run the python script demcompare:

# download data samples
wget https://raw.githubusercontent.com/CNES/demcompare/master/data_samples/images/srtm_sample.zip  # input stereo pair
wget https://raw.githubusercontent.com/CNES/demcompare/master/data_samples/json_conf_files/nuth_kaab_config.json # configuration file

# uncompress data
unzip srtm_sample.zip 

#run demcompare
demcompare nuth_kaab_config.json

The results can be observed with:

    firefox test_output/doc/published_report/html/demcompare_report.html &

To go further

Please consult our online documentation.

You will learn:

Licensing

demcompare software is distributed under the Apache Software License (ASL) v2.0.

See LICENSE file or http://www.apache.org/licenses/LICENSE-2.0 for details.

Copyrights and authoring can be found in NOTICE file.

Related

CARS - CNES 3D reconstruction software

Pandora - CNES Stereo Matching framework