Welcome to TerraVisu’s documentation!

Plateforme TerraVisu

TerraVisu

L’application cartographique TerraVisu permet de manipuler un ensemble de données relatives aux différents champs de l’action publique : démographie, habitat, patrimoine, mobilité, environnement.

TerraVisu propose des outils d’observation et d’analyse pour comprendre l’évolution de vos territoires.

Vous voulez tester par vous-même? Une instance de démonstration est accessible ici !

Résumé des fonctionnalités :

Naviguer dans l’interface cartographique
Intéragir avec les couches (filtres, table attributaire, transparence, zoom sur l’emprise, synthèse statistique)
Interroger les objets géographiques (infobulle au survol, fiche descriptive)
Afficher des fonds de cartes
Utiliser les outils de navigation (recherche dans les données/lieux, gestion du zoom, orientation de la carte..)
Exporter et partager les cartes (impression PDF, partage de la carte sur les réseaux sociaux)

Les principales fonctionnalités

L’interface cartographique

L’interface cartographique est décomposée en deux parties :

Les données : à gauche, l’arbre des couches permet d’afficher, de filtrer les données à voir sur la carte
La carte : au centre, un fond de plan cartographique sur lequel se superposent des données

Exemple du TerraVisu déployé pour la Région Sud

Plusieurs fonds de cartes sont disponibles par défaut et vos propres fonds de carte peuvent être ajoutés.

Les données sont agencées de manière personnalisée. Vous pouvez créer autant de grandes catégories et de sous-catégories de groupes de données que vous le souhaitez.

Les données géographiques

Les données géographiques sont organisées dans des couches qui rassemblent des entités de même nature. Chaque couche de carte permet d’afficher et d’utiliser un jeu de données SIG spécifique

TerraVisu dispose d’un arbre des couches sur lequel une série d’outils permet d’agir sur les différentes couches de données visibles.

Au niveau de la couche de données, vous pouvez ainsi activez les fonctionnalités suivantes :

Afficher/masquer des données
Afficher/masquer la table attributaire des données de la couche
Afficher/masquer le panneau de filtre de la couche de données
Afficher/modifier la liste des filtres appliqués à la couche de données
Afficher le widget de synthèse
Zoomer sur l’étendue spatiale de la couche de données
Changer l’opacité de la couche

L’interface géographique se met automatiquement à jour selon les fonctionnalités activées.

Le filtrage des données

Un jeu de données peut être filtré par ses données attributaires, c’est à dire des informations textuelles qui décrivent les caractéristiques diverses (géographiques, alphanumériques, etc.).

Les éléments qui ne correspondent pas au filtre sont cachés et la carte est alors mise à jour.

Exemple de filtres disponibles

Les filtres peuvent prendre plusieurs formes (case à cocher, intervalle de valeurs, curseur, recherche, etc.) et sont paramétrables dans l’outil d’administration.

La fiche descriptive

Les informations relatives aux données sont présentées dans une fiche à gauche de l’écran. Cette fiche apparaît au clic de l’objet cartographie (i.e. le point sur la carte).

Exemple de fiche descriptive pour une station du métro toulousain

Depuis l’outil d’administration, vous pouvez personnaliser la fiche de manière avancée, en y intégrant du texte, des images ou des graphiques pour améliorer le rendu visuel.

Il n’y a pas de limite au contenu de la fiche tant que l’information est disponible. La fiche peut contenir des liens vers des sites web et des mails.

Les fiches sont exportables et peuvent donc être imprimées en format texte ou PDF.

L’infobulle au survol

Une information résumée de la donnée, sous la forme d’une infobulle, est disponible au survol des des objets cartographiques. Si la couche a été configurée dans ce sens dans l’outil d’administration, des infobulles peuvent apparaître au survol des objets cartographiques.

Exemple d’infobulle au clic sur une station de métro toulousain

Le contenu de l’infobulle est entièrement personnalisable dans l’outil d’administration et peut comprendre toutes les information que vous souhaitez.

La légende

Quand les couches affichées ont des légendes, celles-ci s’affichent sur la partie droite de l’écran. C’est vous qui décidez si vous souhaitez affichez la légende et quel type de légende.

Exemple de type légende disponible

La configuration de la légende s’effectue depuis l’outil administration.

La table attributaire

TerraVisu propose l’affichage de la table des données contenues dans la couche. La table attributaire contient les caractéristiques non spatiales des données.

La table attributaire de TerraVisu comprend de nombreuses fonctionnalités telles que :

Afficher le nombre de lignes du tableau
Trier les données selon une colonne
Filtrer les données par l’emprise de la carte
Comparer jusqu’à trois lignes
Exporter les données au format CSV et Excel
Afficher/masquer des colonnes
Agrandir la table

Exemple d’une table attributaire du TerraVisu Sud Éco Foncier

Une fois la table exportée, vous pouvez travailler vos données avec votre tableur habituel et créer des graphiques, des tableaux dynamiques croisés, etc., depuis votre ordinateur.

Le zoom sur les éléments d’une couche

Cet outil permet de zoomer sur l’étendue spatiale d’une couche activée. Le zoom est particulièrement utile lorsque l’on souhaite voir l’emprise géographique des éléments filtrés d’une couche.

Exemple d’un zoom pour le TerraVisu de SeineYonne

La table attributaire et le widget sont automatiquement mis à jour en fonction du zoom.

La recherche sur la carte

La recherche sur la carte (via l’outil loupe) permet d’effectuer à la fois :

une recherche de lieu ou d’adresse par à un appel à la base d’adresses Nominatim implémenté,
une recherche dans les champs textuels d’une ou plusieurs couches activées (exemple : une parcelle par le nom du proprétaire).

Le fait de sélectionner un résultat dans les attributs de la ou les couches activées permet de zoomer sur ce résultat, de sélectionner l’objet en surbrillance et d’ouvrir la mini-fiche (si elle existe).

Le comportement est différent si on sélectionne un résultat pour la recherche de lieu puisqu’il permet uniquement de zoomer sur l’emprise géographique correspondante sans réaliser d’intéraction avec la ou les couches activées.

Exemple de recherche pour le TerraVisu de SeineYonne

L’impression de la carte au format PDF

La carte affichée à l’écran peut être imprimée en format PDF selon les deux dispositions (portait ou paysage).

Exemple de la procédure d’impression .. image :: ../_static/images/visu/visu_impression.png

La visualisation en Storytelling

TerraVisu dispose d’une fonction de Storytelling. C’est une autre forme de visualisation qui est accessible depuis une vue dédiée. Le storytelling comprend du texte et des images qui sont parcourues comme un « slideshow » (diaporama).

Cette fonctionnalité peut servir à la communication ou de manuel d’utilisation.

Exemple du storytelling de Carto Collectivités

Outil d’administration

L’outil d’administration

Cette documentation décrit les procédures pour l’activation et la gestion des différentes fonctionnalités de la plateforme TerraVisu.

L’outil d’administration de TerraVisu permet en quelques clics de gérer des utilisateurs, d’importer différentes sources de données géographiques, de créer et personnaliser ses cartes.

Résumé des fonctionnalités :

Gérer les sources de données géographiques
Configurer des fonds de cartes
Créer des visualisation privées
Créer des visualisation publiques
Créer des analyses privées
Créer des analyses publiques
Créer des scénarios interactifs
Organiser les visualisations et analyses présentes dans l’application

Authentification

Procédure d’authentification

Le chemin d’accès à l’outil d’administration d’une application TerraVisu est toujours constitué de l’URL du visualiseur suivis de /admin.

Une fois en possession des identifiants, vous pouvez les renseigner dans la page d’authentification.

Page d’accès

Une fois connecté, vous arrivez sur l’écran d’accueil de l’outil d’administration. L’outil est composé de trois modules :

Utilisateurs, permet de gérer les utilisateurs de l’application
Visualiseur, permet de créer les cartes
Fonds de carte, permet de configurer les fonds de carte

Module de gestion des utilisateurs

Liste des utilisateurs

Pour afficher l’ensemble des utilisateurs cliquez sur Liste des utilisateurs. Vous arrivez sur une page présentant la liste de tous les utilisateurs existants.

Le module Utilisateurs de TerraVisu permet de gérer les permissions d’accès des utilisateurs et des groupes d’utilisateurs aux différents éléments du visualiseur cartographique.

Vous avez la possibilité d’exporter la liste des utilisateurs au format CSV en cliquant sur le bouton EXPORTER.

Créer un nouvel utilisateur

Seuls les super-utilisateurs sont autorisés à créer de nouveaux utilisateurs.

Pour ajouter un nouvel utilisateur cliquez sur le bouton CRÉER. Les informations à renseigner sont à minima le nom, le prénom, l’adresse mail, le mot de passe.

Si vous activez l’option Super-utilisateur l’utilisateur pourra à son tour créer de nouveaux utilisateurs.

Si vous activez l’option Actif l’utilisateur pourra se connecter dès que son compte sera créé, sinon, il devra attendre que celui ci devienne actif.

Vous pouvez intégrer l’utilisateur à un ou plusieurs groupes.

Il est possible de rajouter des informations supplémentaires comme la fonction, l’organisme de rattachement ou encore l’adresse.

Si l’utilisateur perd son mot de passe, il faut supprimer son compte et lui en créer un nouveau.

Liste des groupes d’utilisateurs

Les groupes d’utilisateurs permettent de gérer des permissions à différents niveaux de l’application.

Les permissions sont les suivantes :

L’administration de fonds de carte
La gestion des sources de données
La gestion des couches cartographiques
La gestion des groupes d’utilisateurs
La gestion des utilisateurs

Pour afficher l’ensemble des groupes cliquez sur Liste des groupes d’utilisateurs. Vous arrivez sur une page présentant la liste de tous les groupes existants.

Créer un nouveau groupe d’utilisateurs

Pour ajouter un nouveau groupe cliquez sur le bouton CRÉER.

Les informations à renseigner lors de la création d’un nouveau groupe sont à minima le nom, les utilisateurs affectés, les permissions.

Module Visualiseur

Le module Visualiseur de TerraVisu permet de gérer les données de l’application et le paramétrage de leur(s) représentation(s).

Il comporte trois entrées :

Les sources de données
Les couches
Les vues

Liste des sources de données

Afin de configurer une visualisation, l’utilisateur doit créer les différentes sources de données en adéquation avec le projet si elles n’existent pas déjà.

Pour afficher l’ensemble des sources de données cliquez sur Liste des sources de données.

Vous arrivez sur une page présentant la liste de toutes les sources de données déclarées.

Pour retrouver plus facilement une source de données dans la liste, vous avez la possibilité d’utiliser la barre de recherche ou d’ajouter un filtre pour filtrer par type de données ou par type de géométrie.

Créer une source de données

Pour ajouter une nouvelle source, cliquez sur le bouton CRÉER.

Les types de sources de données supportés actuellement par l’application sont :

les fichiers GeoJSON ;
les fichiers Shapefile ;
les requêtes PostGIS ;
les fichiers CSV contenant des coordonnées géographiques ;
les flux WMS/WMTS.

Note

Une fois la source de données enregistrée, il n’est pas possible de modifier son type.

Les types de géométries supportés par l’application sont les suivants :

Point
Linestring
Polygon
MultiPoint
MultiLinestring
MultiPolygon
GeometryCollection

Lors de la déclaration de la source, il est possible d’ajouter un ou plusieurs groupes d’utilisateurs, De cette façon, seuls les utilisateurs faisant partie des groupes affectés à la source seront en mesure de visualiser les données.

Note

Le nom d’une source de données doit être unique, si ce n’est pas le cas l’enregistrement échouera.
Toutes les données intégrées à l’application doivent a minima posséder un champ d’identifiant unique et une géométrie.

Import de fichiers

Une source de données peut être créée par l’import d’un fichier GeoJSON, Shapefile ou CSV en déposant le fichier dans l’interface.

GeoJSON ou Shapefile

Les informations à renseigner à minima, lors de la création d’une nouvelle source GeoJSON ou Shapefile sont le nom, le type de données, le type de la géométrie et l’identifiant unique.

_images/admin_source_creation_geojson.png

Note

Les fichiers Shapefile doivent être fournis sous la forme d’une archive zippée contenant l’ensemble des fichiers (.shp, .prj, .shx, .dbf, etc).

CSV

Pour intégrer un fichier CSV, il faut que celui-ci comporte des coordonnées géographiques, dans une ou deux colonnes.

Les informations à renseigner à minima lors de la création d’une nouvelle source CSV sont le nom, le ou les champs de coordonnées, le système de coordonnées, le champ de l’identifiant unique, le séparateur de champ, le séparateur de texte, le séparateur décimal pour les coordonnées et le nombre de lignes à ignorer.

L’ option Entête à la première ligne activée permet de conserver les entêtes de colonnes qui se trouvent à la première ligne du fichier CSV.

Si l’option Ignorer les colonnes à null est activée, toutes les colonnes vides ne seront pas conservées.

Import via une requête PostGIS

Les informations à renseigner à minima lors de la création d’une nouvelle source PostGIS sont le nom, le type de géométrie, les paramètres de connexion à la base de données (hôte, port, nom bdd, nom utilisateur, mot de passe utilisateur), requête SQL, champ de géométrie, champ de l’identifiant unique.

Note

Attention à ne pas terminer la requête par un point virgule.

Tip

Il est possible de définir la fréquence de mise à jour automatique de la source (toutes les heures, quotidiennement…). La requête peut ainsi être exécutée régulièrement afin de mettre à jour les données avec le contenu de la base.

_images/admin_source_creation_postgis.png

Note

Si une source de données dont la fréquence de mise à jour a été paramétrée sur Quotidienne, le déclenchement de la synchronisation ne se fera pas exactement 24h après. L’heure d’exécution se fera 24h+25mn (redémarrage de l’outil qui regarde toutes les 25 mn s’il y a des changements) + date de fin de la dernière mise à jour. Il peut donc y avoir un delta de 24h et 25mn au minimum entre chaque mise à jour de source de données. Ce delta peut se rajouter d’autant plus s’il y a des mise à jour manuelles.

Géométries invalides
Géométries invalides
Seules des géométries valides peuvent être importées dans l’application TerraVisu. Avec PostGis, il est possible de corriger des géométries invalides avec les fonctions suivantes : ST_MakeValid(geom) ST_Buffer(geom, 0) ST_SimplifyPreserveTopology(geom, tolerance)

Import via un flux WMS/WMTS

Les flux WMS/WMTS sont des protocoles de communication qui permettent d’obtenir des cartes de données géoréférencées à partir de différents serveurs de données (IGN, BRGM, etc.).

Les informations à renseigner à minima lors de la création d’une nouvelle source WMS/WMTS sont le nom et l’adresse.

Il est possible de renseigner les niveaux de zoom min et max auxquels les images du flux seront affichées dans le visualiseur cartographique.

Enregistrer une source de données

Au moment de l’enregistrement de la source, les champs attributaires sont automatiquement déterminés et renseignés et trois onglets sont créés :

DÉFINITION contient les informations principales de la source
DONNÉES contient la liste de tous les champs attributaires
RAPPORT D’IMPORTATION permet de remonter les éventuelles erreurs rencontrées lors de l’enregistrement

Une fois la source enregistrée, revenez à la liste. La colonne Statut indique l’état actuel de la source de données.

NEED SYNC : le statut de la source nouvellement créé , cela signifie que la source a besoin d’être synchronisée pour être utilisée. Cliquez d’abord sur la source pour éditer son statut, puis sur Actualiser les données. Une fois revenu à la liste des source, vous pourrez constater que le statut est devenu SUCCESS.
DON'T NEED : ce statut ne concerne que les sources WMS/WMTS car celles ci n’ont pas besoin d’être raffraichies.
SUCCESS : la source de données a bien été créé et vient d’être synchronisée avec succès.
PENDING : la source de données a bien été créé et son état de synchronisation est stable.
FAILURE : la source de données n’a pas été correctement créé ou mise à jour. Il y a un problème dans les paramètres renseignés. Voir le détail dans l’onglet RAPPORT D’IMPORTATION.

Modifier une source de données

L’onglet DONNÉES contient l’ensemble des champs attributaires de la source.

L’outil détecte automatiquement les types de chaque champ mais il peut arriver qu’il soit mal reconnu. Dans ce cas là, il est possible de le modifier dans la liste du type de chaque champ.

Les types gérés par l’application sont les suivants :

String
Integer
Float
Boolean
Undefined
Date

Note

Lorsqu’un champ est de type Undefined, cela signifie que l’outil n’a pas réussit à l’identifier. A ce moment là il faut lui assigner le bon type dans la liste déroulante.

Un extrait des valeurs pour chaque champ est fournit afin d’avoir un aperçu des données.

Le libellé de chaque champ est modifiable de façon à le rendre plus lisible qu’une variable brut. Celui-ci sera utilisé lors de la configuration des couches.

Dupliquer une source de données

Cela peut être particulièrement intéressant pour les sources PostGIS qui possèdent les mêmes paramètres de connexion à la base de données.

Si la duplication est réalisée sur une source Shapefile/GeoJSON/CSV, il est nécessaire de réimporter le fichier de données.

Pour dupliquer une source de données cliquez sur le bouton DUPLIQUER depuis la liste des sources.

Note

Assurez vous de renommer la source car le nom d’une source de données doit être unique.

Supprimer une source de données

Pouvoir supprimer une source de données nécessite de s’assurer qu’elle n’est pas utilisée par aucune couche. Si ce n’est pas le cas, la suppression ne pourra pas être effectuée.

Pour supprimer une source, vous avez deux façons de procéder :

dans la liste, cliquez sur la vue et en bas de la page cliquez sur le bouton SUPPRIMER.
dans la liste, cochez la source et cliquez sur le bouton SUPPRIMER.

Note

Toute suppression est définitive.

Liste des couches

Une fois les sources de données déclarées, l’utilisateur peut créer les couches qui en découlent.

Pour afficher l’ensemble des couches cliquez sur Liste des couches.

Tip

Pour retrouver plus facilement une couche dans la liste, vous avez la possibilité d’utiliser la barre de recherche ou d’ajouter un filtre pour filtrer par source de données, vue, affichée par défaut(oui/non), table attributaire affichée(oui/non), fenêtre au survol(oui/non), mini-fiche (oui/non).

Créer une couche

La configuration des couches permet de personnaliser de manière très approfondie les possibilités d’interaction au sein d’une couche :

La fonction de recherche
La représentation cartographique
La légende associée aux styles cartographiques affichés
L’affichage de popups associés aux données
L’affichage de fiches informatives associés aux données
La gestion d’outils de filtrage des données
La gestion de la table attributaire
La gestion d’un outil de synthèse

Pour créer une nouvelle couche, cliquez sur le bouton CRÉER.

Une page s’ouvre avec différents onglets à renseigner.

Onglet DÉFINITION

Les informations à renseigner à minima lors de la définition de la couche sont le nom et la source de données.

A la différence des sources qui doivent avoir des noms uniques, il est possible d’avoir plusieurs couches avec le même nom.

Il faut ensuite sélectionner une source de données dans la liste. Chaque couche est associée à une source de données. Il est possible d’en filtrer le contenu en ajoutant une condition de sélection des données à partir de la liste des champs disponibles fournie (voir ci-dessous).

Le Champ principal permet d’activer la fonction de recherche dans le visualiseur qui retournera les résultats en fonction de ce champ.

Si l’option Affichée par défaut est activée, la couche sera activée dès l’ouverture de la vue à laquelle elle est associée dans le visualiseur cartographique.

Enfin, la partie Description permet d’ajouter un texte informatif en langage HTML sur cette couche. Ce texte peut être mis à disposition de l’utilisateur dans les vues classiques et de storytelling.

A ce stade, il est possible d’enregistrer la couche telle quelle et de l’afficher dans le visualiseur cartographique. Une représentation par défaut est appliquée à la couche, ce qui permet de la visualiser.

Filtrage de source

L’intérêt principal du filtrage de source est qu’il permet de créer de multiple couches à partir de la même source de données.

Le langage de filtrage, Pivot QL, est très proche du SQL et une aide 🛈 permet d’obtenir des exemples avec des cas de figures parlants.

Pour aider à l’écriture de la requête de filtrage, il peut être intéressant de consulter la liste des champs disponibles afin de ne pas faire d’erreur de nommage.

_images/admin_couche_definition_filtrage1.png

Pour finir, si la requête est syntaxiquement incorrecte ou qu’un nom de champ est mal orthographié alors un message d’erreur vient avertir l’utilisateur.

Le nombre d’éléments retournés par le filtre est une aide précieuse pour savoir si la requête est bonne.

_images/admin_couche_definition_filtrage2.png

Le filtre appliqué à la source de données dans la couche est immédiatement répercuté dans la fenêtre de filtre côté interface du visualiseur cartographique.

Onglet ICÔNES

Il est possible d’afficher ses propres pictogrammes sur une couche. Ils pourront servir d’icônes ou de motifs sur la carte créée.

Pour cela il suffit de cliquer sur le bouton AJOUTER, d’importer son image (png/jpeg) et de la nommer dans le champ Nom.

Il est possible de modifier la couleur de fond de l’image en utilisant l’outil COMPOSER. Pour cela il est nécessaire que l’image ait été enregistrée au préalable afin qu’elle soit disponible dans la liste.

Pour enregistrer l’image, enregistrez la couche.

Onglet STYLE

La conception du style permet de donner du sens à une carte en transmettant une information qui doit être la plus efficace et compréhensible possible.

Parmi les nombreux styles que l’on peut réaliser, voici les plus courants :

Des styles simples sans analyse : polygones, lignes, points.
Des analyses paramétrées permettant de représenter une variable en particulier :
- Cartes choroplèthes (analyse discrète)
- Carte thématiques (catégorisation)
- Points avec cercles proportionnels (analyse continue)
- Point avec iconographie (catégorisation)
- Affichage de texte
Des analyses bivariées permettant de représenter deux variables en même temps en faisant varier deux caractéristiques du style de la même représentation géographique.
Des représentations mettant en jeux plusieurs couches (polygone + centroide par exemple) du type couche principale + couche de décoration.
Des représentations différentes en fonction du niveau de zoom.

Il existe deux modes possibles pour la conception du style : le mode avec assistant de style et le mode sans. Par défaut, le mode avec assistant est activé.

Dans ce manuel d’utilisation, nous nous concentrons principalement sur le mode avec assistant car celui ci s’adresse à un profil d’utilisateur non développeur.

Style simple

L’application identifie automatiquement le type de représentation possible en fonction de la géométrie de la source de données utilisée. Ainsi, au moment de la conception, un style simple par défaut est proposé à l’utilisateur. Il est possible de modifier les couleurs par défaut en cliquant sur le carré coloré. Un sélecteur de couleur apparaît et vous permet d’en choisir une dans la palette chromatique ou de renseigner le code couleur en HTML ou RGBA.

Pour renseigner une valeur numérique (exemple le Diamètre pour une représentation Cercle), il suffit de cliquer sur la zone concernée et d’inscrire une valeur.

Les curseur de la plage de visibilité permettent de définir des niveaux de zoom d’apparition/disparition d’un style sur la carte (exemple : on affiche des zones du zoom 0 jusqu’au zoom 13 et à partir du zoom 13 on affiche des icônes).

Pour utiliser une icône existante dans un style simple, sélectionnez la représentation Icône et choisissez l’image que vous avez enregistré dans l’onglet ICÔNES.

Style avec motif

Il est possible d’utiliser des motifs au lieu des couleurs pour remplir un polygone.

Création d’un motif La première étape est de créer le motif, dans l’onglet ICÔNES. Pour cela, il est nécessaire d’importer une image servant de base au motif (le motif est idéalement blanc et de taille 28 x 28 pixels). L’import d’image se fait via le bouton UPLOAD. Il est ensuite possible de colorer l’image précédemment importée dans l’application. Le bouton COMPOSE permet ce choix de couleur à appliquer sur le motif.

Utilisation d’un motif Actuellement les motifs ne sont pas gérés par l’assistant de style. Il est nécessaire de désactiver l’assistant pour utiliser les motifs via du code Mapbox.

Exemple :

{
  "type": "fill",
  "paint": {
    "fill-pattern": "hachures-bleu"
  },
  "maxzoom": 24,
  "minzoom": 0
}

Style avec une analyse

Choix du type de représentation
- Polygone
- Ligne
- Extrusion (3D)
- Cercle
- Icône
- Texte
- Diagrammes circulaires
Choix du de la caractéristique à faire varier
- Couleur fond
- Couleur contour
- Diamètre
- Épaisseur
- Couleur texte
- Taille texte
- etc.
Choix de la variable à représenter
Choix du type d’analyse
- Si la variable est un nombre (type Float/Integer)
  - Discrétisation (méthodes Jenks, Quantiles, Intervalles égaux)
  - Interpolation
  - Catégorisation
  - Diagrammes circulaires
- Si la variable est un texte (type String)
  - Catégorisation

Afin de ne pas égarer l’utilisateur dans les nombreux choix du type de représentation, ce dernier sera restreint en fonction du type géométrique de la source de données utilisée par la couche. Par exemple, à une source de type Polygon sera proposé uniquement les types de représentation Polygone, Ligne, Extrusion.

Le choix de la caractéristique à faire varier découlera automatiquement du type de représentation choisi précédemment. Par exemple, pour une représentation Polygone, les caractéristiques à faire varier seront Couleur du polygone et Couleur du contour.

Il est à noter que toutes les caractéristiques ne sont pas variables car n’apportant pas d’intérêt : par exemple l’épaisseur du contour de la représentation Cercle n’est pas variable, uniquement fixe.

Le choix de la variable à représenter se fait à l’aide d’une liste déroulante. La variable se présente ainsi : le label (éditable), le nom de la variable, le type. Le type de la variable choisie (String, Integer, Float..) conditionne les possibilités du type d’analyse.

Le choix du type d’analyse constitue la dernière étape. Le type d’analyse Interpolation n’est disponible que pour faire varier les caractéristiques Diamètre ou``Épaisseur``, c’est à dire une taille.

Lors de la conception d’un style avec une analyse, il est possible d’activer l’option Générer la légende associée pour que la légende soit exactement conforme au style représenté.

_images/admin_couche_style_assistant.png

Exemples de styles Mapbox avancés

Catégorisation

Fallback value (valeur par défaut)

{
 "type": "fill",
 "paint": {
  "fill-color": [
    "case",
    [
      "has",
      "nb_log_ind_pour_mille"
    ],
    [
      "step",
      [
        "get",
        "nb_log_ind_pour_mille"
      ],
      "#fde725",
      0.1,
      "#5dc963",
      1.1,
      "#21908d",
      3.1,
      "#3b528b",
      7.1,
      "#440154",
      15.1,
      "#CCC"
    ],
    "#CCC"
  ],
  "fill-outline-color": "#a7c2e8"
},
"maxzoom": 24,
"minzoom": 0
}

Variation simple (icones en fonction d’un champ) + étiquettes en fonction d’un champ

{
  "type": "symbol",
  "paint": {
    "text-color": "hsl(352, 100%, 15%)"
  },
  "layout": {
    "icon-size": 1,
    "text-font": [
      "Arial Unicode MS Bold"
    ],
    "text-size": 8,
    "icon-image": [
      "match",
      [
        "get",
        "cep_nature"
      ],
      "ESU",
      "point-vert",
      "ESO",
      "point-noir",
      "EMI",
      "point-marron",
      ""
    ],
    "text-field": "{cep_nom}",
    "text-radial-offset": 2,
    "text-variable-anchor": [
      "top",
      "bottom",
      "left",
      "right"
    ]
  },
  "maxzoom": 24,
  "minzoom": 0
}

Variation simple (couleur des points en fonction d’un champ) + clusters colorés en fonction du nombre de points

{
  "type": "circle",
  "paint": {
    "circle-color": [
      "case",
      [
        "has",
        "secteuractivite"
      ],
      [
        "match",
        [
          "get",
          "secteuractivite"
        ],
        "Alimentaire",
        "hsla(210, 50%, 40%, 0.8)",
        "Automobiles, motos",
        "hsla(0, 0%, 80%, 0.8)",
        "Hôtels, cafés, restaurants",
        "hsla(180, 50%, 60%, 0.8)",
        "Culture, loisirs",
        "hsla(180, 50%, 40%, 0.8)",
        "Divers",
        "hsla(0, 20%, 50%, 0.8)",
        "Équipement de la maison",
        "hsla(60, 50%, 60%, 0.8)",
        "Équipement de la personne",
        "hsla(300, 33%, 30%, 0.8)",
        "Grand magasin",
        "#c7843d",
        "Hygiène, santé, beauté",
        "hsla(300, 33%, 70%, 0.8)",
        "Services à la personne",
        "hsla(0, 100%, 90%, 0.8)",
        "Services à vitrine",
        "hsla(30, 100%, 60%, 0.8)",
        "#CCC"
      ],
      "#CCC"
    ],
    "circle-radius": 7,
    "circle-stroke-color": "hsl(0, 0%, 95%)",
    "circle-stroke-width": 1
  },
  "cluster": {
    "font": {
      "color": "#ffffff"
    },
    "sizes": [
      5,
      10,
      15,
      20,
      22,
      25
    ],
    "steps": [
      2,
      5,
      10,
      50,
      80
    ],
    "border": 4,
    "colors": [
      "#b8e295",
      "#8dcf82",
      "#64bc6e",
      "#3ba859",
      "#1c8a47",
      "#006837"
    ],
    "radius": 50
  },
  "maxzoom": 24,
  "minzoom": 0
}

Variation double : couleur des lignes en fonction d’un champ + taille des lignes en fonction en fonction d’un champ

{
  "type": "line",
  "paint": {
    "line-color": [
      "match",
      [
        "get",
        "class_adm"
      ],
      "Autoroute",
      "#bb1e2a",
      "Départementale",
      "#487b00",
      "Nationale",
      "#487bb6",
      "#000000"
    ],
    "line-width": [
      "match",
      [
        "get",
        "class_adm"
      ],
      "Autoroute",
      3,
      "Départementale",
      2,
      "Nationale",
      1,
      0
    ]
  },
  "maxzoom": 24,
  "minzoom": 9
}

Variation simple (couleur du polygone en fonction d’un champ) + ordre d’affichage des géométries en fonction d’un champ

{
  "type": "fill",
  "paint": {
    "fill-color": [
      "match",
      [
        "get",
        "buffer"
      ],
      "1000",
      "#e47e1c",
      "250",
      "#e41a1c",
      "#000000"
    ],
    "fill-outline-color": "transparent"
  },
  "layout": {
    "fill-sort-key": [
      "case",
      [
        "==",
        [
          "get",
          "buffer"
        ],
        "1000"
      ],
      0,
      [
        "==",
        [
          "get",
          "buffer"
        ],
        "250"
      ],
      1,
      0
    ]
  },
  "maxzoom": 24,
  "minzoom": 0
}

Filtres

Filtre simple (une condition)

{
  "type": "fill",
  "paint": {
    "fill-color": "hsl(140, 92%, 24%)",
    "fill-outline-color": "hsl(0, 0%, 100%)"
  },
  "filter": [
    "==",
    "nouvelle_culture",
    "Oui"
  ],
  "maxzoom": 24,
  "minzoom": 0
}

Filtre “et” (les conditions se cumulent)

{
  "type": "fill",
  "paint": {
    "fill-color": "hsl(140, 92%, 24%)",
    "fill-outline-color": "hsl(0, 0%, 100%)"
  },
  "filter": [
    "all",
    [
      "==",
      "nouvelle_culture",
      "Oui"
    ],
    [
      ">=",
      "evol_2021_surf",
      "0"
    ]
  ],
  "maxzoom": 24,
  "minzoom": 0
}

Ajouter un style secondaire

Une couche peut utiliser plusieurs styles. Le style principal utilise les données de la source utilisée par la couche, en revanche, le style secondaire peut faire appel à une source de données différente.

Le style secondaire doit être vu comme un élément de décoration sur la carte. De cette manière, aucune interaction ne sera possible avec les données du style secondaire (info-bulle, mini-fiche, filtre, etc.)

Exemple concret : Dans le cas d’une carte des communes, il pourra être intéressant de rajouter les étiquettes des noms au centre des communes. Pour se faire, on aura besoin de créer un style secondaire faisant appel à la source de données des centroides des communes pour pouvoir ajouter les étiquettes.

_images/admin_couche_style_secondaire.png

Style sans assistant

Il est possible d’aller plus loin dans la conception d’un style en désactivant le mode assistant. Ce mode s’adresse à des utilisateurs développeurs car il faut rédiger le code en JSON, en suivant la spécification Mapbox.

Onglet LÉGENDES

La légende est un des éléments essentiels de la carte. Elle doit être claire, facilement compréhensible et doit s’adapter aux éléments affichés sur la carte.

Voici les typologies de légende :

Légende avec carrés pour représenter des polygones
Légende avec cercles pour représenter des points
Légende avec lignes pour représenter les lignes
Légende avec icônes pour représenter les pictogrammes ou motifs

On peut faire varier :

La couleur de fond pour les carrés et le cercles
La couleur de la ligne pour les carrés, les cercles et les lignes
La taille pour les carrés et les cercles
L’épaisseur de ligne pour les carrés, les cercles et les lignes

Si elle est générée depuis l’onglet STYLE, alors elle se met en lien automatiquement avec le style de la couche et prend en compte la typologie de géométrie affichée.

Il n’est pas possible de modifier une légende qui a été générée. Seuls le titre et le pied de légende sont éditables.

Si la légende générée ne vous convient pas, il faut désactiver l’option Générer la légende associée dans l’onglet STYLE pour la caractéristique concernée (exemple Couleur du polygone). De cette façon, vous pourrez créer manuellement la légende souhaitée.

Onglet FENÊTRE AU SURVOL

La fenêtre au survol ou info-bulle est un message contextuel apparaissant en surimpression au survol de la souris sur les éléments de la couche. Le contenu du message s’adapte dynamiquement en fonction de l’objet survolé. Celle-ci n’est pas active par défaut.

Une fois activée, la configuration de la fenêtre est facilitée grâce à un assistant qui permet d’ajouter les éléments de contenus et de définir une plage de zoom.

Si le champ principal a été définit dans l’onglet DÉFINITION, alors ce dernier sera aussi utilisé comme titre de l’info-bulle.

En cas de valeur nulle sur un champ, il est possible de définir une valeur par défaut. De même, l’outil permet de rajouter du texte en préfixe et suffixe de la valeur du champ choisi.

_images/admin_couche_pophover_nonexpert.png

Lorsque le label d’un champ est renommé à un endroit de l’application, il est renommé partout ailleurs.

Le Mode expert permet d’aller plus loin dans le paramétrage de l’info-bulle en codant le contenu en Nunjucks.

Le code est généré à partir de ce qui existe dans le mode avec assistant, en revanche l’inverse n’est pas vrai. C’est à dire que le mode avec assistant n’est pas synchronisé avec le Mode expert.

Ce mode avancé s’adresse à des utilisateurs développeurs. Il peut être intéressant de l’utiliser pour définir des conditions if ou elseif.

_images/admin_couche_pophover_expert.png

Onglet MINI-FICHE

La mini-fiche est une fiche structurée présentant des informations associées à un objet de la couche. Celle-ci s’ouvre au clic sur l’objet en question.

La mini-fiche n’est pas active par défaut.

La mini-fiche fonctionne sur le même principe que celui de la fenêtre au survol. Si le champ principal a été définit dans l’onglet DÉFINITION, alors ce dernier sera aussi utilisé comme titre de la mini-fiche.

Il est possible de sélectionner une couleur de surbrillance pour les objets cliqués sur la carte au moment de l’affichage de la mini-fiche.

En cas de valeur nulle sur un champ, il est possible de définir une valeur par défaut.

De même, l’outil permet de rajouter du texte en préfixe et suffixe de la valeur du champ choisi.

A la différence de l’info-bulle, l’utilisateur peut ajouter des titres de section pour structurer les parties de la fiche.

_images/admin_couche_minifiche_nonexpert.png

Lorsque le label d’un champ est renommé à un endroit de l’application, il est renommé partout ailleurs.

Le Mode expert permet d’aller plus loin dans le paramétrage de la fiche en codant le contenu en Nunjucks.

Le code est généré à partir de ce qui existe dans le mode avec assistant, en revanche l’inverse n’est pas vrai. C’est à dire que le mode avec assistant n’est pas synchronisé avec le Mode expert.

Ce mode avancé s’adresse à des utilisateurs développeurs. Il peut être intéressant de l’utiliser pour ajouter du texte coloré, des liens hypertexte ou des images.

_images/admin_couche_minifiche_expert.png

Onglet FILTRE

L’outil de filtre permet de restreindre les éléments sur la carte en fonction des valeurs de champs sélectionnées.

L’outil de filtre n’est pas actif par défaut.

Pour ajouter un filtre sur la couche cliquez sur AJOUTER.

Plusieurs types de filtrage sont disponibles en fonction des types de champs :

Une seule valeur (texte)
Plusieurs valeurs (texte)
Une étendue de valeurs (numérique ou date)

Au niveau de l’affichage, il est possible de choisir:

Aucune valeur
Toutes les valeurs disponibles pour le champ
Une liste de valeurs

Il est possible de remonter/descendre les filtres dans l’ordre souhaité.

Onglet TABLE

La table attributaire permet d’avoir une vision tabulaire des données de la couche. Elle n’est pas activée par défaut.

Une fois la table activée, l’utilisateur peut configurer l’affichage des champs et autoriser leur export au format xlsx.

Il est possible de remonter/descendre les champs dans l’ordre souhaité.

Onglet WIDGET

L’outil de widget permet de récapituler dans un tableau dynamique des indicateurs utiles à l’analyse de la couche.

Sur le visualiseur cartographique, lors du zoom sur la carte, la synthèse se réactualise en fonction des éléments qui se trouvent dans l’emprise spatiale.

La configuration de l’outil de widget s’adresse à des utilisateurs développeurs car il requiert l’écriture en JSON avec dans la clé “template” une chaîne de caractère contenant le code en Nunjucks du format de données attendu.

Modifier une couche

Pour modifier une couche existante, cliquez sur la couche dans la liste et effectuez vos changements.

Dupliquer une couche

La duplication d’une couche inclut la copie :

du style
de la légende
de l’infobulle
de la mini-fiche
du widget

Pour dupliquer une couche cliquez sur le bouton DUPLIQUER depuis la liste des couches.

Un message indique à l’utilisateur que la couche a bien été dupliquée.

Supprimer une couche

Pouvoir supprimer une source de données nécessite de s’assurer qu’elle n’est utilisée dans aucun vue. Si ce n’est pas le cas, la suppression ne pourra pas être effectuée.

Pour supprimer une couche, vous avez deux façons de procéder :

dans la liste, cliquez sur la vue et en bas de la page cliquez sur le bouton SUPPRIMER
dans la liste, cochez la couche et cliquez sur le bouton SUPPRIMER

Note

Toute suppression est définitive.

Liste des vues

La configuration des menus d’accès aux couches de données s’appelle les vues.

Il s’agit de la dernière étape à réaliser (après la création de la source, puis création de la couche) pour visualiser ses données.

Pour afficher l’ensemble des vues cliquez sur Liste des vues.

Vous arrivez sur une page présentant la liste de toutes les vues déclarées.

Créer une vue

Pour ajouter une nouvelle vue cliquez sur le bouton CRÉER.

Les informations à renseigner à minima lors de la création d’une nouvelle vue sont le nom, le type de vue, le classement et l’arbre des couches.

Il existe deux types de vues :

Carte : les couches sont affichés dans une arborescence composée de groupes
Storytelling : les couches sont affichés à droite d’une description (analyse de carte, chiffre clés..) et l’utilisateur les fait défiler dans l’ordre dans lesquelles elles sont ordonnées dans l’arbre des couches.

Le classement permet d’affecter à la vue une position par rapport aux autres (exemple : 1ere position, deuxième position..). Il est possible de créer autant de vues que nécessaire mais il ne peut pas y avoir plus de 10 vues affichées dans le visualiseur cartographique.

Il est possible de définir une emprise géographique différente de l’emprise par défaut du visualiseur cartographique (exemple : Centre ville de Thionville). Pour cela, il suffit de dessiner la zone à afficher à l’aide de l’outil de dessin.

S’il a définit au préalable des fonds de carte dans le module Liste des fonds de carte, l’utilisateur peut choisir de les utiliser dans une vue. Si il ne le fait pas, c’est le fond de carte par défaut (Mapbox Monochrome Light) qui sera utilisé.

Une icône par défaut est appliquée à la vue si l’utilisateur ne lui en choisis pas. Sa couleur est blanche afin que l’icône se démarque bien sur le menu des vues dans le visualiseur cartographique. Le format supporté par l’outil est le png.

Arbre des couches

Une couche appartient obligatoirement à un groupe.

Pour ajouter un groupe cliquez sur le bouton CRÉER UN GROUPE.

Pour ajouter une couche à un groupe cliquez sur le + et choisissez la dans la liste.

Vous pouvez construire votre arbre en ajoutant, déplaçant, imbriquant les éléments.

A partir d’un groupe, en cliquant sur les trois petits points verticaux vous avez la possibilité de :

Ajouter une couche
Ajouter un sous-groupe
Paramétrer le mode de sélection des couches (exclusif/inclusif)
Supprimer un groupe

Note

Une couche ne peut être ajoutée qu’à une seule vue à la fois.

L’enregistrement de la vue aura pour effet immédiat de rajouter automatiquement l’ensemble des éléments de l’arbre des couches dans le visualiseur cartographique.

Pour modifier une vue existante, cliquez sur la vue dans la liste et effectuez vos changements.

Supprimer une vue

Pour supprimer une vue, vous avez deux façons de procéder :

dans la liste, cliquez sur la vue et en bas de la page cliquez sur le bouton SUPPRIMER
dans la liste, cochez la vue et cliquez sur le bouton SUPPRIMER

Note

Toute suppression est définitive.

Fonds de carte

Le module Fonds de carte de TerraVisu permet à l’utilisateur de définir ses fonds de cartes sur lesquels viendront se superposer les couches de données cartographiques de l’application.

L’utilisateur peut par exemple ainsi basculer d’un fond de plan cartographique à une photographie aérienne pour avoir un meilleur aperçu de la réalité physique du territoire d’étude.

Liste des fonds de carte

Trois types de fonds de cartes peuvent être définis :

Raster
Vectoriel
Mapbox

Pour afficher l’ensemble des fonds de carte cliquez sur Liste des fonds de carte.

Vous arrivez sur une page présentant la liste de tous les fonds de carte existants.

Créer un nouveau fond de carte

Pour ajouter un nouveau fond de carte cliquez sur le bouton CRÉER.

Les informations à renseigner à minima lors de la création d’un nouveau fond de carte sont le nom, le type et l’URL.

La taille des tuiles est modifiable mais elle est définie par défaut sur la valeur 256. Le curseur de l’amplitude du zoom permet de choisir à quel niveau de zoom les tuiles du fond de carte s’afficheront dans le visualiseur.

Une fois les fonds de plan ajoutés, l’utilisateur peut les choisir de les utiliser dans les vues qu’il veut.

_images/admin_fondscarte_modification.png

Modifier un fond de carte

Pour modifier un fond de carte existant, cliquez sur le fond de carte dans la liste et effectuez vos changements.

Supprimer un fond de carte

Pour supprimer fond de carte, vous avez deux façons de procéder :

dans la liste, cliquez sur le fond de carte et en bas de la page cliquez sur le bouton SUPPRIMER
dans la liste, cochez le fond de carte et cliquez sur le bouton SUPPRIMER

Note

Toute suppression est définitive.

Install instructions

Requirements

You need docker installed. Compose plugin is recommended in the configuration below.
See Docker.
Optional : if you want to use external database, prepare a postgresql 11+ (15 recommended) postgis2.5 (3.3 recommended) database with postgis enabled, and a dedicated user.
You can use external database by commenting postgres container and volume references in docker-compose.yml, and set variables in your conf/visu.env file :
POSTGRES_HOST

POSTGRES_PORT

POSTGRES_USER

POSTGRES_PASSWORD

POSTGRES_DB

Add local IPs in pg_hba.conf to allow connection from docker containers to your database.

You can use external nginx proxy. Edit provided nginx conf file and comment nginx references in docker-compose.yml. Fix web:8000 to 127.0.0.1:8000 in nginx.conf.

Install

Download zip package
Unzip it where you want
```
unzip install.zip
cd terra_visu
```
Prepare environment variables
```
./conf/visu.env
```
-> Set or change all required values

at least:

ALLOWED_HOST # list of your final host(s), comma separated values

SECRET_KEY # unique key for your project. See https://djecrety.ir/

POSTGRES_USER # a dedicated user for your database

POSTGRES_PASSWORD # a dedicated password for your database

Pull images
```
docker compose pull
```
Init database and project config
```
docker compose run --rm web update.sh
```

Create your super user

docker compose run --rm web ./manage.py createsuperuser

Load initial data

docker compose run --rm web ./manage.py loaddata project/fixtures/initial.json

Launch stack
```
docker compose up -d
```
… and access to TerraVisu
```
http://<your_domain>/
```

You can change port mapping by using a .env file in terra_visu directory :

# .env
NGINX_PORT=8080

Update

Read release notes about bugfix, news and breaking changes.
Backup your data (database, public/media and var/ folder)
Pull latest image
```
docker compose pull
```
Run post update script
```
docker compose run --rm web update.sh
```

Relaunch your stack

docker compose down
docker compose up -d

Configuration

Environment variables

Add your environment variables in app.env file.

General

ALLOWED_HOSTS

domains allowed to be used by your instance. Support comma separated values.

Example:

ALLOWED_HOSTS=mysite.fr  # ALLOWED_HOSTS=mysite.fr,my.other.site.fr

SECRET_KEY

unique secret key for your instance. (https://djecrety.ir/)

Example:

SECRET_KEY=zbesj@t3_&u75&l=xk@ftg1yh4wy)i)9!z+(v$ig7*-*lkd6om

SSL_ENABLED

Set true if your site is behind ssl proxy.

Example:

SSL_ENABLED=True

Default:

False

OIDC Connect

To allow OIDC login, you should configure these settings.

OIDC_ENABLE_LOGIN

Enable OIDC connect login.

Example:

OIDC_ENABLE_LOGIN=True

Default:

False

OIDC_DISABLE_INTERNAL_LOGIN

Disable internal login if OIDC enabled. (direct redirection to OIDC login)

Example:

OIDC_DISABLE_INTERNAL_LOGIN=True

Default:

False

OIDC_AUTH_SERVER

Set your OIDC Realm URL.

Example:

OIDC_AUTH_SERVER=https://your.openid.com/realms/master

OIDC_AUTH_CLIENT_ID

Set your OIDC Client ID.

Example:

OIDC_AUTH_CLIENT_ID=your-client-id

OIDC_AUTH_CLIENT_SECRET

Set your OIDC Client secret.

Example:

OIDC_AUTH_CLIENT_SECRET=7GcKm7XiWIE6BRscGHZZku

OIDC_AUTH_SCOPE

Set your OIDC Client scope. Support comma separated values.

Example:

OIDC_AUTH_SCOPE=openid,email

Default:

openid

SENTRY

SENTRY_DSN

Set your SENTRY_DSN to enable sentry reporting.

Example:

SENTRY_DSN=https://your.sentry/dsn

Default:

None

SENTRY_TRACE_SAMPLE_RATE

Specify sample rate for your performance tracking.

Example:

SENTRY_TRACE_SAMPLE_RATE=1.0

Default:

0.2

SENTRY_SEND_DEFAULT_PII

Specify if sentry enable user informations.

Example:

SENTRY_SEND_DEFAULT_PII=False

Default:

True

API Schemas

API_SCHEMA

Set true if you want to expose API openapi schema. It expose /api/schema/ endpoint.

Example:

API_SCHEMA=True

Default:

False

API_SWAGGER

Set true if you want to expose API swagger. API_SCHEMA should be enabled. It expose /api/schema/swagger/ endpoint.

Example:

API_SWAGGER=True

Default:

False

API_REDOC

Set true if you want to expose API redoc. API_SCHEMA should be enabled. It expose /api/schema/redoc/ endpoint.

Example:

API_REDOC=True

Default:

False

Troubleshooting

Elastic search container doesn’t start

If you have:

bootstrap check failure [1] of [1]: max virtual memory areas vm.max_map_count [xxx] is too low, increase to at least [yyy]

Then you need to increase the vm.max_map_count on your host machine.

sudo nano /etc/sysctl.conf
vm.max_map_count=262144

Then reboot your machine.

Contributing

Conventions

Before contributing, open an issue and discuss about it with community (is it a bug or a feature ? What is the best way to achieve my goal ?)
Use flake8
KISS & DRY as much as possible
Elegant and generic is good, simple is better
Separate bug fixes and new features in several pull requests.
Open a new Pull Request in “Draft” status until tests passed. Use at least ‘bug’, ‘improvement’ or ‘feature’ label.
Commits messages are explicit and mention issue number ((ref #12) or (fixes #23))
Features are developed in a branch and merged from Github pull-requests.

Definition of done

docs/changelog.rst is up-to-date
An explicit unit-test covers the bugfix or the new feature.
Unit-tests total coverage is above or at least equal with previous commits. Patch coverage is 100% on new lines.
Settings have default value in project/settings/__init__.py
Installation instructions and documentation are up-to-date

Development

Prepare stack

cp db.env.dist db.env
cp app.env.dist app.env
docker compose build

Init database

docker compose run --rm web ./manage.py migrate

Load initial data

docker compose run --rm web ./manage.py loaddata project/fixtures/initial.json

Create your superuser

docker compose run --rm web ./manage.py createsuperuser

Prepare admin if required

make build_admin

Prepare frontend if required

make build_front

Launch stack

docker compose up

Access

Linting

We use flake8, isort and black rules. You can run :

make lint

to check them

Modification

Each modification should be done in a Pull request correctly named and labeled (dependencies, bug, enhancement, …) with a changelog entry.

Release process

Changelog should be up to date
assign version number in project/VERSION and docs/source/changelog.rst with date (version in the form YYYY.MM.XX where YYYY is the year, MM the month, XX the release number in the month.)
Use Release fonction in github to create a release with the same name as the version number
Use release notes button to generate release notes
CI publish a new docker image.
Back to dev by adding “+dev” to project/VERSION and new changelog section with XXXX-XX-XX date and version

Translating

Getting started

Documentation

We use sphinx doc and sphinx-rtd-theme. Requirements are included.

To compile and test documentation on local environment, run :

docker-compose up -d sphinx

Design

Architecture

Main components

Authors

Jean-Etienne Castagnede
Jérémie Pardou
Maxime Bouveron
Alice Chetta
Cédric Farcy
Pauline Millet
Florian Sommariva
Benjamin Marguin
Timothée de Montety
Marine Faucher

Changelog

2023.8.3 (2023-08-29)

Improvements:

Optimize source refresh and ES indexation process

2023.8.2 (2023-08-10)

Improvements:

Add close button to partners modal
Improve source reporting interface in admin

Bugfix

Allow numbers in source filter variables in admin

2023.8.1 (2023-08-03)

Improvements:

Add filter feature for layers tree
Make some A11y enhancements

Bugfix

Remove legend scaling
Fix invisible splash-screen catching clicks

2023.7.2 (2023-07-25)

Improvements:

Add icon categorization in layers in admin.

Bugfix

Fix tooltip on menubar in frontend.

2023.7.1 (2023-07-11)

Improvements:

Enable legends for WMTS layers.
Piecharts are now clickable.
Piecharts are disabled in extra styles.
Icons can now be categorized in layer admin.

2023.7.0 (2023-07-03)

Improvements:

Pie charts improvements

2023.6.13 (2023-06-30)

Bugfix

Fix content overflow in storytelling

Improvements:

Pie charts legend definition

2023.6.12 (2023-06-27)

Bugfix

Fix unauthenticated access to Source API endpoint exception.
Legend title, content and box width are fixed

2023.6.11 (2023-06-23)

New features:

Map visualization with circular diagrams

Bugfix

Fix info content overflow if height taller than window

2023.6.10 (2023-06-22)

Improvements:

Add more options to info content editor in config dashboard

2023.6.9 (2023-06-21)

Bugfix

Fix duplicated legends

2023.6.8 (2023-06-20)

New features:

Allow to define and display pie charts in layer style

Improvements:

Split default info content template in multiple blocks to enhance customization

2023.6.7 (2023-06-19)

Bugfix

Fix upper white ribbon in responsive view
Use autocomplete field for source in layer secondary style and list filter
Fix map PDF export
Fix API filters

2023.6.6 (2023-06-14)

Improvements:

Customize info menu content in config dashboard

Bugfix

Fix restricted menus not showing after login

2023.6.5 (2023-06-14)

Bugfix

Use an autocomplete widget to select source in layer definition in admin (Not limited to 100 elements anymore)

2023.6.4 (2023-06-09)

Improvements:

Ability to define default text for SSO and internal login buttons in frontend and admin

2023.6.3 (2023-06-08)

Bugfix

Fix instance config panel with new dashboard
Fix user login state after an SSO login in frontend

2023.6.2 (2023-06-07)

New feature

Complete OIDC login feature in frontend and admin

Improvements:

In admin layer style, ability to choose if icon style overlaps or not

2023.6.1 (2023-06-01)

Improvements:

Provide user and initial token in both frontend and admin settings API
Provide login and logout urls in API settings in case of SSO authentification enabled

2023.5.5 (2023-05-31)

Improvements:

Implement JWT token generation to authenticate through sessions

2023.5.4 (2023-05-30)

Improvements:

Allow icon_allow_overlap in layer admin style definition

2023.5.3 (2023-05-25)

Improvements:

Allow customization by providing var/conf/{static | templates} folders tu override and adding custom files

2023.5.2 (2023-05-17)

Improvements:

Frontend CSS simplified location

2023.5.1 (2023-05-17)

Bugfix

Fix style image already loaded in frontend

Improvements:

Layer legend title is not required anymore

2023.5.0 (2023-05-10)

Bugfix

Fix legend null values in admin

2023.4.9 (2023-04-26)

Bugfix

Prevent deleted style key in admin to keep null value

Improvements:

Increase style categorization from 20 to 100 element max in admin layer style.

2023.4.8 (2023-04-24)

Bugfix

Fix permission management on source list in admin
Fix regression with style category color picker in admin

2023.4.7 (2023-04-21)

Bugfix

Fix layer duplication and notification in admin

2023.4.6 (2023-04-20)

Improvements:

Layer duplication in admin improved and now made by backend duplication

2023.4.5 (2023-04-20)

Improvements:

Disable autocomplete / autofill on PostGIS source form in admin

Bugfix

Allow PostGIS source form edition in admin without retype password

2023.4.4 (2023-04-19)

Improvements:

Improve admin to define polygons patterns
Filter frontend with non empty views
Default view is now the first ordered for an user (authenticated or not)

2023.4.3 (2023-04-13)

Improvements:

Allow to set group access to extra menu items
Include basic certificates in docker image

2023.4.2 (2023-04-11)

New features:

Allow using style images patterns in polygon advanced styles

2023.4.1 (2023-04-07)

New Version

New Simplified Installation

New documentation

Bug fixes:

Fix and allow date usage in source fields and imported data
Fix group creation / edition in admin
Fix LayerTree cache management
Fix bug when no base layer defined in scene (#109)

New features:

Use icon and patterns in point / polygon styles

Improvements:

Direct use elasticsearch connector for data indexation instead of terra-bonobo-nodes
Better layer duplication
Some instance configuration managed in config panel (/config/)

Maintenance

From Python 3.6 to 3.10
From Django 2.2 to 4.1
All python packages updated
Admin node-js from 12 to 18

User Manual

We have a few places for you to get started:

🚀 Plateforme TerraVisu: Discover everything you need to know about TerraVisu.
🚀 Outil d’administration: Using the back-office for the first time? We have the manual to get you started.

Installation & Configuration

Need to know how something works? Here are a few of the most important reference docs:

🔧 Install instruction: Learn about the requirements and install instructions.
🔧 Configuration: Learn how to set your environment variables.
🔧 Troubleshooting: Learn how to fix common problems.

Contribute

Need to get something specific done? These guides provide step-by-step instructions in key areas to get you up to speed faster:

✨ Contributing: Discover how to contribute to this project.
✨ Development: Overview of all the main commands of developement.
✨ Translating: Feel free to translate our doc.
✨ Documentation: Get familiar with some of the more advanced topics of building and deploying documentation with Read the Docs.
✨ Design: Information about the architecture and main components

Others

Learn about the authors and browse the changelog:

📝 Authors: Learn more about the authors.
📝 Changelog: Overview of all notable changes made to the project.

Welcome to TerraVisu’s documentation!

Plateforme TerraVisu

TerraVisu

Les principales fonctionnalités

L’interface cartographique

Les données géographiques

Le filtrage des données

La fiche descriptive

L’infobulle au survol

Le widget

La légende

La table attributaire

Le zoom sur les éléments d’une couche

Les outils de navigation

La recherche sur la carte

L’impression de la carte au format PDF

La visualisation en Storytelling

Outil d’administration

L’outil d’administration

Authentification

Procédure d’authentification

Page d’accès

Module de gestion des utilisateurs

Liste des utilisateurs

Créer un nouvel utilisateur

Liste des groupes d’utilisateurs

Créer un nouveau groupe d’utilisateurs

Module Visualiseur

Liste des sources de données

Créer une source de données

Import de fichiers

GeoJSON ou Shapefile

CSV

Import via une requête PostGIS

Import via un flux WMS/WMTS

Enregistrer une source de données

Modifier une source de données

Dupliquer une source de données

Supprimer une source de données

Liste des couches

Créer une couche

Onglet DÉFINITION

Filtrage de source

Onglet ICÔNES

Onglet STYLE

Style simple

Style avec motif

Style avec une analyse

Exemples de styles Mapbox avancés

Ajouter un style secondaire

Style sans assistant

Onglet LÉGENDES

Onglet FENÊTRE AU SURVOL

Onglet MINI-FICHE

Onglet FILTRE

Onglet TABLE

Onglet WIDGET

Modifier une couche

Dupliquer une couche

Supprimer une couche

Liste des vues

Créer une vue

Arbre des couches

Supprimer une vue

Fonds de carte

Liste des fonds de carte

Créer un nouveau fond de carte

Modifier un fond de carte

Supprimer un fond de carte

Install instructions

Requirements

Install

Update

Configuration

Environment variables

General

OIDC Connect

SENTRY

API Schemas

Troubleshooting