Fonctions graphiques dans floodam.cba
floodam.cba propose plusieurs fonctions graphiques partageant une interface homogène pour le choix de la langue et l’exportation vers fichier :
-
plot_calendar_state() : visualise la chronique annuelle des états de la nature parcourus par un projet dans un objet Case (calendrier "simple" ou "probabilistic") ;
-
plot() / plot_sa() : point d’entrée principal pour les objets "cba_uncertainty", délégant vers :
path = system.file("extdata", "case", "simple.ods", package = "floodam.cba")
case = import_case(path)
#> import Case from /usr/local/lib/R/site-library/floodam.cba/extdata/case/simple.ods
#> ... done
plot_calendar_state(case, project = "dyke", legend = "inline", lang = "fr")
Gestion des langues (lang et label_graphic)
Toutes les fonctions graphiques acceptent un argument lang (par défaut "en") pour traduire les titres, axes et légendes.
Les traductions sont stockées dans le jeu de données label_graphic, couvrant 11 langues identifiées par leur code ISO 639-1 :
names(label_graphic[["common"]][["npv"]])
#> [1] "en" "fr" "es" "it" "de" "pt" "zh" "ja" "ru" "ar" "hi"
-
"en" (anglais)
-
"fr" (français)
-
"es" (espagnol)
-
"it" (italien)
-
"de" (allemand)
-
"pt" (portugais)
-
"zh" (chinois)
-
"ja" (japonais)
-
"ru" (russe)
-
"ar" (arabe)
-
"hi" (hindi)
Si un code langue non supporté est demandé (ou si une clé manque pour une langue donnée), floodam.cba se replie automatiquement sur "en".
Note
Les étiquettes multilingues de label_graphic ont été traduites « automatiquement » et n’ont pas toutes été relues par des spécialistes du domaine. Tous les retours, corrections ou propositions d’amélioration sont les bienvenus !
Exemple d’utilisation sur plot() avec lang = "es" :
dyke_sa = perform_sa(case, "dyke", n = 500)
#> Model EAD: 5250
#> Model NPV: -41810
#> Registered S3 method overwritten by 'sensitivity':
#> method from
#> print.src dplyr
#> Evaluating sa_model ...
#> ... Elapsed time: 0.001573801 secs
#> Sensitivity analysis is performed using sensitivity::sobolmartinez
#> Evaluating sa_sobol ...
#> ... Elapsed time: 0.328234 secs
plot(dyke_sa, type = "uncertainty", lang = "es")
Exportation calibrée A4 (device et dir_output)
Toutes les fonctions graphiques partagent les arguments device et dir_output :
-
device : "active" (par défaut, trace sur le périphérique graphique actif), "pdf", "png", "jpg", "jpeg" ou "svg" ;
-
dir_output : répertoire cible lorsque device != "active" (par défaut tempdir()).
Lors d’une sauvegarde dans un fichier :
- Les dimensions et la taille de police (
pointsize = 10) sont calibrées pour une intégration directe à l’échelle 1:1 dans un rapport A4 (ex. pouces pour plot_sa_triplet(), pouces pour plot_sa(..., type = "both"), ou pouces pour les graphiques simples) ;
- Le nom du fichier suit la convention
<case>-<project>-<graphic>-<lang>.<ext> ;
- Aucune fenêtre graphique vide n’est ouverte à l’écran ;
- Un message console indique le chemin du fichier généré, et la fonction retourne ce chemin de manière invisible :
out_path = plot(
dyke_sa,
type = "triplet",
lang = "fr",
device = "pdf",
dir_output = tempdir()
)