Catálogo de GFM Modules
Este catálogo documenta todos los Gap Filling Modules disponibles en el Motor EOS. Cada módulo rellena vacíos de datos específicos en los cálculos de impacto ambiental.
Los números de versión corresponden a la etiqueta de lanzamiento de EOS en la que cada módulo fue actualizado por última vez. Por ejemplo, v0.5.328 significa que el módulo fue modificado por última vez en la versión de EOS v0.5.328.
Visión General de Módulos
EOS incluye 28 módulos organizados en categorías funcionales:
Construcción del Grafo
Estos módulos construyen y gestionan la estructura del grafo de cálculo.
add_client_nodes_gfm
Carga nodos hijos de recetas, subrecetas e ingredientes en el grafo de cálculo.
ModeledActivityNode, ElementaryResourceEmissionNodemerge_linked_nodes_gfm
Fusiona nodos de flujo enlazados que hacen referencia al mismo producto en un único nodo.
FlowNodes con padre LinkingActivityNodeadd_client_nodes_gfmingredient_splitter_gfm
Divide la lista de ingredientes de un producto en nodos separados para evaluación individual. Particularmente útil para alimentos procesados o platos donde no se proporciona la composición exacta.
FlowNode separado por ingredienteinventory_connector_gfm
Conecta productos alimentarios con datos de Inventario de Ciclo de Vida de bases de datos como Agribalyse y ecoinvent. Utiliza una caché agregada para nodos del sistema para optimizar el rendimiento.
ModeledActivityNode, FlowNodeCoincidencia de Productos
Estos módulos coinciden nombres de productos con términos estandarizados de base de datos.
match_product_name_gfm
Coincide nombres de productos con términos FoodEx2 de la base de datos de glosario que contiene más de 565.000 productos de conveniencia.
FoodProductFlowNodeSalida: Términos ("A1791", "J0116") = "ZANAHORIA" + "DESHIDRATADO O SECO"
attach_food_tags_gfm
Adjunta etiquetas de clasificación de alimentos a los productos basándose en los términos FoodEx2 coincidentes.
FoodProductFlowNodematch_product_name_gfmlink_food_categories_gfm
Enlaza los términos de alimentos coincidentes con clasificaciones de categorías de alimentos.
FoodProductFlowNode (no subdivisión)match_product_name_gfmlink_term_to_activity_node_gfm
Enlaza términos de producto con procesos de actividad de ACV en la base de datos. Busca en glossary_link conexiones entre términos coincidentes y procesos de ACV.
FoodProductFlowNode, PracticeFlowNodematch_product_name_gfmAnálisis de Ingredientes
Estos módulos analizan y estiman cantidades de ingredientes.
ingredient_amount_estimator_gfm
Estima cantidades de ingredientes cuando solo está disponible una lista de ingredientes sin cantidades. Utiliza optimización convexa (CVXPY) para coincidir la nutrición declarada del producto con las composiciones de ingredientes.
nutrient_subdivision_gfm
Subdivide ingredientes en variantes basadas en nutrientes para coincidencia más precisa.
FoodProductFlowNode sin subnodosSalida: "cacao en polvo bajo en grasa" + "cacao en polvo alto en grasa"
unit_weight_conversion_gfm
Convierte cantidades de productos a unidades de peso estandarizadas. Maneja unidades de peso, volumen a peso, unidades específicas de alimentos y artículos basados en conteo.
FoodProductFlowNode, FlowNodeUbicación y Origen
Estos módulos determinan el origen geográfico y datos de ubicación.
origin_gfm
Determina el origen geográfico de productos alimentarios usando datos comerciales de la FAO. Cuando no se proporciona el origen, utiliza estadísticas de importación de la FAO para estimar el país de origen más probable.
FoodProductFlowNodeSalida: { origin: "CH", originConfidence: 0.9, originBasis: "name_analysis" }
location_gfm
Maneja datos de ubicación geográfica detallados incluyendo coordenadas y regiones. Se integra con bases de datos geográficas para información de ubicación estandarizada.
FoodProductFlowNodeorigin_gfmTransporte
Estos módulos calculan impactos de transporte.
transportation_decision_gfm
Determina el modo de transporte óptimo (carretera, ferrocarril, marítimo, aéreo) basándose en coste, distancia y requisitos del producto. Considera la perecibilidad del producto y la infraestructura disponible.
location_gfm, perishability_gfmtransportation_mode_distance_gfm
Calcula distancias de transporte y emisiones específicas de ruta utilizando la API de EcoTransit. Modela rutas de transporte completas incluyendo carretera a puerto, puerto a puerto y requisitos de refrigeración.
FlowNode desde FoodProcessingActivityNodetransportation_decision_gfmProcesamiento y Conservación
Estos módulos modelan el procesamiento de alimentos, métodos de producción e impactos de almacenamiento.
greenhouse_gfm
Estima emisiones del cultivo en invernadero con calefacción. La producción en invernadero puede aumentar el impacto climático hasta 10 veces en comparación con equivalentes cultivados en campo debido a los requisitos de energía de calefacción.
ModeledActivityNode con padre vegetalTomate cultivado en campo español (agosto): 0,2 kg CO₂eq/kg
processing_gfm
Modela pasos de procesamiento de alimentos y su impacto ambiental. Maneja tanto modelos de procesamiento complejos (creando nuevos Inventarios de Ciclo de Vida) como modelos de procesamiento simples (basados en peso).
FoodProductFlowNodematch_product_name_gfmconservation_gfm
Modela requisitos de almacenamiento, cadena de frío e impactos de preservación. Analiza métodos de preservación incluyendo enlatado, congelación, secado y fermentación.
FoodProductFlowNode (no subdivisión)location_gfmperishability_gfm
Calcula factores de pérdida y desperdicio de alimentos basándose en la perecibilidad del producto. Estima vida útil, energía de refrigeración durante el transporte y desperdicio de alimentos debido al deterioro.
add_client_nodes_gfmCálculo de Impacto
Estos módulos calculan métricas de impacto ambiental.
water_scarcity_gfm
Calcula la huella de escasez de agua basándose en el origen y factores regionales de estrés hídrico. Utiliza factores de Índice de Estrés Hídrico (WSI) para ponderar el consumo de agua azul por escasez hídrica regional.
ModeledActivityNode con padre FoodProductFlowNodeorigin_gfmTomates de Países Bajos: 12,8 L de agua escasa/kg
rainforest_gfm
Evalúa el riesgo de deforestación e impacto en la selva tropical para materias primas relevantes.
ModeledActivityNode con padre FoodProductFlowNodeimpact_assessment_gfm
Calcula la Evaluación de Impacto de Ciclo de Vida utilizando metodología del IPCC. Calcula equivalentes de CO₂ para cada nodo de producción utilizando la evaluación de impacto de cambio climático IPCC 2013.
ActivityNode (procesamiento, modelado, hoja de suministro)matrix_calculation_gfm
Realiza cálculos de ACV basados en matrices para sistemas de productos complejos. Un componente crítico de rendimiento para agregación matricial en grafos complejos.
Nutrición y Puntuación
Estos módulos calculan métricas de salud y nutrición.
vitascore_gfm
Calcula la puntuación de salud nutricional basándose en factores de riesgo del estudio Global Burden of Disease.
FoodProductFlowNodeaggregation_gfm, daily_food_unit_gfmdaily_food_unit_gfm
Calcula la contribución de unidad alimentaria diaria a partir de valores nutricionales agregados.
FoodProductFlowNode (no subdivisión)aggregation_gfmAgregación
Estos módulos combinan resultados entre ingredientes.
aggregation_gfm
Agrega datos de todos los ingredientes al nivel de producto. Agrega valores nutricionales, cantidades por categoría, productos críticos de selva tropical y productos animales.
matrix_calculation_gfmpost_nutrients_aggregation_gfm
Realiza agregación post-cálculo después de la evaluación de impacto.
impact_assessment_gfm, daily_food_unit_gfmreport_aggregation_gfm
Agrega resultados de cálculo para propósitos de informes. Prepara estructuras de datos de salida final para respuestas de API y exportaciones.
aggregation_gfm, post_nutrients_aggregation_gfmDependencias de Módulos
El flujo de ejecución típico sigue este patrón de dependencias:
Por qué Importan los GFMs
- Eficiencia - Automatizan tareas repetitivas de entrada de datos, haciendo EOS escalable a miles de productos
- Precisión - Aprovechan modelos estadísticos, recetas estándar y datos comerciales para aumentar la fiabilidad
- Estandarización - Armonizan datos de fuentes variadas en formatos consistentes
- Adaptabilidad - Actualizan módulos independientemente a medida que emergen nuevos datos o metodologías
Siguientes Pasos
- Cómo Funcionan los GFMs - Mecánicas internas
- GFM SDK (próximamente) - Construir módulos personalizados