eflips-impact 1.0.0__py3-none-any.whl

eflips/impact/defaults/example/fleet.json

@@ -0,0 +1,32 @@
+{
+  "schema_version": 1,
+  "battery_types": [
+    {
+      "vehicle_name_short": "EN",
+      "specific_mass": 6.0,
+      "chemistry": "lfp"
+    },
+    {
+      "vehicle_name_short": "DD",
+      "specific_mass": 6.0,
+      "chemistry": "lfp"
+    },
+    {
+      "vehicle_name_short": "GN",
+      "specific_mass": 6.0,
+      "chemistry": "lfp"
+    }
+  ],
+  "charging_point_types": [
+    {
+      "type": "depot",
+      "name": "Depot Charging Point",
+      "name_short": "DCS"
+    },
+    {
+      "type": "opportunity",
+      "name": "Opportunity Charging Point",
+      "name_short": "OCS"
+    }
+  ]
+}

eflips/impact/defaults/example/lca.json

@@ -0,0 +1,273 @@
+{
+  "schema_version": 1,
+  "metadata": {
+    "ecoinvent_version": "3.9.1",
+    "lcia_method_set": "EF 3.1",
+    "description": "Filled strictly from bus_results.json",
+    "created_at": "2026-05-05T00:00:00Z",
+    "eta_avail": 0.9
+  },
+  "vehicle_production": {
+    "chassis_per_kg": {
+      "gwp": 7.1450240595,
+      "pm": 0.0130150898,
+      "pocp": 0.0165275622,
+      "ap": 0.0241323025,
+      "ep_freshwater": 0.0032166873,
+      "ep_marine": 0.0002458706,
+      "fuel": 1.8687034456,
+      "water": 0.0416410873
+    },
+    "electric_motor_per_kg": {
+      "gwp": 10.4222178848,
+      "pm": 0.0396204048,
+      "pocp": 0.0369665863,
+      "ap": 0.1049725031,
+      "ep_freshwater": 0.0078134135,
+      "ep_marine": 0.0003415405,
+      "fuel": 2.5539152597,
+      "water": 0.0632562358
+    },
+    "diesel_motor_per_unit": {
+      "gwp": 7119.8812502713,
+      "pm": 28.0884617065,
+      "pocp": 26.7830224941,
+      "ap": 70.987127361,
+      "ep_freshwater": 5.4776513498,
+      "ep_marine": 0.1185370059,
+      "fuel": 2002.9892693572,
+      "water": 38.6406873115
+    },
+    "diesel_motor_mass_kg": 1900
+  },
+  "battery": {
+    "lfp_production_per_kg": {
+      "gwp": 14.3224443242,
+      "pm": 0.0598533228,
+      "pocp": 0.0421623622,
+      "ap": 0.2127094264,
+      "ep_freshwater": 0.0061575681,
+      "ep_marine": 0.0007618472,
+      "fuel": 4.002192663,
+      "water": 0.094345349
+    },
+    "lfp_eol_transport_per_kg": {
+      "gwp": 0.6391297263,
+      "pm": 0.0004834968,
+      "pocp": 0.001006088,
+      "ap": 0.0007968881,
+      "ep_freshwater": 6.55958e-05,
+      "ep_marine": 1.73898e-05,
+      "fuel": 0.2030243693,
+      "water": 0.0009558494
+    },
+    "lfp_eol_disassembly_per_kg": {
+      "gwp": -0.2070739303,
+      "pm": -0.0786541299,
+      "pocp": 0.0053780256,
+      "ap": -0.2694058471,
+      "ep_freshwater": 0.0004983863,
+      "ep_marine": -1.57095e-05,
+      "fuel": -0.0427856118,
+      "water": -0.0079487565
+    },
+    "nmc_production_per_kg": {
+      "gwp": 20.1705783869,
+      "pm": 0.0628558404,
+      "pocp": 0.0324743284,
+      "ap": 0.1560246564,
+      "ep_freshwater": 0.0129088056,
+      "ep_marine": 0.0026767478,
+      "fuel": 6.2067875133,
+      "water": 1.2358116285
+    },
+    "nmc_eol_transport_per_kg": {
+      "gwp": 0.6391297263,
+      "pm": 0.0004834968,
+      "pocp": 0.001006088,
+      "ap": 0.0007968881,
+      "ep_freshwater": 6.55958e-05,
+      "ep_marine": 1.73898e-05,
+      "fuel": 0.2030243693,
+      "water": 0.0009558494
+    },
+    "nmc_eol_disassembly_per_kg": {
+      "gwp": -0.1142217733,
+      "pm": -0.0766256035,
+      "pocp": 0.0054840343,
+      "ap": -0.2626756459,
+      "ep_freshwater": 0.0005177394,
+      "ep_marine": -1.31525e-05,
+      "fuel": -0.0230062619,
+      "water": -0.007259187
+    },
+    "lifetime_years": 8
+  },
+  "use_phase": {
+    "electricity_per_kwh_by_year": {
+      "2023": {
+        "gwp": 0.1353671996,
+        "pm": -1.1765e-06,
+        "pocp": 0.000195864,
+        "ap": 0.0001231612,
+        "ep_freshwater": 0.0002881545,
+        "ep_marine": 1.70305e-05,
+        "fuel": 0.0302964784,
+        "water": 0.0009248269
+      },
+      "2030": {
+        "gwp": 0.0696828874,
+        "pm": 1.71883e-05,
+        "pocp": 9.77794e-05,
+        "ap": 6.91517e-05,
+        "ep_freshwater": 4.88415e-05,
+        "ep_marine": 2.9633e-06,
+        "fuel": 0.0203403371,
+        "water": 0.0003027604
+      },
+      "2050": {
+        "gwp": 0.0261391939,
+        "pm": 1.21063e-05,
+        "pocp": 4.93151e-05,
+        "ap": 3.81175e-05,
+        "ep_freshwater": 2.13471e-05,
+        "ep_marine": 1.3551e-06,
+        "fuel": 0.0070978087,
+        "water": 0.0001819775
+      }
+    },
+    "diesel_per_kg": {
+      "gwp": 3.8873023404,
+      "pm": 0.0025506822,
+      "pocp": 0.0152835829,
+      "ap": 0.008266563,
+      "ep_freshwater": -0.0005457298,
+      "ep_marine": 0.0006972338,
+      "fuel": 1.174965882,
+      "water": 0.0010879872
+    },
+    "efficiency_mv_to_lv": 0.99,
+    "efficiency_lv_ac_to_dc": 0.95
+  },
+  "maintenance": {
+    "iceb_per_year": {
+      "gwp": 2727.3725113174,
+      "pm": 1.4247619443,
+      "pocp": 4.0515118775,
+      "ap": 4.2536221735,
+      "ep_freshwater": 1.7563917371,
+      "ep_marine": 0.3003767929,
+      "fuel": 845.3033828273,
+      "water": 17.1228219107
+    },
+    "beb_per_year": {
+      "gwp": 2557.781999876,
+      "pm": 1.5140544646,
+      "pocp": 3.7768838271,
+      "ap": 4.6374171771,
+      "ep_freshwater": 1.9245437185,
+      "ep_marine": 0.351172717,
+      "fuel": 766.0160472554,
+      "water": 17.4877028381
+    },
+    "beb_maintenance_reduction_factor": 0.75
+  },
+  "charging_infrastructure": {
+    "control_unit_production_per_unit": {
+      "gwp": 1345.9444964049,
+      "pm": 18.0932046309,
+      "pocp": 10.7049633521,
+      "ap": 62.1398915436,
+      "ep_freshwater": -0.640240224,
+      "ep_marine": -0.025868672,
+      "fuel": 364.5624892555,
+      "water": 3.2271508923
+    },
+    "control_unit_eol_per_unit": {
+      "gwp": -695.6806515338,
+      "pm": -3.8086274076,
+      "pocp": -3.5434483822,
+      "ap": -12.2032120932,
+      "ep_freshwater": -0.6745872323,
+      "ep_marine": -0.0124930974,
+      "fuel": -166.475652966,
+      "water": -3.0624258115
+    },
+    "user_unit_production_per_unit": {
+      "gwp": 1103.5697420832,
+      "pm": 8.3891756795,
+      "pocp": 5.2934279549,
+      "ap": 24.807719031,
+      "ep_freshwater": 0.1623554265,
+      "ep_marine": 0.0088622687,
+      "fuel": 378.5719232999,
+      "water": 6.3381681756
+    },
+    "user_unit_eol_per_unit": {
+      "gwp": -575.5520046697,
+      "pm": -2.1062698977,
+      "pocp": -2.1443792511,
+      "ap": -5.6540243026,
+      "ep_freshwater": -0.4347275205,
+      "ep_marine": -0.0155945266,
+      "fuel": -218.6949472794,
+      "water": -4.9965202021
+    },
+    "power_unit": {
+      "ref_power_kw": 350,
+      "production_per_unit": {
+        "gwp": 6103.5150927163,
+        "pm": 88.7660796321,
+        "pocp": 52.1822194765,
+        "ap": 309.0006819978,
+        "ep_freshwater": -3.5354640772,
+        "ep_marine": -0.1454028451,
+        "fuel": 1618.5270535389,
+        "water": 12.9151295387
+      },
+      "eol_per_unit": {
+        "gwp": -1586.3434417575,
+        "pm": -15.0129738261,
+        "pocp": -12.6199610485,
+        "ap": -52.3884489456,
+        "ep_freshwater": -2.6246336265,
+        "ep_marine": -0.0099295108,
+        "fuel": -408.4318346679,
+        "water": -3.8301140032
+      }
+    },
+    "transformer": {
+      "ref_power_kw": 315.0,
+      "production_per_unit": {
+        "gwp": 8100.000000000007,
+        "pm": 18.580645161290313,
+        "pocp": 22.027913232601538,
+        "ap": 58.602150537634465,
+        "ep_freshwater": 2.933333333333336,
+        "ep_marine": 6.000000000000005,
+        "fuel": 3440.8602150537668,
+        "water": 3965.25
+      },
+      "eol_per_unit": {
+        "gwp": -0.0,
+        "pm": -1.300645161290322,
+        "pocp": -1.5419539262821078,
+        "ap": -4.1021505376344125,
+        "ep_freshwater": -0.733333333333334,
+        "ep_marine": -0.6000000000000005,
+        "fuel": -240.86021505376368,
+        "water": 1.56
+      }
+    },
+    "concrete_per_m3": {
+      "gwp": 307.953,
+      "pm": 0.298,
+      "pocp": 1.801,
+      "ap": 0.684,
+      "ep_freshwater": 0.037,
+      "ep_marine": 0.003,
+      "fuel": 48.306,
+      "water": 2.677
+    }
+  }
+}

eflips/impact/defaults/example/lca_overrides.json

@@ -0,0 +1,41 @@
+{
+  "schema_version": 1,
+  "year": 2025,
+  "vehicle_type_overrides": [
+    {
+      "name_short": "EN",
+      "motor_rated_power_kw": 200.0,
+      "motor_power_to_weight_ratio_kw_per_kg": 1.5,
+      "vehicle_lifetime_years": 12.0,
+      "average_consumption_kwh_per_km": 1.48,
+      "diesel_consumption_kg_per_km": null
+    },
+    {
+      "name_short": "DD",
+      "motor_rated_power_kw": 300.0,
+      "motor_power_to_weight_ratio_kw_per_kg": 1.5,
+      "vehicle_lifetime_years": 12.0,
+      "average_consumption_kwh_per_km": 2.16,
+      "diesel_consumption_kg_per_km": null
+    },
+    {
+      "name_short": "GN",
+      "motor_rated_power_kw": 250.0,
+      "motor_power_to_weight_ratio_kw_per_kg": 1.5,
+      "vehicle_lifetime_years": 12.0,
+      "average_consumption_kwh_per_km": 2.16,
+      "diesel_consumption_kg_per_km": null
+    }
+  ],
+  "charging_point_type_overrides": [
+    {
+      "type": "depot",
+      "infrastructure_lifetime_years": 20.0
+    },
+    {
+      "type": "opportunity",
+      "infrastructure_lifetime_years": 20.0,
+      "foundation_volume_per_point_m3": 3.96
+    }
+  ]
+}

eflips/impact/defaults/example/tco.json

@@ -0,0 +1,113 @@
+{
+  "scenario": {
+    "project_duration": 20,
+    "interest_rate": 0.04,
+    "inflation_rate": 0.02,
+    "staff_cost": 25.0,
+    "fuel_cost": {"diesel": 1.0, "electricity": 0.1794},
+    "vehicle_maint_cost": {"diesel": 0.5, "electricity": 0.35},
+    "infra_maint_cost": 1000.0,
+    "cost_escalation_rate": {
+      "general": 0.02,
+      "staff": 0.025,
+      "diesel": 0.0,
+      "electricity": 0.038,
+      "insurance": 0.02
+    },
+    "insurance": 9693.0,
+    "taxes": 278.0,
+    "eta_avail": 0.9
+  },
+  "vehicle_types": [
+    {
+      "name_short": "EN",
+      "useful_life": 14,
+      "procurement_cost": 580000.0,
+      "cost_escalation": -0.02,
+      "average_electricity_consumption": 1.48
+    },
+    {
+      "name_short": "DD",
+      "useful_life": 14,
+      "procurement_cost": 780000.0,
+      "cost_escalation": -0.02,
+      "average_electricity_consumption": 2.16
+    },
+    {
+      "name_short": "GN",
+      "useful_life": 14,
+      "procurement_cost": 780000.0,
+      "cost_escalation": -0.02,
+      "average_electricity_consumption": 2.16
+    },
+    {
+      "name_short": "Diesel EN",
+      "useful_life": 14,
+      "procurement_cost": 275000.0,
+      "cost_escalation": 0.02,
+      "average_diesel_consumption": 0.449
+    },
+    {
+      "name_short": "Diesel DD",
+      "useful_life": 14,
+      "procurement_cost": 330000.0,
+      "cost_escalation": 0.02,
+      "average_diesel_consumption": 0.589
+    },
+    {
+      "name_short": "Diesel GN",
+      "useful_life": 14,
+      "procurement_cost": 510000.0,
+      "cost_escalation": 0.02,
+      "average_diesel_consumption": 0.589
+    }
+  ],
+  "battery_types": [
+    {
+      "vehicle_name_short": "EN",
+      "procurement_cost": 190,
+      "useful_life": 7,
+      "cost_escalation": -0.03
+    },
+    {
+      "vehicle_name_short": "DD",
+      "procurement_cost": 190,
+      "useful_life": 7,
+      "cost_escalation": -0.03
+    },
+    {
+      "vehicle_name_short": "GN",
+      "procurement_cost": 190,
+      "useful_life": 7,
+      "cost_escalation": -0.03
+    }
+  ],
+  "charging_point_types": [
+    {
+      "type": "depot",
+      "procurement_cost": 119899.50,
+      "useful_life": 20,
+      "cost_escalation": 0.02
+    },
+    {
+      "type": "opportunity",
+      "procurement_cost": 299748.74,
+      "useful_life": 20,
+      "cost_escalation": 0.02
+    }
+  ],
+  "charging_infrastructure": [
+    {
+      "type": "depot",
+      "procurement_cost": 2397989.95,
+      "useful_life": 20,
+      "cost_escalation": 0.02
+    },
+    {
+      "type": "station",
+      "procurement_cost": 269773.87,
+      "useful_life": 20,
+      "cost_escalation": 0.02
+    }
+  ]
+}

eflips/impact/lca/__init__.py

@@ -0,0 +1,57 @@
+"""eflips-lca: Life Cycle Assessment for eFLIPS bus simulations.
+
+Calculates per-revenue-km environmental impacts of electric (BEB) and
+diesel (ICEB) bus fleets across their full life cycle, following
+ISO 14040/14044.
+"""
+
+from eflips.impact.lca.calculation import calculate_lca
+from eflips.impact.lca.dataclasses import (
+    BatteryTypeLCAParams,
+    ChargingPointTypeLCAParams,
+    ItemType,
+    LCAItem,
+    LCAResult,
+    LCAScope,
+    VehicleTypeLCAParams,
+)
+from eflips.impact.utils.extraction import (
+    AreaSimData,
+    ScenarioSimData,
+    StationSimData,
+    VehicleTypeSimData,
+    extract_simulation_data,
+)
+from eflips.impact.lca.open_lca_data import (
+    ChargingPointTypeOverrides,
+    OpenLCAData,
+    VehicleTypeOverrides,
+    YearSeries,
+    init_lca_params,
+    populate_lca_parameters_from_data,
+)
+from eflips.impact.lca.util import DefaultImpactVector, ImpactVector
+
+__all__ = [
+    "ImpactVector",
+    "DefaultImpactVector",
+    "VehicleTypeLCAParams",
+    "BatteryTypeLCAParams",
+    "ChargingPointTypeLCAParams",
+    "LCAItem",
+    "LCAResult",
+    "LCAScope",
+    "ItemType",
+    "ScenarioSimData",
+    "VehicleTypeSimData",
+    "AreaSimData",
+    "StationSimData",
+    "extract_simulation_data",
+    "calculate_lca",
+    "OpenLCAData",
+    "YearSeries",
+    "VehicleTypeOverrides",
+    "ChargingPointTypeOverrides",
+    "init_lca_params",
+    "populate_lca_parameters_from_data",
+]