onizuka_9mu522k21sxsmqer_333.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script onizuka_9mu522k21sxsmqer_333.py

Version 1.0.0

Date de création 25/03/2026

Auteur / Demandeur refoïa jeremy

Objectif principal Générer et sauvegarder un graphique linéaire (PNG) à partir de données temporelles.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Ce script fournit une fonction modulaire permettant de transformer un jeu de données (DataFrame Pandas) en une visualisation graphique. Il trace une courbe représentant l’évolution d’un indicateur spécifique sur une période donnée et exporte le résultat sous forme d’image haute résolution.

📌 Problème résolu

Il automatise la création de rapports visuels pour des données de type « Archéo/Web », évitant la configuration manuelle de matplotlib à chaque génération de graphique.

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.x

OS cible Tous (Windows, Linux, MacOS)

Mode d’exécution Module (Fonction appelable)

📦 Dépendances / Librairies

Librairies externes (pip install)

matplotlib (Visualisation de données)

pandas (Manipulation de données structurées)

📥 ENTRÉES (INPUTS)

# Nom Type Obligatoire Description Exemple

1 data pd.DataFrame ✅ Oui Tableau contenant les colonnes ‘annee’ et ‘valeur’. df_stats

2 titre str ✅ Oui Titre affiché en haut du graphique. « Évolution Web »

3 nom_fichier str ✅ Oui Nom du fichier de sortie (sans extension). « graph_2026″

📤 SORTIES (OUTPUTS)

📂 Fichiers / Données en sortie

Type Chemin / Format Description

Image ./{nom_fichier}.png Graphique exporté en 300 DPI avec grille et marqueurs.

🧱 STRUCTURE DU SCRIPT

onizuka_9mu522k21sxsmqer_333.py

│

├── 📌 IMPORTS (matplotlib.pyplot, pandas)

│

├── 📌 FONCTIONS

│ └── generer_graphique_png() → Logique de traçage et export.

│

└── 📌 MAIN (Non défini dans l’extrait)

🔧 Détail des fonctions principales

Fonction Paramètres Retour Rôle

generer_graphique_png data, titre, nom_fichier None Crée un graphique linéaire bleu avec marqueurs ronds et le sauvegarde en PNG.

🔄 LOGIQUE / ALGORITHME

ÉTAPE 1 → Réception du DataFrame Pandas.

ÉTAPE 2 → Initialisation d’une figure matplotlib (10×6).

ÉTAPE 3 → Tracé des points (valeur) en fonction de l’axe X (annee).

ÉTAPE 4 → Configuration esthétique (Titre, labels, grille).

ÉTAPE 5 → Exportation via savefig et fermeture de la figure pour libérer la mémoire.

🚨 GESTION DES ERREURS

Cas d’erreur Type d’exception Comportement attendu

Colonne manquante KeyError Le script s’arrête si ‘annee’ ou ‘valeur’ n’existe pas.

Données non DataFrame TypeError Erreur lors de l’accès aux index.

Permission écriture IOError Impossible de sauvegarder le PNG.

✅ CONTRAINTES & RÈGLES MÉTIER

Règle 1 : Le DataFrame doit impérativement contenir les clés ‘annee’ et ‘valeur’.

Règle 2 : L’export est fixé à une résolution de 300 DPI pour garantir la qualité d’impression.

Règle 3 : La figure est fermée (plt.close()) immédiatement après l’export pour éviter les fuites de mémoire en cas de génération massive.

🧪 TESTS ATTENDUS

# Cas de test Entrée Résultat attendu Statut

1 Cas nominal DF 5 lignes valides Fichier PNG généré correctement ⬜

2 Titre vide titre= » » Graphique généré sans titre ⬜

3 Caractères spéciaux nom_fichier= »graphe/1″ Erreur de chemin système (selon OS) ⬜

📝 EXEMPLE D’UTILISATION

💻 Exemple d’appel en tant que module

Python

import pandas as pd

from onizuka_9mu522k21sxsmqer_333 import generer_graphique_png

# Préparation des données

df = pd.DataFrame({

‘annee’: [2020, 2021, 2022],

‘valeur’: [10, 25, 18]

})

# Appel de la fonction

generer_graphique_png(df, « Rapport Annuel », « export_stats »)