Figures et cartes de recherche
Une figure mérite sa place lorsqu'elle montre ce qu'un tableau ne peut pas (une tendance dans le temps ou le débit, une distribution, une disposition spatiale) et qu'elle est lisible à la taille d'impression en niveaux de gris. Chaque figure scriptée lit ses données à partir de fichiers, elle ne peut donc pas dériver des nombres du texte.
Flux de travail
- Décider ce que la figure doit montrer en une phrase et vérifier qu'un tableau ne le ferait pas mieux. Noter le journal cible et ses largeurs de colonne.
- Choisir la forme à partir de references/figure-guide.md : types de variables, axes, transformations (log pour les débits et les charges), et comment l'incertitude est représentée.
- La coder avec le module de style maison
scripts/zfig.py:use_style(),figure("single"|"onehalf"|"double", height_mm), et les recetteshydrograph_with_rain,flow_duration,load_duration,obs_vs_sim,scenario_bars. Un script par figure (figN_short_name.py), données lues par chemin explicite, unités dans chaque étiquette d'axe, et une assertionassertpour chaque nombre que le texte cite à partir de la figure. Exécuterpython scripts/zfig.pyune fois pour l'auto-test dans un nouvel environnement. - Cartes : suivre la liste de contrôle des cartes dans le guide (SCR indiqué, barre d'échelle, flèche nord lorsque l'orientation n'est pas évidente, carton de localisation, légende avec unités, sources de données et crédits de licence dans la légende). Pour les mises en page finales, QGIS ou ArcGIS Pro est généralement plus rapide que matplotlib ; de toute façon, scripter la préparation des données.
- Regarder le fichier rendu à sa taille finale avant de le déclarer terminé : étiquettes coupées ou qui se chevauchent, légende cachant les données, graduations illisibles, couleurs se confondant en niveaux de gris ou pour les daltoniens.
- Légende : ce qui est montré, puis comment le lire (symboles, lignes, trames, unités, période, n). Garder l'interprétation dans le texte.
Valeurs par défaut importantes
- Palette qualitative Okabe-Ito (intégrée dans
zfig) ; viridis, cividis ou cartes de couleurs scientifiques Crameri pour les données continues ; cartes divergentes uniquement autour d'un zéro significatif (par ex. changement par rapport à la référence). Pas d'arc-en-ciel ni de jet (Crameri et al. 2020). - Texte à 8 pt à la taille finale, minimum 7 pt ; épaisseurs de ligne 0,6–1,0 pt.
- Données observées en noir ou gris foncé et simulations en couleur, de manière cohérente entre les figures.
- Axes logarithmiques pour les débits, les charges et les concentrations s'étendant sur plusieurs ordres de grandeur ; le mentionner dans l'étiquette.
- Afficher l'incertitude (bandes d'incertitude à 95 %, plages entre scénarios ou membres climatiques, intervalles de confiance) ; une barre sans son intervalle surestime la certitude.
- Ne pas inventer de données, de coordonnées ou d'étiquettes ; si des données manquent, écrire le script avec un
NotImplementedErrorclair et lister ce qui est nécessaire.
Python d'abord et commenté ; indiquer les unités, le SCR et le pas de temps dans la docstring de chaque script de figure.