alti analysis

Calcul altimétrique

Ce projet est en cours de développement

Principe

L'objectif de ce projet est de calculer des différentiels entre :

• les MNT LIDAR HD (stockés localement sous forme de fichiers .tif)
• le produit RGE ALTI récupéré via les flux de diffusions de la geoplateforme.

Ce projet utilise une infrastructure de gestion de production par ordinateur IGN GPAO développée au sein de l'IGNF pour la parallélisation des calculs.

Installation

Ce code utilise mamba pour l'installation de l'environnement python (et suppose qu'une version de mamba ou micromamba existe sur l'ordinateur sur lequel on veut installer le programme)

Pour installer micromamba, voir https://mamba.readthedocs.io/en/latest/micromamba-installation.html#umamba-install

Sous windows :

• lancer Miniforge Prompt
• y exectuer install_or_update.bat

Sous linux :

• lancer un terminal
• y executer make install

Usage

Activation de l'environnement

Sous Windows : lancer Miniforge Prompt

Sous Linux : lancer un terminal

Dans les 2 cas :

Activer l'environnement conda :

conda activate altianalysis

Utilisation sur un seul fichier tif

Lancer l'utilitaire avec la commande suivante si vous disposez de deux sources de MNT pour calculer la différence :

python -m altianalysis.compute_difference \
--primary_elevation_file <FIRST_DTM_FILE> \
--second_elevation_file <SECOND_DTM_FILE> \
--name_save_out <NAME_SAVE_OUT>

Dans le cas où vous voudriez calculer la carte de différence entre un MNT et le RGE Alti:

python -m altianalysis.compute_difference \
--primary_elevation_file <FIRST_DTM_FILE> \
--name_save_out <NAME_SAVE_OUT>

options:

• --primary_elevation_file FIRST_DTM_FILE Chemin vers le permier MNT

• --second_elevation_file SECOND_DTM_FILE Chemin vers le deuxième MNT

• --name_save_out NAME_SAVE_OUT Chemin vers le fichier tif de sortie (carte de différence)

Utilisation pour un batch en utilisant la GPAO

Lancer l'utilitaire avec la commande suivante si vous disposez de deux dossiers contenant des MNT dont vous voudriez calculer la différence: NB. Les fichiers doivent avoir les mêmes noms pour être appariés.

python -m altianalysis.run_difference_with_gpao \
    -i <FIRST_DTM_DIR> \
    -ii <SECOND_DTM_DIR> \
    -o <OUT> \
    -l <LOCAL_STORE_PATH> \
    -s <RUNNER_STORE_PATH> \
    [-g <GPAO_HOSTNAME>] \
    [-p <PROJECT_NAME>] \
    [-c <COG_FILENAME>]

Pour calculer des cartes de différences par rapport au flux RGE Alti:

python -m altianalysis.run_difference_with_gpao \
    -i <FIRST_DTM_DIR> \
    -o <OUT> \
    -l <LOCAL_STORE_PATH> \
    -s <RUNNER_STORE_PATH> \
    [-g <GPAO_HOSTNAME>] \
    [-p <PROJECT_NAME>] \
    [-c <COG_FILENAME>]

options:

• -h, --help show this help message and exit
• -i FIRST_DTM_DIR, --primary_dtm_dir FIRST_DTM_DIR Dossier contenant le permier set de MNTs
• -ii SECOND_DTM_DIR, --secondary_dtm_dir SECOND_DTM_DIR Dossier contenant le deuxième set de MNTs ( s'il existe )
• -o OUT, --out OUT Dossier de sortie où seront sauvegardées les cartes de differences
• -l LOCAL_STORE_PATH, --local_store_path LOCAL_STORE_PATH Chemin vers un store commun sur le PC qui lance ce script
• -s RUNNER_STORE_PATH, --runner_store_path RUNNER_STORE_PATH Chemin vers un store commun sur les clients GPAO (Unix path)
• -g GPAO_HOSTNAME, --gpao_hostname GPAO_HOSTNAME Hostname du serveur GPAO
• -p PROJECT_NAME, --project_name PROJECT_NAME Nom de projet pour la GPAO
• -c COG_FILENAME, --cog_filename COG_FILENAME Nom du fichier cog sauvé dans le même dossier que les sorties individuelles. Pas de cog généré si non renseigné

Contribuer

Ce dépôt utilise des pre-commits pour le formattage du code. Avant de d'ajouter des changements, veillez à lancer make install-precommit pour installer les precommit hooks.

Pour lancer les tests : make testing