Catalogo Moduli GFM
Questo catalogo documenta tutti i Gap Filling Module disponibili nel Motore EOS. Ogni modulo colma specifiche lacune nei dati dei calcoli di impatto ambientale.
I numeri di versione corrispondono al tag di rilascio EOS in cui ogni modulo e stato aggiornato per l'ultima volta. Ad esempio, v0.5.328 significa che il modulo e stato modificato per l'ultima volta nel rilascio EOS v0.5.328.
Panoramica Moduli
EOS include 28 moduli organizzati in categorie funzionali:
Costruzione Grafo
Questi moduli costruiscono e gestiscono la struttura del grafo di calcolo.
add_client_nodes_gfm
Carica i nodi figli di ricette, sotto-ricette e ingredienti nel grafo di calcolo.
ModeledActivityNode, ElementaryResourceEmissionNodemerge_linked_nodes_gfm
Unisce i Flow Node collegati che fanno riferimento allo stesso prodotto in un singolo nodo.
FlowNodes con genitore LinkingActivityNodeadd_client_nodes_gfmingredient_splitter_gfm
Suddivide la lista ingredienti di un prodotto in nodi separati per valutazione individuale. Particolarmente utile per alimenti trasformati o piatti in cui la composizione esatta non e fornita.
FlowNode separato per ingredienteinventory_connector_gfm
Collega i prodotti alimentari ai dati di Life Cycle Inventory da database come Agribalyse ed ecoinvent. Utilizza una cache aggregata per i nodi di sistema per ottimizzare le prestazioni.
ModeledActivityNode, FlowNodeMatching Prodotti
Questi moduli abbinano i nomi dei prodotti a termini standardizzati del database.
match_product_name_gfm
Abbina i nomi dei prodotti ai termini FoodEx2 dal database del glossario contenente oltre 565.000 prodotti di convenienza.
FoodProductFlowNodeOutput: Termini ("A1791", "J0116") = "CAROTA" + "DISIDRATATO O ESSICCATO"
attach_food_tags_gfm
Allega tag di classificazione alimentare ai prodotti in base ai termini FoodEx2 abbinati.
FoodProductFlowNodematch_product_name_gfmlink_food_categories_gfm
Collega i termini alimentari abbinati alle classificazioni delle categorie alimentari.
FoodProductFlowNode (non suddivisione)match_product_name_gfmlink_term_to_activity_node_gfm
Collega i termini del prodotto ai processi di attivita LCA nel database. Cerca nel glossary_link le connessioni tra i Termini abbinati e i processi LCA.
FoodProductFlowNode, PracticeFlowNodematch_product_name_gfmAnalisi Ingredienti
Questi moduli analizzano e stimano le quantita degli ingredienti.
ingredient_amount_estimator_gfm
Stima le quantita degli ingredienti quando e disponibile solo una lista di ingredienti senza quantita. Utilizza l'ottimizzazione convessa (CVXPY) per abbinare la nutrizione dichiarata del prodotto con le composizioni degli ingredienti.
nutrient_subdivision_gfm
Suddivide gli ingredienti in varianti basate sui nutrienti per un abbinamento piu accurato.
FoodProductFlowNode senza sotto-nodiOutput: "cacao in polvere magro" + "cacao in polvere grasso"
unit_weight_conversion_gfm
Converte le quantita dei prodotti in unita standardizzate basate sul peso. Gestisce unita di peso, conversione volume-peso, unita specifiche alimentari e articoli basati su conteggio.
FoodProductFlowNode, FlowNodeLocalizzazione e Origine
Questi moduli determinano l'origine geografica e i dati di localizzazione.
origin_gfm
Determina l'origine geografica dei prodotti alimentari utilizzando i dati commerciali FAO. Quando l'origine non e fornita, usa le statistiche di importazione FAO per stimare il paese di origine piu probabile.
FoodProductFlowNodeOutput: { origin: "CH", originConfidence: 0.9, originBasis: "name_analysis" }
location_gfm
Gestisce dati dettagliati di localizzazione geografica incluse coordinate e regioni. Si integra con database geografici per informazioni di localizzazione standardizzate.
FoodProductFlowNodeorigin_gfmTrasporto
Questi moduli calcolano gli impatti del trasporto.
transportation_decision_gfm
Determina la modalita di trasporto ottimale (strada, ferrovia, mare, aereo) in base a costo, distanza e requisiti del prodotto. Considera la deperibilita del prodotto e l'infrastruttura disponibile.
location_gfm, perishability_gfmtransportation_mode_distance_gfm
Calcola distanze di trasporto ed emissioni specifiche del percorso utilizzando l'interfaccia di programmazione EcoTransit. Modella percorsi di trasporto completi inclusi tratti strada-porto, porto-porto e requisiti di refrigerazione.
FlowNode da FoodProcessingActivityNodetransportation_decision_gfmTrasformazione e Conservazione
Questi moduli modellano la trasformazione alimentare, i metodi di produzione e gli impatti dello stoccaggio.
greenhouse_gfm
Stima le emissioni dalla coltivazione in serre riscaldate. La produzione in serra puo aumentare l'impatto climatico fino a 10 volte rispetto agli equivalenti coltivati in campo aperto a causa dei requisiti energetici per il riscaldamento.
ModeledActivityNode con genitore vegetalePomodoro coltivato in campo spagnolo (agosto): 0,2 kg CO₂eq/kg
processing_gfm
Modella le fasi di trasformazione alimentare e il loro impatto ambientale. Gestisce sia modelli di trasformazione complessi (che creano nuovi Life Cycle Inventory) che modelli di trasformazione semplici (basati sul peso).
FoodProductFlowNodematch_product_name_gfmconservation_gfm
Modella requisiti di stoccaggio, catena del freddo e impatti della conservazione. Analizza metodi di conservazione inclusi inscatolamento, congelamento, essiccazione e fermentazione.
FoodProductFlowNode (non suddivisione)location_gfmperishability_gfm
Calcola i fattori di perdita e spreco alimentare in base alla deperibilita del prodotto. Stima durata di conservazione, energia di refrigerazione durante il trasporto e spreco alimentare dovuto al deterioramento.
add_client_nodes_gfmCalcolo Impatto
Questi moduli calcolano le metriche di impatto ambientale.
water_scarcity_gfm
Calcola l'impronta di scarsita idrica in base all'origine e ai fattori regionali di stress idrico. Utilizza fattori Water Stress Index (WSI) per ponderare il consumo di acqua blu in base alla scarsita idrica regionale.
ModeledActivityNode con genitore FoodProductFlowNodeorigin_gfmPomodori dai Paesi Bassi: 12,8 L acqua scarsa/kg
rainforest_gfm
Valuta il rischio di deforestazione e l'impatto sulla foresta pluviale per le materie prime rilevanti.
ModeledActivityNode con genitore FoodProductFlowNodeimpact_assessment_gfm
Calcola il Life Cycle Impact Assessment utilizzando la metodologia IPCC. Calcola gli equivalenti CO₂ per ogni nodo di produzione utilizzando la valutazione di impatto del cambiamento climatico IPCC 2013.
ActivityNode (trasformazione, modellato, scheda fornitura)matrix_calculation_gfm
Esegue calcoli LCA basati su matrici per sistemi di prodotto complessi. Un componente critico per le prestazioni per l'aggregazione matriciale in grafi complessi.
Nutrizione e Punteggi
Questi moduli calcolano metriche di salute e nutrizione.
vitascore_gfm
Calcola il punteggio di salute nutrizionale basato sui fattori di rischio del Global Burden of Disease.
FoodProductFlowNodeaggregation_gfm, daily_food_unit_gfmdaily_food_unit_gfm
Calcola il contributo dell'unita alimentare giornaliera dai valori nutrizionali aggregati.
FoodProductFlowNode (non suddivisione)aggregation_gfmAggregazione
Questi moduli combinano i risultati tra gli ingredienti.
aggregation_gfm
Aggrega i dati da tutti gli ingredienti a livello prodotto. Aggrega valori nutrizionali, quantita per categoria, prodotti critici per la foresta pluviale e prodotti animali.
matrix_calculation_gfmpost_nutrients_aggregation_gfm
Esegue l'aggregazione post-calcolo dopo la valutazione dell'impatto.
impact_assessment_gfm, daily_food_unit_gfmreport_aggregation_gfm
Aggrega i risultati del calcolo per scopi di reportistica. Prepara le strutture dati di output finali per risposte dell'interfaccia di programmazione ed esportazioni.
aggregation_gfm, post_nutrients_aggregation_gfmDipendenze tra Moduli
Il flusso di esecuzione tipico segue questo schema di dipendenze:
Perche i GFM sono Importanti
- Efficienza - Automatizzano compiti ripetitivi di inserimento dati, rendendo EOS scalabile a migliaia di prodotti
- Accuratezza - Sfruttano modelli statistici, ricette standard e dati commerciali per aumentare l'affidabilita
- Standardizzazione - Armonizzano i dati da fonti variegate in formati coerenti
- Adattabilita - Aggiornano i moduli in modo indipendente quando emergono nuovi dati o metodologie
Prossimi Passi
- Come Funzionano i GFM - Meccanica interna
- GFM SDK (in arrivo) - Costruisci moduli personalizzati