====== Critères de sélection et de floutage des observations de la Synthèse pour l'Atlas  ======

GeoNature-Atlas récupère dans la table ''gn_synthese.synthese'' de GeoNature les observations selon certains critères liés à la requête SQL de sélection permettant de créer la vue matérialisées ''atlas.vm_observations''.

C'est à l'aide la vue matérialisées ''atlas.vm_cor_synthese_area'' que nous floutons les données sensibles (''id_nomenclature_sensitivity'') et privée (''id_nomenclature_diffusion_level'') dans la vue matérialisées ''atlas.vm_observations''.

Voici les liens vers les fichiers SQL ''2.atlas.vm_observations.sql'' de création de ces vues matérialisées :
  * [[https://github.com/PnX-SI/GeoNature-atlas/blob/feat/sinp-aura/data/atlas/2.atlas.vm_observations.sql|AURA]]
  * [[https://github.com/PnX-SI/GeoNature-atlas/blob/feat/sinp-paca/data/atlas/2.atlas.vm_observations.sql|PACA]]

===== Principe de sélection des observations pour l'Atlas =====

Ci-dessous, le FROM et le WHERE de la requête :
<code sql>
FROM synthese.synthese s
     JOIN atlas.vm_taxref tx 
        ON tx.cd_nom = s.cd_nom
     JOIN synthese.t_nomenclatures sens 
        ON s.id_nomenclature_sensitivity = sens.id_nomenclature
     JOIN synthese.t_nomenclatures dl 
        ON s.id_nomenclature_diffusion_level = dl.id_nomenclature
     JOIN synthese.t_nomenclatures st 
        ON s.id_nomenclature_observation_status = st.id_nomenclature
     LEFT JOIN blurred_centroid_insee bci 
        ON bci.id_synthese = s.id_synthese
WHERE s.the_geom_point IS NOT NULL 
    AND st.cd_nomenclature::text = 'Pr'::text 
    AND dl.cd_nomenclature::text <> '4'::text 
    AND (sens.cd_nomenclature::text <> ALL (ARRAY['4'::character varying, '2.8'::character varying]::text[]))
</code>

Pour être intégré dans l'Atlas, une observations dans la table ''gn_synthese.synthese'' doit donc avoir:
  * un ''cd_nom'' renseigné (pas de NULL)
  * une géométrie dans ''the_geom_point'' renseigné (pas de NULL)
  * une nomenclature ''id_nomenclature_sensitivity'' renseignée (pas de NULL). Nous éliminons les observations avec les valeurs "''4''" et "''2.8''" (//Aucune diffusion//).
  * une nomenclature ''id_nomenclature_diffusion_level'' renseignée (pas de NULL). Nous éliminons les observations avec la valeur "''4''" (//Aucune diffusion//).
  * une nomenclature ''id_nomenclature_observation_status'' renseignée (pas de NULL) et valant "''Pr''" (//Présence//). Nous éliminons les données d'absence.

===== Principe de floutage des observations pour l'Atlas =====

**Nous floutons les données sensibles et privée** (nomenclatures ''id_nomenclature_sensitivity'' et ''id_nomenclature_diffusion_level'') dans la vue matérialisées ''atlas.vm_observations''. Il est donc important d'avoir renseigné ces deux nomenclatures correctement.

Depuis le passage à l'Open Data, **la nomenclature ''id_nomenclature_diffusion_level'' devrait valoir "''5''"** (//Diffusion telle quelle : si une donnée précise existe, elle doit être diffusée telle quelle.//) pour toutes les données.

Pour le floutage, la vue matérialisée ''atlas.vm_cor_synthese_area'' contient toutes les observations sensibles ou privées floutées avec leur(s) maille(s) de floutage correspondante(s).\\ 
En suite, la vue matérialisé ''atlas.vm_observations'' se charge de récupérer le **centroïde de l'union de toutes les géométries des mailles** de floutage des observations sensibles ou privées floutées. C'est ce centroïde qui sera utilisé pour déterminer la commune dans laquelle l'observations sera affectée.

Correspondance nomenclature et maille de floutage retenue :
|cd_nomenclature (id_nomenclature_sensitivity) |Maille |
|1 | M5|
|2 | M5|
|3 | M5|
|2.1 |M1 |
|2.2 |M2 |
|2.3 |M5 |
|2.4 |M10 |
|2.5 |M20 |
|2.6 |M50 |
|2.7 |M50 |