Catalogue des modules GFM

Ce catalogue documente tous les Gap Filling Modules disponibles dans le moteur EOS. Chaque module comble des lacunes de donnees specifiques dans les calculs d'incidence environnementale.

Versionnement des modules

Les numeros de version correspondent a la version EOS dans laquelle chaque module a ete mis a jour pour la derniere fois. Par exemple, v0.5.328 signifie que le module a ete modifie pour la derniere fois dans la version EOS v0.5.328.

Vue d'ensemble des modules

EOS comprend 28 modules organises en categories fonctionnelles :

Construction du graphe

Construire et gerer le graphe de calcul

Correspondance des produits

Faire correspondre les produits aux termes de la base de donnees

Analyse des ingredients

Estimer et traiter les donnees d'ingredients

Localisation et origine

Determiner les donnees geographiques

Transport

Calculer les incidences du transport

Transformation et conservation

Modeliser la transformation et le stockage des aliments

Calcul de l'incidence

Calculer les metriques environnementales

Nutrition et notation

Calculer les scores de sante et de nutrition

Agregation

Combiner les resultats entre ingredients

🔗

Construction du graphe

Ces modules construisent et gerent la structure du graphe de calcul.

`add_client_nodes_gfm`

v0.5.306Equipe centrale

Charge les noeuds enfants des recettes, sous-recettes et ingredients dans le graphe de calcul.

S'execute surEnfant direct du noeud racine

IgnoreModeledActivityNode, ElementaryResourceEmissionNode

CreeNoeuds de flux enfants pour tous les ingredients

`merge_linked_nodes_gfm`

v0.5.298Equipe centrale

Fusionne les noeuds de flux lies qui referencent le meme produit en un seul noeud.

S'execute surFlowNodes avec parent LinkingActivityNode

Dependancesadd_client_nodes_gfm

SortieNoeud de flux consolide

`ingredient_splitter_gfm`

v0.5.313Equipe centrale

Divise la liste d'ingredients d'un produit en noeuds separes pour une evaluation individuelle. Particulierement utile pour les aliments transformes ou les plats dont la composition exacte n'est pas fournie.

S'execute surNoeuds avec listes d'ingredients

CreeFlowNode separe par ingredient

PermetCalculs individuels par ingredient

`inventory_connector_gfm`

v0.5.298Equipe centrale

Connecte les produits alimentaires aux donnees d'Inventaire du Cycle de Vie provenant de bases de donnees comme Agribalyse et ecoinvent. Utilise un cache agrege pour les noeuds systeme afin d'optimiser les performances.

S'execute surModeledActivityNode, FlowNode

Sources de donneesAgribalyse, ecoinvent, Brightway

OptimiseUtilise le cache pour les grands inventaires

🏷️

Correspondance des produits

Ces modules font correspondre les noms de produits aux termes standardises de la base de donnees.

`match_product_name_gfm`

v0.5.309Equipe centrale

Fait correspondre les noms de produits aux termes FoodEx2 de la base de donnees du glossaire contenant plus de 565 000 produits de consommation.

S'execute surFoodProductFlowNode

EntreeNom du produit brut

SortieTermes FoodEx2 correspondants

Base de donnees565 000+ produits

Exemple

Entree : "trockene Karotten" (carottes sechees)
Sortie : Termes ("A1791", "J0116") = "CAROTTE" + "DESHYDRATE OU SECHE"

`attach_food_tags_gfm`

v0.5.328Equipe centrale

Attache des etiquettes de classification alimentaire aux produits en fonction des termes FoodEx2 correspondants.

S'execute surFoodProductFlowNode

Dependancesmatch_product_name_gfm

SortieEtiquettes de classification alimentaire

`link_food_categories_gfm`

v0.5.328Equipe centrale

Lie les termes alimentaires correspondants aux classifications de categories alimentaires.

S'execute surFoodProductFlowNode (pas les subdivisions)

Dependancesmatch_product_name_gfm

SortieAttributions de categories

`link_term_to_activity_node_gfm`

v0.5.298Equipe centrale

Lie les termes de produits aux processus d'activite ACV dans la base de donnees. Recherche dans le glossary_link les connexions entre les termes correspondants et les processus ACV.

S'execute surFoodProductFlowNode, PracticeFlowNode

Dependancesmatch_product_name_gfm

SortieNoeud d'activite ACV connecte

🧪

Analyse des ingredients

Ces modules analysent et estiment les quantites d'ingredients.

`ingredient_amount_estimator_gfm`

v0.5.306Equipe scientifique

Estime les quantites d'ingredients lorsque seule une liste d'ingredients est disponible sans quantites. Utilise l'optimisation convexe (CVXPY) pour faire correspondre la nutrition declaree du produit avec les compositions des ingredients.

S'execute surProduits avec listes d'ingredients

MethodeOptimisation convexe (CVXPY)

EntreeNutriments du produit, profils des ingredients

SortiePourcentages d'ingredients estimes

`nutrient_subdivision_gfm`

v0.5.328Equipe scientifique

Subdivise les ingredients en variantes basees sur les nutriments pour une correspondance plus precise.

S'execute surFoodProductFlowNode sans sous-noeuds

ObjectifPermettre une estimation plus precise des ingredients

SortieNoeuds de variantes de subdivision

Exemple

Entree : "poudre de cacao"
Sortie : "poudre de cacao maigre" + "poudre de cacao grasse"

`unit_weight_conversion_gfm`

v0.5.328Equipe centrale

Convertit les quantites de produits en unites de poids standardisees. Gere les unites de poids, volume en poids, unites specifiques aux aliments et articles comptes.

S'execute surNoeud racine, FoodProductFlowNode, FlowNode

ConvertitDiverses unites en grammes/kilogrammes

SortieQuantites de poids standardisees

🌍

Localisation et origine

Ces modules determinent l'origine geographique et les donnees de localisation.

`origin_gfm`

v0.5.328Equipe scientifique

Determine l'origine geographique des produits alimentaires a l'aide des donnees commerciales de la FAO. Lorsque l'origine n'est pas fournie, utilise les statistiques d'importation de la FAO pour estimer le pays source le plus probable.

S'execute surFoodProductFlowNode

Source de donneesStatistiques commerciales de la FAO

MethodesAnalyse du nom, valeurs par defaut de categorie, modeles commerciaux

SortieCode pays, confiance, base de l'origine

Exemple

Entree : { name: "Fromage suisse", category: "dairy.cheese" }
Sortie : { origin: "CH", originConfidence: 0.9, originBasis: "name_analysis" }

`location_gfm`

v0.5.331Equipe centrale

Gere les donnees de localisation geographique detaillees, y compris les coordonnees et les regions. S'integre aux bases de donnees geographiques pour des informations de localisation standardisees.

S'execute surFoodProductFlowNode

Dependancesorigin_gfm

SortieDetails de localisation, coordonnees, region

🚛

Transport

Ces modules calculent les incidences du transport.

`transportation_decision_gfm`

v0.5.328Equipe scientifique

Determine le mode de transport optimal (route, rail, mer, air) en fonction du cout, de la distance et des exigences du produit. Prend en compte la perissabilite du produit et l'infrastructure disponible.

S'execute surNoeuds avec attribut de transport

Dependanceslocation_gfm, perishability_gfm

IgnoreNoeuds avec mode de transport deja specifie

SortieMode de transport viable le moins cher

`transportation_mode_distance_gfm`

v0.5.328Equipe scientifique

Calcule les distances de transport et les emissions specifiques aux itineraires a l'aide de l'API EcoTransit. Modelise les itineraires de transport complets, y compris route-port, port-port et exigences de refrigeration.

S'execute surFlowNode depuis FoodProcessingActivityNode

Dependancestransportation_decision_gfm

APIEcoTransit

SortieDistance, segments d'itineraire, emissions

⚙️

Transformation et conservation

Ces modules modelisent la transformation alimentaire, les methodes de production et les incidences du stockage.

`greenhouse_gfm`

v0.5.328L. Eymann

Estime les emissions de la culture sous serre chauffee. La production sous serre peut augmenter l'incidence climatique jusqu'a 10 fois par rapport aux equivalents cultives en plein champ en raison des besoins energetiques de chauffage.

S'execute surModeledActivityNode avec parent legume

Couverture7 legumes, 28 pays europeens

SortieEmissions de chauffage, infrastructure, electricite

Comparaison d'incidence

Tomate de serre chauffee neerlandaise (fevrier) : 2,9 kg CO₂eq/kg
Tomate espagnole de plein champ (aout) : 0,2 kg CO₂eq/kg

`processing_gfm`

v0.5.331Equipe scientifique

Modelise les etapes de transformation alimentaire et leur incidence environnementale. Gere a la fois les modeles de transformation complexes (creation de nouveaux Inventaires de Cycle de Vie) et les modeles de transformation simples (bases sur le poids).

S'execute surFoodProductFlowNode

Dependancesmatch_product_name_gfm

SortieEnergie de transformation, emissions

`conservation_gfm`

v0.5.178Equipe scientifique

Modelise les exigences de stockage, la chaine du froid et les incidences de la conservation. Analyse les methodes de conservation, y compris la mise en conserve, la congelation, le sechage et la fermentation.

S'execute surFoodProductFlowNode (pas les subdivisions)

Dependanceslocation_gfm

SortieType de stockage, duree, emissions

`perishability_gfm`

v0.5.298Equipe scientifique

Calcule les facteurs de perte et de gaspillage alimentaire en fonction de la perissabilite du produit. Estime la duree de conservation, l'energie de refrigeration pendant le transport et le gaspillage alimentaire du a la deterioration.

S'execute surNoeud racine uniquement

Dependancesadd_client_nodes_gfm

SortieFacteurs de gaspillage, exigences de chaine du froid

📊

Calcul de l'incidence

Ces modules calculent les metriques d'incidence environnementale.

`water_scarcity_gfm`

v0.5.298Equipe scientifique

Calcule l'empreinte de rarete en eau en fonction de l'origine et des facteurs regionaux de stress hydrique. Utilise les facteurs de l'Indice de Stress Hydrique (WSI) pour ponderer la consommation d'eau bleue par la rarete regionale de l'eau.

S'execute surModeledActivityNode avec parent FoodProductFlowNode

Dependancesorigin_gfm

Couverture162 pays

SortieConsommation d'eau rare (m3)

Comparaison d'incidence

Tomates du Maroc : 285,6 L d'eau rare/kg
Tomates des Pays-Bas : 12,8 L d'eau rare/kg

`rainforest_gfm`

v0.5.328Equipe scientifique

Evalue le risque de deforestation et l'incidence sur les forets tropicales pour les matieres premieres concernees.

S'execute surModeledActivityNode avec parent FoodProductFlowNode

FocusSoja, huile de palme, cacao, cafe, boeuf

SortieScore de risque foret tropicale, incidence de deforestation

`impact_assessment_gfm`

v0.5.298Equipe centrale

Effectue l'Evaluation de l'Incidence du Cycle de Vie selon la methodologie du GIEC. Calcule les equivalents CO₂ pour chaque noeud de production en utilisant l'evaluation d'incidence du changement climatique GIEC 2013.

S'execute surActivityNode (transformation, modelise, fiche d'approvisionnement)

MethodologieGIEC 2013 GWP100a

SortieScores d'incidence agreges (kg CO₂eq)

`matrix_calculation_gfm`

v0.5.306Equipe centrale

Effectue des calculs ACV bases sur des matrices pour des systemes de produits complexes. Composant de performance critique pour l'agregation matricielle dans les graphes complexes.

S'execute surGraphes de produits complexes

MethodeInversion matricielle pour l'ACV

SortieFlux et incidences calcules

🥗

Nutrition et notation

Ces modules calculent les metriques de sante et de nutrition.

`vitascore_gfm`

v0.5.298Equipe scientifique

Calcule le score de sante nutritionnelle base sur les facteurs de risque de l'etude Global Burden of Disease.

S'execute surFoodProductFlowNode

Dependancesaggregation_gfm, daily_food_unit_gfm

SortieNote de sante VitaScore

`daily_food_unit_gfm`

v0.5.298Equipe scientifique

Calcule la contribution en unite alimentaire journaliere a partir des valeurs nutritionnelles agregees.

S'execute surFoodProductFlowNode (pas les subdivisions)

Dependancesaggregation_gfm

SortieContribution en unite alimentaire journaliere

📦

Agregation

Ces modules combinent les resultats entre ingredients.

`aggregation_gfm`

v0.5.100Equipe centrale

Agrege les donnees de tous les ingredients au niveau du produit. Agrege les valeurs nutritionnelles, les quantites par categorie, les produits critiques pour les forets tropicales et les produits animaux.

S'execute surNoeuds de produit avec ingredients

Dependancesmatrix_calculation_gfm

SortieDonnees agregees de nutriments, categories et incidences

`post_nutrients_aggregation_gfm`

v0.5.305Equipe centrale

Effectue l'agregation post-calcul apres l'evaluation de l'incidence.

S'execute surNoeuds de produit

Dependancesimpact_assessment_gfm, daily_food_unit_gfm

SortieResultats finaux agreges

`report_aggregation_gfm`

v0.5.323Equipe centrale

Agrege les resultats de calcul a des fins de rapport. Prepare les structures de donnees de sortie finales pour les reponses API et les exports.

S'execute surNoeud racine

Dependancesaggregation_gfm, post_nutrients_aggregation_gfm

SortieDonnees agregees pretes pour le rapport

Dependances des modules

Le flux d'execution typique suit ce patron de dependances :

dfac831fc088723476fa35ca8f8ec3b1

Pourquoi les GFM sont importants

Efficacite - Automatisent les taches de saisie de donnees repetitives, rendant EOS evolutif pour des milliers de produits
Precision - Exploitent des modeles statistiques, des recettes standard et des donnees commerciales pour augmenter la fiabilite
Standardisation - Harmonisent les donnees de sources variees en formats coherents
Adaptabilite - Mettent a jour les modules independamment a mesure que de nouvelles donnees ou methodologies emergent

Prochaines etapes

Fonctionnement des GFM - Mecanismes internes
SDK GFM (bientot disponible) - Construire des modules personnalises

Vue d'ensemble des modules​

Construction du graphe

add_client_nodes_gfm

merge_linked_nodes_gfm

ingredient_splitter_gfm

inventory_connector_gfm

Correspondance des produits

match_product_name_gfm

attach_food_tags_gfm

link_food_categories_gfm

link_term_to_activity_node_gfm

Analyse des ingredients

ingredient_amount_estimator_gfm

nutrient_subdivision_gfm

unit_weight_conversion_gfm

Localisation et origine

origin_gfm

location_gfm

Transport

transportation_decision_gfm

transportation_mode_distance_gfm

Transformation et conservation

greenhouse_gfm

processing_gfm

conservation_gfm

perishability_gfm

Calcul de l'incidence

water_scarcity_gfm

rainforest_gfm

impact_assessment_gfm

matrix_calculation_gfm

Nutrition et notation

vitascore_gfm

daily_food_unit_gfm

Agregation

aggregation_gfm

post_nutrients_aggregation_gfm

report_aggregation_gfm

Dependances des modules​

Pourquoi les GFM sont importants​

Prochaines etapes​

Vue d'ensemble des modules

`add_client_nodes_gfm`

`merge_linked_nodes_gfm`

`ingredient_splitter_gfm`

`inventory_connector_gfm`

`match_product_name_gfm`

`attach_food_tags_gfm`

`link_food_categories_gfm`

`link_term_to_activity_node_gfm`

`ingredient_amount_estimator_gfm`

`nutrient_subdivision_gfm`

`unit_weight_conversion_gfm`

`origin_gfm`

`location_gfm`

`transportation_decision_gfm`

`transportation_mode_distance_gfm`

`greenhouse_gfm`

`processing_gfm`

`conservation_gfm`

`perishability_gfm`

`water_scarcity_gfm`

`rainforest_gfm`

`impact_assessment_gfm`

`matrix_calculation_gfm`

`vitascore_gfm`

`daily_food_unit_gfm`

`aggregation_gfm`

`post_nutrients_aggregation_gfm`

`report_aggregation_gfm`

Dependances des modules

Pourquoi les GFM sont importants

Prochaines etapes