From 9f27637ebef37d70dd2341cc54c496a387504e62 Mon Sep 17 00:00:00 2001 From: Étienne Loks Date: Mon, 23 Nov 2020 13:20:23 +0100 Subject: Docs: geo doc --- docs/fr/source/_static/geo-parents.png | Bin 0 -> 22252 bytes docs/fr/source/_static/geo-source-point.png | Bin 0 -> 49035 bytes docs/fr/source/_static/geo-source-polygon.png | Bin 0 -> 40508 bytes docs/fr/source/media-src/geo-parents.dia | Bin 0 -> 2227 bytes docs/fr/source/media-src/geo-source-point.dia | Bin 0 -> 3178 bytes docs/fr/source/media-src/geo-source-polygon.dia | Bin 0 -> 2800 bytes docs/fr/source/principes.rst | 43 ++++++++++++++++++++++++ 7 files changed, 43 insertions(+) create mode 100644 docs/fr/source/_static/geo-parents.png create mode 100644 docs/fr/source/_static/geo-source-point.png create mode 100644 docs/fr/source/_static/geo-source-polygon.png create mode 100644 docs/fr/source/media-src/geo-parents.dia create mode 100644 docs/fr/source/media-src/geo-source-point.dia create mode 100644 docs/fr/source/media-src/geo-source-polygon.dia (limited to 'docs') diff --git a/docs/fr/source/_static/geo-parents.png b/docs/fr/source/_static/geo-parents.png new file mode 100644 index 000000000..1574455aa Binary files /dev/null and b/docs/fr/source/_static/geo-parents.png differ diff --git a/docs/fr/source/_static/geo-source-point.png b/docs/fr/source/_static/geo-source-point.png new file mode 100644 index 000000000..bf13b727f Binary files /dev/null and b/docs/fr/source/_static/geo-source-point.png differ diff --git a/docs/fr/source/_static/geo-source-polygon.png b/docs/fr/source/_static/geo-source-polygon.png new file mode 100644 index 000000000..da8762bda Binary files /dev/null and b/docs/fr/source/_static/geo-source-polygon.png differ diff --git a/docs/fr/source/media-src/geo-parents.dia b/docs/fr/source/media-src/geo-parents.dia new file mode 100644 index 000000000..c5396afe3 Binary files /dev/null and b/docs/fr/source/media-src/geo-parents.dia differ diff --git a/docs/fr/source/media-src/geo-source-point.dia b/docs/fr/source/media-src/geo-source-point.dia new file mode 100644 index 000000000..858bddf57 Binary files /dev/null and b/docs/fr/source/media-src/geo-source-point.dia differ diff --git a/docs/fr/source/media-src/geo-source-polygon.dia b/docs/fr/source/media-src/geo-source-polygon.dia new file mode 100644 index 000000000..de6735aa3 Binary files /dev/null and b/docs/fr/source/media-src/geo-source-polygon.dia differ diff --git a/docs/fr/source/principes.rst b/docs/fr/source/principes.rst index 4b526f06e..1cae39c45 100644 --- a/docs/fr/source/principes.rst +++ b/docs/fr/source/principes.rst @@ -169,6 +169,49 @@ Document Les documents sont gérés de manière transversale et peuvent être librement associés à un ou plusieurs éléments (opération, site, UE, traitement, mobilier, etc.) de la base de données. Des méta-données peuvent être renseignées pour chacun de ces documents et une image, un fichier peuvent être le cas échéant adjoint. +Notions avancées +================ + +Données géographiques +--------------------- + +Les éléments principaux d'Ishtar (opérations, sites archéologiques, unités d'enregistrement, mobilier, dépôts et contenants) peuvent être localisés. Pour l'heure chaque élément localisé n'est pas associé à un (ou des) élément(s) « Localisation » (qui correspondrait par exemple à un relevé) mais chaque élément stocke directement des données géographiques. Cette évolution est envisagée pour les futures versions d'Ishtar. + +Un élément localisé dispose des champs suivants (entre parenthèse le nom du champ en base de données - à utiliser pour les configurations d'import) : + +- système de coordonnées géographiques utilisé (`spatial_reference_system`). Les systèmes de coordonnées standard sont présent par défaut dans Ishtar mais d'autres peuvent être ajoutés en administration. +- coordonnées en x, y et z (`x`, `y`, `z`). +- erreur estimée en x, y et z (`estimated_error_x`, `estimated_error_y`, `estimated_error_z`). +- un champ point 2D (`point_2d`) et point 3D (`point`). Ce champ est déduit automatiquement des coordonnées (non visible en interface de saisie). +- un champ polygone ou plus précisément un champ multi-polygone (`multi_polygon`) - par abus de langage polygone et repris dans la suite de la documentation. Pour l'instant ce champ n'est éditable qu'en import (mais visible sur les fiches) . +- l'origine des coordonnées (`point_source`) et l'origine du polygone (`multi_polygon_source`). Pour l'instant trois origines possibles : + + - « précis » (valeur **P** pour *precise*). Les coordonnées, le polygone on été relevés. + - le polygone (valeur **M** pour *multi-polygon*). Ne concerne que le point : reprend le centroïde du polygone. Géré automatiquement par Ishtar. **Géré automatiquement par Ishtar** quand le polygone a été défini précisément et qu'il n'y a pas de coordonnées précises associées. + - la commune (valeur **T** pour *town*). Le point a été déduit du centroïde de la commune, le polygone reprend celui de la commune. **Géré automatiquement par Ishtar** quand aucune autre source n'est disponible. + +- la source des coordonnées (`point_source_item`), du polygone (`multi_polygon_source_item`). Quand l'élément n'a pas de coordonnées/de polygone associé, on essaye d'associer un les coordonnées d'un élément parent, exemple : sans coordonnées précises, le mobilier a les coordonnées de l'Unité d'enregistrement qui elle même hérite des coordonnées de l'opération ou du site archéologique associé si elle n'a pas de coordonnées propres. Cette mécanique est **gérée automatiquement par Ishtar**. + +La gestion des données géographiques dans Ishtar est résumé par le graphe logique suivant pour les coordonnées : + +.. figure:: _static/geo-source-point.png + + Gestion des coordonnées + +Pour les polygones, la gestion est assez similaire aux coordonnées mais sans la déduction possible depuis le polygone : + +.. figure:: _static/geo-source-polygon.png + + Gestion des polygones + +L'arbre de prise en compte des éléments parents pour les données géographique est le suivant : + +.. figure:: _static/geo-parents.png + + +.. note:: Dans le profil d'instance, il est possible d'activer un degré d'imprécision. Cela permet de mettre un positionnement approximatif des éléments sur la fiche au cas où ces fiches seraient consultables par des tiers non dignes de confiance. Pour se faire, les coordonnées sont tronquées (X nombres après la virgule) pour l'affichage (les données en base de données restent inchangées). Le troncature est opérée sur les coordonnées en WGS 84 (latitude/longitude). + + .. TODO: Parler d'historisation -- cgit v1.2.3