Écriture de l'outil tms-toolbox (nom provisoire)

[XavDmz]

Objectifs

Il s'agit de porter en python dans ce dépôt l'outil perl "tms-toolbox" du dépôt rok4/tools. (Lien vers la documentation d'origine.)
Ce portage est l'occasion d'ajouter des fonctionnalités dont le manque a été exprimé par des utilisateurs de la version perl.
Ce portage peut aussi être l'occasion de retirer des fonctionnalités superflues, inutilisées. Encore faudrait-il les identifier.

Fonctionnalités

Le fonction de cet outil est d'assurer des conversion de "coordonnées" entre différents systèmes de représentation :

• le système spatial de référence (SRS) : coordonnées ou géométries
• les matrices de tuiles du tile matrix set (TMS) : niveau, indices de la tuile dans la matrice associée à ce niveau
• la matrices des dalles : niveau, indices de la dalle dans la matrice associée à ce niveau
• stockage : chemin d'accès à une image

Conversions possibles

En reprenant la nomenclature de la documention originale, les conversions prévues sont les suivantes, sans avoir trié et retiré les anciennes fonctionnalités superflues :

Entrée	Sortie	Options obligatoires	Options facultatives	Actualité
BBOX	GETTILE_PARAMS	level, slabsize		ancienne
BBOX	SLAB_INDICES	level, slabsize		ancienne
BBOX	SQL_FILE	level, slabsize		ancienne, abandonnée
BBOXES_LIST	SLAB_INDICES	level, slabsize		ancienne
GEOM_FILE	GETTILE_PARAMS	level, slabsize		ancienne
GEOM_FILE	SLAB_INDICES	level, slabsize		ancienne
GEOM_FILE	SLABS_COUNT	level, slabsize		ancienne
GEOM_FILE	SQL_FILE	level, slabsize		ancienne, abandonnée
POINT	SLAB_INFO	slabsize	level, storage	ancienne
POINT	TILE_INFO		level	ancienne
PYRAMID_LIST	GEOM_FILE	level, slabsize		ancienne
PYRAMID_LIST	GETTILE_PARAMS	slabsize	ratio	ancienne
SLAB_INDICE	TFW_FILE	level, slabsize		ancienne
SLAB_INDICE	GEOM	level, slabsize		ancienne
SLAB_INDICES_LIST	GETMAP_PARAMS	level, slabsize	ratio	ancienne
SLAB_INDICES_LIST	SLAB_PATHS	level, slabsize	above	ancienne
SLAB_PATH	GEOM	level, slabsize	storage	ancienne
TILE_INDICE	SLAB_INFO	level, slabsize	storage	ancienne
TILE_INDICE	GETMAP_PARAMS	level	buffer	ancienne
TILES_INDICES_LIST	BBOX	level		nouvelle
TILES_INDICES_LIST	GEOM	level		nouvelle, à confirmer

Autres fonctionnalités

• Documentation simple en ligne de commande, en exétuctant l'outil avec les arguments standard -h, et --help. (--usage aussi ?).
• Affichage du numéro de version en ligne de commande avec l'argument --version.
• Permettre l'exécution d'une suite de conversions liées à un même TMS, et un même jeu de données le cas échéant, en limitant les opérations redondantes.

[XavDmz]

Pour le moment, j'en suis encore à essayer de déterminer les besoins associés à chaque fonctionnalité.

[XavDmz]

Je pense qu'il ne faut pas que je me préoccupe de l'optimisation de ressources par réutilisation de paramètres et variables avant d'avoir implémenter le reste des fonctionnalités. en particulier les conversions.
Cela permet en effet :

• d'avoir des tests automatisés pertinents et simples sur les conversions, qui permettrons de s'assurer du fonctionnement de base de ces conversions, et donc de savoir si la tentative d'optimisation provoque ou pas des anomalies.
• de déterminer ce qui peut être réutilisé d'une exécution sur l'autre, dans le but d'optimiser la consommation de ressources d'une suite de conversions.

Il faudrait aussi définir précisément dans quel cas on veut conserver les éléments déjà lus ou calculés, et dans quel cas on veut les réinitialiser.

[XavDmz]

Edition du tableau des conversion : le format de sortie "SQL_FILE" est abandonné, car sans rapport avec rok4.

[XavDmz]

Ajout de fonctionnalités à implémenter :

• Fonctionnnalité de vérification de la nature mathématique d'un TMS (quad tree, etc)
• Fonctionnalité de création d'un TMS à partir d'un niveau de base
  1. L'utilisateur fournit une BBOX, une résolution, et une projection qui correspondront au niveau de base
  2. L'outil crée le niveau adapté, puis remonte en mode quad tree jusqu'au sommet de la pyramide.
  3. Une fois tous les niveaux créés, l'outil les nomme et écrit le fichier de TMS

=> il faudrait pour cela inclure les constructeurs et fonctions adaptées dans les classes TileMatrix et TileMatrixSet