Heatmap 3×3 IPR (Attendu × Présent) — entièrement paramétrable

Source: R/ipr_heatmap_3x3.R

Génère la matrice 3×3 croisant :

  • la probabilité d’occurrence attendue issue du modèle IPR (L1–L2–L3),

  • l’effectif réellement observé lors de l’opération (C1–C2–C3).

Seuls les taxons contributifs de l’IPR sont utilisés (liste codée en dur). Chaque cellule affiche une étiquette multilignes regroupant les taxons présents sous la forme : "Nom (effectif)".

La fonction est entièrement paramétrable :

  • contrôle de la taille des labels internes,

  • contrôle de la taille des textes et titres d’axes,

  • possibilité d’afficher ou masquer les titres et/ou les valeurs d’axes,

  • personnalisation du titre du graphique et de l’épaisseur des bordures.

Cette flexibilité permet notamment :

  • d’utiliser la fonction seule (axes complets visibles),

  • ou de l’intégrer dans une planche multi‑graphes avec axes communs (en désactivant les titres des axes mais en conservant les valeurs).

ipr_heatmap_3x3(
  yaml_path,
  code_operation = NULL,
  code_station = NULL,
  code_point_prelevement_aspe = NULL,
  seuil_attendu = c(0.6, 0.2),
  seuil_abondant = 20,
  titre = NULL,
  size_labels = 3.8,
  lineheight_labels = 0.9,
  size_axis_text = 11,
  size_axis_title = 12,
  size_title = 14,
  tile_border_size = 1.1,
  show_axis_text = TRUE,
  show_axis_titles = TRUE
)

Arguments

yaml_path

Chemin du fichier YAML contenant les informations de connexion à PostgreSQL.

code_operation

Code de l’opération ASPE dont la matrice IPR doit être représentée.

seuil_attendu

Vecteur numérique de deux valeurs indiquant les seuils haut et bas de probabilité pour définir les classes L1/L2/L3. Par défaut c(0.6, 0.2).

seuil_abondant

Seuil d’effectif au‑delà duquel la catégorie C1 (abondant) est attribuée. Par défaut 20.

titre

Titre optionnel du graphique. Si NULL, aucun titre n’est ajouté.

size_labels

Taille des textes affichés dans les tuiles.

lineheight_labels

Interligne pour les labels internes à chaque tuile.

size_axis_text

Taille des valeurs d’axes (ticks).

size_axis_title

Taille des titres des axes (si affichés).

size_title

Taille du titre du graphique (si affiché).

tile_border_size

Épaisseur du contour des tuiles.

show_axis_text

Logique : afficher (TRUE) ou non (FALSE) les valeurs des axes X et Y. Utile pour conserver les valeurs d’axes dans des planches multi‑vignettes.

show_axis_titles

Logique : afficher (TRUE) ou non (FALSE) les titres des axes. Généralement mis à FALSE dans les planches où les titres sont mutualisés.

Value

Un objet ggplot2 représentant la heatmap 3×3.

Examples

if (FALSE) { # \dontrun{
# Appel simple avec axes complets :
ipr_heatmap_3x3("config.yml", code_operation = 38673)

# Appel pour intégration dans une planche (axes mutualisés) :
ipr_heatmap_3x3(
  "config.yml",
  38673,
  show_axis_titles = FALSE,
  show_axis_text   = TRUE
)
} # }