Skip to content

Commit

Permalink
Review doc sensitivity.rst
Browse files Browse the repository at this point in the history
  • Loading branch information
camillemonchicourt authored Jan 8, 2025
1 parent 535cc4b commit b52ec4a
Showing 1 changed file with 20 additions and 13 deletions.
33 changes: 20 additions & 13 deletions docs/sensitivity.rst
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Critères de sensibilité
* Comportement de l’occurence

Certaines règles de sensibilité peuvent porter uniquement sur l’espèce,
rendant l’entiereté des observations d’une espèce (et donc une espèce) sensible.
rendant l’entièreté des observations d’une espèce (et donc une espèce) sensible.

Niveaux de sensibilité
``````````````````````
Expand Down Expand Up @@ -67,9 +67,15 @@ sensibilité défini dans ``t_sensitivity_rules`` est appliqué peu importe
le statut biologique ou le comportement de l’occurence.
De même, s’il n’y a aucune entrée dans ``cor_sensitivity_area``, le niveau
de sensibilité est appliqué peu importe la localisation de l’observation.
À l’inverse, s’il y a plusieurs entrées, la sensibilité est appliqué dès
À l’inverse, s’il y a plusieurs entrées, la sensibilité est appliquée dès
que l’un des critères ou l’une des zones correspond à l’observation.

Si des règles de sensibilité sont définies avec des conditions de critères
sur une nomenclature (Statut biologique ou Comportement),
alors ces règles sont appliquées aussi si la nomenclature n'est pas renseignée
(par principe de précaution), en dupliquant les règles pour les valeurs de
nomenclature "Non renseigné", "Ne sait pas", "Indéterminé",... (https://github.com/PnX-SI/GeoNature/blob/30c27266495b4affc635f79748c9984feb81a6d7/backend/geonature/core/sensitivity/utils.py#L37-L54).

Certaines règles sont définies non pas pour une espèce donnée mais pour un
rang supérieur. Ces règles sont artificiellement dupliquées pour chaques espèces
sous-jacentes dans la vue matérialisée ``t_sensitivity_rules_cd_ref``.
Expand Down Expand Up @@ -149,7 +155,7 @@ Taxref v14 :
--encoding=iso-8859-15
Le jeu de règles est fourni pour chaque version précise de Taxref, certaines
espèces sensibles pouvant voir leur *cd_nom* changé d’une version à l’autre.
espèces sensibles pouvant voir leur *cd_nom* changer d’une version à l’autre.

Si vous mettez à jour votre version du référentiel de sensibilité, il faut ensuite relancer
le calcul des règles de sensibilité avec la commande ``geonature sensitivity refresh-rules-cache``.
Expand Down Expand Up @@ -196,35 +202,36 @@ Utilisation
Un lien entre la synthèse et la sensibilité a été mis en place : le floutage des données sensibles.

L'objectif et de pouvoir donner accès aux utilisateurs à des données sensibles mais pas de façon précise.
C'est à dire, en fonction du niveau de sensibilité de l'observation, un utilisateur pourra voir uniquement
C'est-à-dire, en fonction du niveau de sensibilité de l'observation, un utilisateur pourra voir uniquement
l'observation à la maille de 10km par exemple.

Comme décrit ci-dessous, un paramètre en configuration a été ajoutée pour donner l'a possibilité d'exclure
Comme décrit ci-dessous, un paramètre en configuration a été ajouté pour donner la possibilité d'exclure
toutes les données sensibles plutôt que de les flouter.

Implementation
^^^^^^^^^^^^^^

Basée sur le nouveau système de permissions (v2.13), l'implémentation dans ce système se résout à
l'ajout d'un filtre : exlure/flouter les données sensibles.
Le choix entre l'exclusion et le floutage est décidé par le paramètre en configuration :
l'ajout d'un filtre : exclure/flouter les données sensibles.
Le choix entre l'exclusion et le floutage est défini par le paramètre en configuration :

.. code-block:: toml
[SYNTHESE]
BLUR_SENSITIVE_OBSERVATIONS = true
Si `BLUR_SENSITIVE_OBSERVATIONS=true` alors les observations seront floutées. Sinon exclues.
Si ``BLUR_SENSITIVE_OBSERVATIONS=true`` alors les observations seront floutées. Sinon exclues.

L'exclusion des données sensibles est simple : si le filtre "exclure les données sensibles" est coché,
l'utilisateur n'aura pas accès (pour un scope défini) aux données sensibles quelque soit leur niveau
de sensibilité soit :
de sensibilité soit :

- Sensible - Diffusion à la Commune ou Znieff
- Sensible - Diffusion à la maille 10km
- Sensible - Diffusion au département
- Sensible - Aucune diffusion

Pour la suite de la documentation, le paramètre est considéré comme le suivant : `BLUR_SENSITIVE_OBSERVATIONS=true`.
Pour la suite de la documentation, le paramètre est considéré comme le suivant : ``BLUR_SENSITIVE_OBSERVATIONS=true``.
Donc toute donnée sensible avec restriction d'accès sera floutée.

Si ce filtre n'est pas activé, la récupération des données de la synthèse en backend reste inchangée.
Expand Down Expand Up @@ -260,7 +267,7 @@ Traitement des problématiques liés aux zonages
Il a été décidé d'exclure les données sensibles dont la géométrie floutée est plus grande que la
maille affichée en mode maille dans la synthèse.

C'est à dire que si une observation est dégradée/floutée à la maille M10 (10km²) et que le mode maille
C'est-à-dire que si une observation est dégradée/floutée à la maille M10 (10km²) et que le mode maille
affiche les observations regroupées dans les mailles de type M5 (5km), l'observation n'apparaitra dans
aucune maille mais dans seulement dans la liste des observations.

Expand All @@ -275,14 +282,14 @@ Pour que ce filtrage soit effectué, il était nécessaire d'introduire une nouv
``ref_geo.bib_area_types`` : ``size_hierarchy`` qui permet d'ordonner les types de zones par leur
taille moyenne. Pour les mailles cela est simple, pour les départements et les communes notamment
utilisées pour flouter la donnée, cela est plus complexe. Leur taille a donc été donnée arbitrairement.
Le floutage des données est censé évoluer vers des zones de floutages basées exclusivement sur des
Le floutage des données est censé évoluer vers des zonages de floutage basées exclusivement sur des
mailles. Le problème de la taille arbitraire ne sera alors plus d'actualité.


**Traitement des zonages associés**

L'introduction de la nouvelle colone ``size_hierarchy`` permet également d'afficher uniquement les
zonages plus grands que la géométrie floutée dans l'onglet Zonage des détails d'une observation en
zonages plus grands que la géométrie floutée dans l'onglet "Zonage" des détails d'une observation en
synthèse. Par exemple, les mailles M1 (1km²) et M5 (5km²) d'une observation floutée à la maille M10
(10km²) n'apparaitront pas.

Expand Down

0 comments on commit b52ec4a

Please sign in to comment.