Skip to content

Latest commit

 

History

History
148 lines (115 loc) · 5.48 KB

README.md

File metadata and controls

148 lines (115 loc) · 5.48 KB
Raw

Dashboard

Module GeoNature permettant de proposer un tableau de bord contenant plusieurs graphiques et cartes basés sur les données présentes dans la synthèse de GeoNature.

Développé par Elsa Guilley, stagiaire au Parc national des Ecrins en 2019.

Démo vidéo : https://geonature.fr/docs/img/2019-09-GN-dashboard-0.1.0.gif

Fonctionnalités :

  • Nombre d'observations et de taxons par année
  • Nombre d'observations et de taxons par zonage (communes, mailles...)
  • Répartition des observations par rang taxonomique
  • Nombre d'observations par cadre d'acquisition par année
  • Taxons recontactés, non recontactés et nouveaux par année
  • Filtres divers sur chaque élément

Présentation :

Installation

  • Téléchargez la dernière version stable du module 
    wget https://github.com/PnX-SI/gn_module_dashboard/archive/X.Y.Z.zip
  • Dézippez la dans /home/myuser/ 
    unzip X.Y.Z.zip
  • Renommer le répertoire 
    mv gn_module_dashboard-X.Y.Z gn_module_dashboard
  • Placez-vous dans le répertoire backend de GeoNature et lancez les commandes 
    source ~/geonature/backend/venv/bin/activate
geonature install-gn-module ~/gn_module_dashboard DASHBOARD
  • Vous pouvez sortir du venv 
    deactivate
  • Relancez GeoNature 
    sudo systemctl restart geonature
sudo systemctl restart geonature-worker

Il vous faut désormais attribuer des permissions aux groupes ou utilisateurs que vous souhaitez, pour qu'ils puissent accéder et utiliser le module (voir https://docs.geonature.fr/admin-manual.html#gestion-des-droits). Si besoin une commande permet d'attribuer automatiquement toutes les permissions dans tous les modules à un groupe ou utilisateur administrateur.

Configuration

Vous pouvez modifier la configuration du module en créant un fichier dashboard_config.toml dans le dossier config de GeoNature, en vous inspirant du fichier dashboard_config.toml.example et en surcouchant les paramètres que vous souhaitez.

Pour appliquer les modifications de la configuration du module, consultez la rubrique dédiée de la documentation de GeoNature.

Détail des paramètres modifiables :

  • Paramétrage du niveau de simplification des zonages sur la carte "Synthèse par entité géographique" : SIMPLIFY_LEVEL. Passer un nombre entier : plus cet entier est grand et plus la simplification est importante. Ce paramètre est nécessaire pour alléger le temps d'affichage des zonages.
  • Paramétrage des zonages affichables sur la carte "Synthèse par entité géographique" : AREA_TYPE. Passer un tableau de type_code (table ref_geo.bib_areas_types). La première valeur de ce tableau sera la valeur utilisée par défaut pour le graphique de synthèse par entité géographique.
  • Paramétrage du nombre de classes sur la carte "Synthèse par entité géographique" : NB_CLASS_OBS (mode 'nombre d'observations') et NB_CLASS_TAX (mode 'nombre de taxons').
  • Paramétrage de l'affichage des graphiques du dashboard : DISPLAY_XXXX_GRAPH. Renseigner 'true' pour afficher le graphique en question et 'false' pour le masquer.
  • Paramétrage par défaut du graphique "Synthèse par entité géographique" du Dashboard : DISPLAY_NBOBS_LEGEND_BY_DEFAULT_IN_GEO_GRAPH. Renseigner 'true' si vous souhaitez afficher par défaut les observations, 'false' si vous souhaitez les taxons.

Vues matérialisées

Dans un soucis de performance, des vues matérialisées ont été mises en place. Elles sont rafraichies automatiquement par Celery tous les jours à 2h du matin.
Vous pouvez configurer la périodicité du rafraichissement via le paramètre de configuration CRONTAB (syntaxe crontab, CRONTAB="" pour désactiver).

Vous pouvez également mettre à jour manuellement les vues matérialisées :

source ~/geonature/backend/venv/bin/activate
geonature dashboard refresh-vm

Cette commande lance la requête SQL suivante :

SELECT gn_dashboard.refresh_materialized_view_data()

Mise à jour du module

  • Téléchargez la nouvelle version du module

    wget https://github.com/PnX-SI/gn_module_dashboard/archive/X.Y.Z.zip
unzip X.Y.Z.zip
rm X.Y.Z.zip

  • Renommez l'ancien et le nouveau répertoire

    mv ~/gn_module_dashboard ~/gn_module_dashboard_old
mv ~/gn_module_dashboard-X.Y.Z ~/gn_module_dashboard

  • Si vous avez encore votre configuration du module dans le dossier config du module, copiez le vers le dossier de configuration centralisée de GeoNature :

    cp ~/gn_module_dashboard_old/config/conf_gn_module.toml ~/geonature/config/dashboard_conf.toml

  • Lancez la mise à jour du module

    source ~/geonature/backend/venv/bin/activate
geonature install-gn-module ~/gn_module_dashboard DASHBOARD
sudo systemctl restart geonature

Licence

  • OpenSource - GPL-3.0
  • Copyleft 2019-2023 - Parc National des Écrins

image