demix-lib 0.3.3

version 0.3.3 of the DEMIX library

DEMIX library

The DEMIX Library that allow you to get scores for specific DEMIX tiles and DEM You also can download DEMIX Tile associated DEM Layers like SourceMask, Height, ...

Table of contents:

0. Installation
   
1. DEMIX lib functions
   1.1 Getting Scores
   1.2 Getting DEM
   
2. Available DEMs and criterions
   2.1 Dem list
   2.2 Criterion list
   
3. Utility functions
   
4. Usage example
   

Installation

To install the DEMIX library on your python environment :

pip install demix_lib

DEMIX lib functions

Getting Scores

First thing first, you can use the demix api to get directly stats from the desired DEMIX Tile and Criterion
In order to get scores to specific dem and tile, you need to choose a criterion. The criterion list is available here. List of supported dems is also visible here.

import demix_lib as dl

#getting the list of implemented criterions
criterions = dl.get_criterion_list()
#getting the list of supported dems
dems = dl.get_supported_dem_list()

#defining the wanted DEMIX Tile name 
demix_tile_name = "N35YE014F"

#getting the score of each dem, for the criterion 
for dem in  dems:
    for criterion in criterions:
        print(dl.get_score(demix_tile_name=demix_tile_name, dem=dem, criterion=criterion))

Getting DEM

To go further : You can always use your own criterions by downloading the wanted layer on your DEMIX tile and apply custom code to it.
To download a DEM layer for a specific DEMIX Tile :

import demix_lib as dl
import matplotlib as plt #we use matplotlib to visualise the downloaded layer
from matplotlib import cm #we use cm to make a legend/colormap
from matplotlib.lines import Line2D #to add colored line in the legend

#defining wanted tile
demix_tile_name = "N35YE014F"
#asking for the SourceMask layer for the CopDEM_GLO-30 dem and the tile N64ZW019C
response = dl.download_layer(demix_tile_name=demix_tile_name,dem="CopDEM_GLO-30",layer="SourceMask")

#creating legend for the plot
legend_handle = list(map(int, response['values'].keys()))
legend_label = list(response['values'].values())
#defining the colormap for the layer (the layer has 6 values)
color_map = cm.get_cmap('rainbow',6)
#we use plt to look at the data
plt.imshow(response["data"], interpolation='none', cmap=color_map, vmin=0, vmax=6)
#creating legend values using the color map and the values stored
custom_handles = []
for value in legend_handle:
    custom_handles.append(Line2D([0], [0], color=color_map(value), lw=4))
plt.legend( custom_handles,legend_label)
#show the layer with custom legend and color map
plt.show()

Utility functions

The DEMIX lib give you some utility functions that allow you to get or print informations about currently implemented criterions, available DEMs, layers...

import demix_lib as dl

#get or show the layers that you can ask in a download_layer function
layer_list = dl.get_layer_list()
dl.print_layer_list()
#get or show the full dem list
dem_list = dl.get_dem_list()
dl.print_dem_list()
#get or show the supported dem list
supported_dem_list = dl.get_supported_dem_list()
dl.print_supported_dem_list()
#get or show the implemented criterion list
criterion_list = dl.get_criterion_list()
dl.print_criterion_list()

Available DEMs and criterions

DEMs list

DEM name	supported
ALOS World 3D	no
ASTER GDEM	no
CopDEM GLO-30	yes
NASADEM	no
SRTMGL1	yes

Criterion list

Criterion name	Criterion id	version	Date	Category	Target	Description	Requirement
Product fractional cover	A01	0.1	20211103	A-completeness	All	indique le pourcentage dela tuile demix qui est ouverte par le produit, area couverte divisée par area de la tuile	Area computation on an ellipsoïd and simple
Valid data fraction	A02	0.1	20211103	A-completeness	All	Area d'une demix tile qui est couverte par une data valide , on fait la somme de chaque cellule avec des données valide et on calcule l'aire puis on fait ce total divisé par l'aire totale de la tuile demix	metadata no/void.un masque par pixel doit indiqué si ils sont extrapole, infilled, ou masqué sinon c'est recalé
Primary data	A03	0.1	20211103	A-completeness	All	indique l'aire dans une demix tile couverte par une valid data provenant de la source principale	metadata no/void.un masque par pixel doit indiqué si ils sont extrapole, infilled, ou masqué sinon c'est recalé
Valid land fraction	A04	0.1	20211103	A-completeness	All	indique l'aire dans une demix tile couverte par une valid data provenant de la source principale	metadata no/void.un masque par pixel doit indiqué si ils sont extrapole, infilled, ou masqué sinon c'est recalé
Primary land fraction	A05	0.1	20211103	A-completeness	All	indique aire couverte par une donnée primaire en land	metadata no/void.un masque par pixel doit indiqué si ils sont extrapole, infilled, ou masqué sinon c'est recalé

Layer list

Layer name
Height
validMask
SourceMask
landWaterMask