Docs: geo doc

7 files changed, 43 insertions, 0 deletions

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
--- /dev/null
+++ b/docs/fr/source/_static/geo-parents.png
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
--- /dev/null
+++ b/docs/fr/source/_static/geo-source-point.png
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
--- /dev/null
+++ b/docs/fr/source/_static/geo-source-polygon.png
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
--- /dev/null
+++ b/docs/fr/source/media-src/geo-parents.dia
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
--- /dev/null
+++ b/docs/fr/source/media-src/geo-source-point.dia
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
--- /dev/null
+++ b/docs/fr/source/media-src/geo-source-polygon.dia
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