vendredi, 24 avril, 2026
Volet moléculaire
Le volet moléculaire du module Géochimie couvre les 144 molécules organiques du catalogue, réparties en dix familles de micropolluants plus une famille marginale d'inorganiques (oxyanions). Cette page décrit le fonctionnement général du volet, la structure des données moléculaires dans un projet IsoFind et l'articulation entre les fiches de référence, les mesures par échantillon et les analyses avancées.
Navigation dans le volet
Chaque famille de molécules dispose de sa page dédiée qui détaille les composés, les seuils réglementaires, les voies de dégradation tabulées et les données de fractionnement isotopique disponibles. Les pages transversales couvrent l'isotopie CSIA, la base de référence et les voies de dégradation en général.
Pesticides (38)
Triazines, organophosphorés, néonicotinoïdes, chloroacétamides, phénylurées, organochlorés.
PFAS (26)
PFCA C2 à C12, PFSA C4 à C10, FTS, FOSA, Cl-PFAS, substituts nouvelle génération.
HAP et hydrocarbures (19)
16 HAP EPA prioritaires, HAP méthylés, ratios diagnostiques de source.
Solvants chlorés (16)
Éthylènes chlorés (PCE, TCE, DCE, VC), chlorobenzènes, méthanes et éthanes chlorés.
Isotopie CSIA
Compound-Specific Isotope Analysis : principes, epsilons tabulés, équation de Rayleigh, dual isotope.
Voies de dégradation
50 voies tabulées avec cinétique, métabolite primaire, conditions favorables, références.
Structure des mesures moléculaires
Les mesures moléculaires pour un échantillon sont stockées dans des tables dédiées accessibles via l'API /api/molecules/{sample_id}/mesures. Chaque mesure contient la valeur brute, l'unité d'origine, la valeur normalisée en µg/L, l'incertitude analytique et un indicateur de conformité calculé automatiquement à partir du seuil réglementaire.
| Champ de mesure | Contenu |
|---|---|
| molecule_id | Lien vers le catalogue de référence |
| valeur, unite | Valeur telle que rendue par le laboratoire |
| valeur_ug_l | Valeur normalisée en µg/L pour comparaison aux seuils |
| incertitude | Incertitude analytique en pourcentage ou valeur absolue |
| mz_mesure | Transition MS effectivement utilisée |
| detecte, conforme | Flags calculés : détection au-dessus de LOQ, respect du seuil |
| seuil_ref, unite_ref | Seuil de référence et son unité, capturés au moment de la mesure |
| methode, laboratoire | Méthode analytique et laboratoire émetteur |
| matrice, date_analyse | Matrice de l'échantillon, date de l'analyse |
Conformité automatique
IsoFind calcule automatiquement la conformité de chaque mesure par rapport au seuil réglementaire de la matrice eau. La normalisation en µg/L permet de comparer des mesures rendues en ng/L, mg/L ou pg/L avec les seuils usuels.
| Unité d'origine | Conversion vers µg/L |
|---|---|
| ng/L | × 0.001 |
| µg/L | × 1 (référence) |
| mg/L | × 1000 |
| pg/L | × 0.000001 |
Deux endpoints dédiés permettent de relancer le calcul de conformité à l'échelle globale ou pour une molécule donnée : POST /api/molecules/recalculer-conformite et POST /api/molecules/recalculer-conformite/{molecule_id}. Ces recalculs sont utiles après une mise à jour réglementaire (nouveau seuil EU) ou une correction de seuil dans le catalogue.
La conformité est un calcul simple (valeur vs seuil) mais elle dépend de la qualité des deux termes : mesure correctement normalisée en µg/L et seuil correctement renseigné dans le catalogue. Les blocs de rapport molecule_conformity et regulatory_compliance_forecast consomment ces résultats.
Saisie et import
Quatre voies existent pour saisir des mesures moléculaires dans un projet IsoFind.
| Voie | Usage |
|---|---|
| Saisie manuelle | Mesure unitaire via le formulaire de l'onglet Molécules |
| Import CSV ou Excel | Chargement en lot via le module d'import IsoFind |
| Batch API | POST /api/molecules/{sample_id}/mesures/batch pour intégration programmatique |
| Catalogue seed | Pré-remplissage depuis une famille de référence via POST /api/molecules/catalogue/seed/{famille} |
Statistiques
Deux endpoints retournent des statistiques agrégées pour alimenter les blocs de rapport et l'interface. Ces statistiques sont recalculées à la volée à chaque appel, sans cache, ce qui garantit leur fraîcheur.
| Endpoint | Contenu |
|---|---|
| GET /api/molecules/stats/global | Nombre de mesures, molécules distinctes, familles couvertes, taux de conformité |
| GET /api/molecules/stats/par-sample/{sample_id} | Statistiques détaillées pour un échantillon donné |
Suggestions isotopiques
Pour un échantillon donné, IsoFind peut suggérer quelles mesures isotopiques apporteraient le plus d'information compte tenu des molécules détectées. L'endpoint GET /api/molecules/ref-isotopes/suggest/{sample_id} retourne une liste ordonnée de suggestions avec leur rationnel : identification de source, diagnostic de dégradation, traçabilité de procédé.
Ces suggestions sont produites à partir de la table ref_molecules_isotopes qui associe molécules et éléments isotopiques pertinents avec leur interprétation typique. Elles alimentent le bloc de rapport molecule_suggestions.
Pour aller plus loin
- Pesticides : la famille la plus nombreuse du catalogue.
- PFAS : catalogue sommes 4 PFAS et 20 PFAS.
- Isotopie CSIA : passerelle avec le moteur Nexus.
- Base de référence : structure et enrichissement du catalogue.