deepseek_python_20260320_f3c2e2.py

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script deepseek_python_20260320_f3c2e2.py

Version 1.0.0

Date de création 20/03/2026

Auteur / Demandeur IA Générée (pour Meunier)

Objectif principal Automatiser les calculs de masse molaire, de concentration et de rendement pour des analyses chimiques et exporter les résultats en CSV.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Ce script est un outil de laboratoire permettant de traiter une liste de composés chimiques. Il parse les formules moléculaires pour calculer leur masse molaire, détermine la concentration molaire en fonction d’un volume donné, simule des données de rendement expérimental et génère un rapport final structuré.

📌 Problème résolu

Il élimine les erreurs de calcul manuel des masses atomiques et centralise les données d’analyse (théoriques vs expérimentales) dans un format d’export standardisé pour un suivi en laboratoire.

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.x

OS cible Tous (Cross-platform)

Mode d’exécution CLI (Ligne de commande)

📦 Dépendances / Librairies

Librairies standard (built-in) :

csv : Exportation des données.

os : Gestion des chemins (importée mais non utilisée directement).

datetime : Horodatage des analyses et des fichiers.

random : Simulation de variations pour le rendement.

📥 ENTRÉES (INPUTS)

📂 Fichiers / Sources de données en entrée

Type Chemin / Format Description

Dictionnaires Interne au script Liste composes contenant le nom, la formule et la quantité (g) de chaque substance.

📤 SORTIES (OUTPUTS)

📂 Fichiers / Données en sortie

Type Chemin / Format Description

CSV meunier_analyses_YYYYMMDD_HHMMSS.csv Fichier avec séparateur ; contenant l’intégralité des calculs.

Console Flux texte (STDOUT) Tableau récapitulatif formaté pour une lecture rapide.

🧱 STRUCTURE DU SCRIPT

Plaintext

deepseek_python_20260320_f3c2e2.py

│

├── 📌 IMPORTS (csv, os, datetime, random)

├── 📌 FONCTIONS DE CALCUL

│ ├── calculer_masse_molaire() → Parsing de formule et somme atomique

│ ├── calculer_concentration() → Calcul n = m/M puis C = n/V

│ └── calculer_rendement() → Ratio masse exp / masse théo

├── 📌 GÉNÉRATION DE DONNÉES

│ └── generer_donnees_meunier() → Préparation du jeu d’essai

├── 📌 EXPORT

│ └── exporter_csv() → Écriture physique du fichier

└── 📌 MAIN (Point d’entrée)

└── Affichage console et orchestration

🔧 DÉTAIL DES FONCTIONS PRINCIPALES

Fonction Paramètres Retour Rôle

calculer_masse_molaire formule: str float Décompose « H2O » en (2xH + 1xO) via un dictionnaire de masses atomiques.

calculer_concentration masse, vol, m_molaire float Calcule la molarité (mol/L).

calculer_rendement m_theo, m_exp float Calcule le % de succès de la réaction.

exporter_csv donnees, nom_fichier bool Sérialise la liste de dictionnaires vers un fichier .csv.

🔄 LOGIQUE / ALGORITHME

Initialisation : Chargement de la base de données des masses atomiques.

Itération : Pour chaque composé dans la liste :

Analyse de la chaîne de caractères (Regex simplifié) pour identifier les éléments et leurs indices.

Calcul de la masse molaire M=∑(ni​×Mi​).

Calcul de la concentration C=M×Vm​.

Simulation : Génération d’une masse théorique aléatoire (entre 3% et 15% supérieure à la masse réelle) pour simuler un rendement.

Export : Création d’un fichier CSV horodaté.

🚨 GESTION DES ERREURS

Éléments inconnus : Si un symbole chimique n’est pas dans le dictionnaire, un message d’alerte s’affiche et la masse est ignorée (0).

Division par zéro : Sécurité dans calculer_concentration et calculer_rendement (retourne 0 si le volume ou la masse théorique est ≤0).

Export : Bloc try/except autour de l’écriture de fichier pour capturer les erreurs de droits d’accès.

✅ RÈGLES MÉTIER

Précision : Les masses molaires sont arrondies à 3 décimales, les concentrations à 6.

Formatage : Le fichier CSV utilise le point-virgule (;) comme séparateur, compatible avec Excel (FR).

Reproductibilité : Utilisation de random.seed(42) pour que les rendements simulés soient identiques à chaque exécution.

📝 EXEMPLE D’UTILISATION

▶️ Lancement en ligne de commande

Bash

python deepseek_python_20260320_f3c2e2.py

📋 Exemple de sortie attendue (Console)

Plaintext

============================================================

SCRIPT DE CHIMIE POUR MEUNIER

============================================================

…

Composé Formule Masse molaire Concentration Rendement

——————————————————————————–

Eau H2O 18.015 g/mol 1.165695 M 95.24 %

Glucose C6H12O6 180.156 g/mol 0.277537 M 89.29 %

…

✅ Fichier CSV exporté avec succès : meunier_analyses_20260325_1015.csv