Catalogue des modules GFM
Ce catalogue documenté tous les Gap Filling Modules disponibles dans le moteur EOS. Chaque module comble des lacunes de données spécifiques dans les calculs d'incidence environnementale.
Les numéros de version correspondent à la version EOS dans laquelle chaque module a été mis à jour pour la dernière fois. Par exemple, v0.5.328 signifie que le module a été modifié pour la dernière fois dans la version EOS v0.5.328.
Vue d'ensemble des modules
EOS comprend 28 modules organisés en catégories fonctionnelles :
Construction du graphe
Ces modules construisent et gèrent la structure du graphe de calcul.
add_client_nodes_gfm
Charge les noeuds enfants des recettes, sous-recettes et ingrédients dans le graphe de calcul.
ModeledActivityNode, ElementaryResourceEmissionNodemerge_linked_nodes_gfm
Fusionne les noeuds de flux liés qui referencent le même produit en un seul noeud.
FlowNodes avec parent LinkingActivityNodeadd_client_nodes_gfmingrédient_splitter_gfm
Divise la liste d'ingrédients d'un produit en noeuds séparés pour une évaluation individuelle. Particulierement utile pour les aliments transformés ou les plats dont la composition exacte n'est pas fournie.
FlowNode séparé par ingrédientinventory_connector_gfm
Connecte les produits alimentaires aux données d'Inventaire du Cycle de Vie provenant de bases de données comme Agribalyse et ecoinvent. Utilise un cache agrege pour les noeuds système afin d'optimiser les performances.
ModeledActivityNode, FlowNodeCorrespondance des produits
Ces modules font correspondre les noms de produits aux termes standardisés de la base de données.
match_product_name_gfm
Fait correspondre les noms de produits aux termes FoodEx2 de la base de données du glossaire contenant plus de 565 000 produits de consommation.
FoodProductFlowNodeSortie : Termes ("A1791", "J0116") = "CAROTTE" + "DÉSHYDRATÉ OU SECHE"
attach_food_tags_gfm
Attache des étiquettes de classification alimentaire aux produits en fonction des termes FoodEx2 correspondants.
FoodProductFlowNodematch_product_name_gfmlink_food_catégories_gfm
Lie les termes alimentaires correspondants aux classifications de catégories alimentaires.
FoodProductFlowNode (pas les subdivisions)match_product_name_gfmlink_term_to_activity_node_gfm
Lie les termes de produits aux processus d'activité ACV dans la base de données. Recherche dans le glossary_link les connexions entre les termes correspondants et les processus ACV.
FoodProductFlowNode, PracticeFlowNodematch_product_name_gfmAnalyse des ingrédients
Ces modules analysent et estiment les quantités d'ingrédients.
ingrédient_amount_estimator_gfm
Estime les quantités d'ingrédients lorsque seule une liste d'ingrédients est disponible sans quantités. Utilise l'optimisation convexe (CVXPY) pour faire correspondre la nutrition déclarée du produit avec les compositions des ingrédients.
nutrient_subdivision_gfm
Subdivise les ingrédients en variantes basées sur les nutriments pour une correspondance plus précise.
FoodProductFlowNode sans sous-noeudsSortie : "poudre de cacao maigre" + "poudre de cacao grasse"
unit_weight_conversion_gfm
Convertit les quantités de produits en unités de poids standardisées. Gère les unités de poids, volume en poids, unités spécifiques aux aliments et articles comptes.
FoodProductFlowNode, FlowNodeLocalisation et origine
Ces modules déterminent l'origine géographique et les données de localisation.
origin_gfm
Determine l'origine géographique des produits alimentaires à l'aide des données commerciales de la FAO. Lorsque l'origine n'est pas fournie, utilisé les statistiques d'importation de la FAO pour estimer le pays source le plus probable.
FoodProductFlowNodeSortie : { origin: "CH", originConfidence: 0.9, originBasis: "name_analysis" }
location_gfm
Gère les données de localisation géographique détaillées, y compris les coordonnées et les régions. S'intègre aux bases de données géographiques pour des informations de localisation standardisées.
FoodProductFlowNodeorigin_gfmTransport
Ces modules calculent les incidences du transport.
transportation_décision_gfm
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 périssabilité du produit et l'infrastructure disponible.
location_gfm, perishability_gfmtransportation_mode_distance_gfm
Calcule les distances de transport et les émissions spécifiques aux itinéraires à l'aide de l'API EcoTransit. Modélise les itinéraires de transport complets, y compris route-port, port-port et exigences de réfrigération.
FlowNode depuis FoodProcessingActivityNodetransportation_décision_gfmTransformation et conservation
Ces modules modelisent la transformation alimentaire, les méthodes de production et les incidences du stockage.
greenhouse_gfm
Estime les émissions de la culture sous serre chauffée. La production sous serre peut augmenter l'incidence climatique jusqu'à 10 fois par rapport aux équivalents cultives en plein champ en raison des besoins énergétiques de chauffage.
ModeledActivityNode avec parent legumeTomate espagnole de plein champ (aout) : 0,2 kg CO₂éq/kg
processing_gfm
Modélise les étapes de transformation alimentaire et leur incidence environnementale. Gère à la fois les modèles de transformation complexes (création de nouveaux Inventaires de Cycle de Vie) et les modèles de transformation simples (bases sur le poids).
FoodProductFlowNodematch_product_name_gfmconservation_gfm
Modélise les exigences de stockage, la chaîne du froid et les incidences de la conservation. Analyse les méthodes de conservation, y compris la mise en conserve, la congélation, le séchage et la fermentation.
FoodProductFlowNode (pas les subdivisions)location_gfmperishability_gfm
Calcule les facteurs de perte et de gaspillage alimentaire en fonction de la périssabilité du produit. Estime la durée de conservation, l'énergie de réfrigération pendant le transport et le gaspillage alimentaire du à la deterioration.
add_client_nodes_gfmCalcul de l'incidence
Ces modules calculent les métriques d'incidence environnementale.
water_scarcity_gfm
Calcule l'empreinte de rareté en eau en fonction de l'origine et des facteurs régionaux de stress hydrique. Utilise les facteurs de l'Indice de Stress Hydrique (WSI) pour ponderer la consommation d'eau bleue par la rareté régionale de l'eau.
ModeledActivityNode avec parent FoodProductFlowNodeorigin_gfmTomates des Pays-Bas : 12,8 L d'eau rare/kg
rainforest_gfm
Evalue le risque de déforestation et l'incidence sur les forêts tropicales pour les matières premières concernees.
ModeledActivityNode avec parent FoodProductFlowNodeimpact_assessment_gfm
Effectue l'Évaluation de l'Incidence du Cycle de Vie selon la méthodologie du GIEC. Calcule les équivalents CO₂ pour chaque noeud de production en utilisant l'évaluation d'incidence du changement climatique GIEC 2013.
ActivityNode (transformation, modélise, fiche d'approvisionnement)matrix_calculation_gfm
Effectue des calculs ACV bases sur des matrices pour des systèmes de produits complexes. Composant de performance critique pour l'agrégation matricielle dans les graphes complexes.
Nutrition et notation
Ces modules calculent les métriques de santé et de nutrition.
vitascore_gfm
Calcule le score de santé nutritionnelle base sur les facteurs de risque de l'étude Global Burden of Disease.
FoodProductFlowNodeaggregation_gfm, daily_food_unit_gfmdaily_food_unit_gfm
Calcule la contribution en unité alimentaire journaliere à partir des valeurs nutritionnelles agrégées.
FoodProductFlowNode (pas les subdivisions)aggregation_gfmAgrégation
Ces modules combinent les résultats entre ingrédients.
aggregation_gfm
Agrege les données de tous les ingrédients au niveau du produit. Agrege les valeurs nutritionnelles, les quantités par catégorie, les produits critiques pour les forêts tropicales et les produits animaux.
matrix_calculation_gfmpost_nutrients_aggregation_gfm
Effectue l'agrégation post-calcul après l'évaluation de l'incidence.
impact_assessment_gfm, daily_food_unit_gfmreport_aggregation_gfm
Agrege les résultats de calcul à des fins de rapport. Prepare les structures de données de sortie finales pour les réponses API et les exports.
aggregation_gfm, post_nutrients_aggregation_gfmDépendances des modules
Le flux d'exécution typique suit ce patron de dépendances :
Pourquoi les GFM sont importants
- Efficacité - Automatisent les taches de saisie de données repetitives, rendant EOS evolutif pour des milliers de produits
- Précision - Exploitent des modèles statistiques, des recettes standard et des données commerciales pour augmenter la fiabilité
- Standardisation - Harmonisent les données de sources variees en formats cohérents
- Adaptabilite - Mettent a jour les modules indépendamment a mesure que de nouvelles données ou méthodologies emergent
Prochaines étapes
- Fonctionnement des GFM - Mécanismes internes
- SDK GFM (bientot disponible) - Construire des modules personnalisés