Life Cycle Analysis (BETA)

Generated from cea/schemas.yml by scripts/generate_tutorial_glossary.py. Do not hand-edit — re-run the script to refresh.

Files in this category: 24

Files

get_analysis_configuration_file
get_baseline_costs
get_baseline_costs_detailed
get_costs_whatif_buildings_file
get_costs_whatif_components_file
get_emissions_whatif_buildings_file
get_emissions_whatif_operational_file
get_emissions_whatif_timeline_file
get_final_energy_building_file
get_final_energy_buildings_file
get_final_energy_file
get_final_energy_plant_file
get_heat_rejection_buildings
get_heat_rejection_components
get_heat_rejection_hourly_building
get_heat_rejection_hourly_spatial
get_heat_rejection_whatif_building_file
get_heat_rejection_whatif_buildings_file
get_heat_rejection_whatif_components_file
get_lca_embodied
get_lca_mobility
get_lca_operation
get_lca_operational_hourly_building
get_total_yearly_operational_building

`get_analysis_configuration_file`

Path: outputs/data/analysis/{whatif_name}/configuration.json
File type: json
Created by: final_energy
Used by: (none)

`get_baseline_costs`

Path: outputs/data/costs/baseline_costs.csv
File type: csv
Created by: system_costs
Used by: (none)

Variable	Description	Type	Unit	Values
`Capex_a_building_scale_USD`	Annualised capital expenditure for building-scale systems	float	`[$USD(2015)/yr]`	{0.0…n}
`Capex_a_district_scale_USD`	Annualised capital expenditure for district-scale systems	float	`[$USD(2015)/yr]`	{0.0…n}
`Capex_a_USD`	Annualised capital expenditure for all supply systems	float	`[$USD(2015)/yr]`	{0.0…n}
`Capex_total_building_scale_USD`	Total capital expenditure for building-scale systems	float	`[$USD(2015)]`	{0.0…n}
`Capex_total_district_scale_USD`	Total capital expenditure for district-scale systems (networks + piping)	float	`[$USD(2015)]`	{0.0…n}
`Capex_total_USD`	Total capital expenditure for all supply systems and components	float	`[$USD(2015)]`	{0.0…n}
`GFA_m2`	Gross floor area (sum of all buildings for networks)	float	`[m2]`	{0.0…n}
`name`	Building or network name	string	`NA`	alphanumeric
`Opex_a_building_scale_USD`	Annual operational expenditure for building-scale systems	float	`[$USD(2015)/yr]`	{0.0…n}
`Opex_a_district_scale_USD`	Annual operational expenditure for district-scale systems	float	`[$USD(2015)/yr]`	{0.0…n}
`Opex_a_USD`	Total annual operational expenditure (fixed + variable)	float	`[$USD(2015)/yr]`	{0.0…n}
`Opex_fixed_a_USD`	Annual fixed operational expenditure (O&M)	float	`[$USD(2015)/yr]`	{0.0…n}
`Opex_var_a_USD`	Annual variable operational expenditure (energy costs)	float	`[$USD(2015)/yr]`	{0.0…n}
`TAC_USD`	Total annualised cost (CAPEX_a + OPEX_a)	float	`[$USD(2015)/yr]`	{0.0…n}

`get_baseline_costs_detailed`

Path: outputs/data/costs/baseline_costs_detailed.csv
File type: csv
Created by: system_costs
Used by: (none)

Variable	Description	Type	Unit	Values
`capacity_kW`	Component capacity in kilowatts (0 for energy carriers and piping)	float	`[kW]`	{0.0…n}
`capex_a_USD`	Annualised capital expenditure for component	float	`[$USD(2015)/yr]`	{0.0…n}
`capex_total_USD`	Total capital expenditure for component	float	`[$USD(2015)]`	{0.0…n}
`code`	Component code (e.g., CH1 for chiller type 1, CT1 for cooling tower type 1, PIPES for distribution piping) or energy carrier code (e.g., E230AC for electricity, NATURALGAS for natural gas)	string	`NA`	alphanumeric
`name`	Building or network name	string	`NA`	alphanumeric
`network_type`	Network type (DC for district cooling, DH for district heating) or empty for standalone buildings	string	`NA`	alphanumeric
`opex_fixed_a_USD`	Annual fixed operational expenditure (operations and maintenance)	float	`[$USD(2015)/yr]`	{0.0…n}
`opex_var_a_USD`	Annual variable operational expenditure (energy costs from fuel or electricity purchases)	float	`[$USD(2015)/yr]`	{0.0…n}
`placement`	Component placement in system (primary for heat/cooling generation, secondary for intermediate conversion, tertiary for heat rejection, distribution for piping, energy_carrier for fuel/electricity costs)	string	`NA`	alphanumeric
`scale`	System scale (BUILDING for individual building systems, DISTRICT for district network systems)	string	`NA`	alphanumeric
`service`	Energy service (e.g., GRID_cs for grid cooling, DC_network for district cooling network, NONE for buildings with no systems)	string	`NA`	alphanumeric

`get_costs_whatif_buildings_file`

Path: outputs/data/analysis/{whatif_name}/costs/costs_buildings.csv
File type: csv
Created by: system_costs
Used by: (none)

Variable	Description	Type	Unit	Values
`capex_a_USD`	Annualised capital expenditure for all supply systems	float	`[$USD(2015)/yr]`	{0.0…n}
`capex_total_USD`	Total capital expenditure for all supply systems	float	`[$USD(2015)]`	{0.0…n}
`GFA_m2`	Gross floor area	float	`[m2]`	{0.0…n}
`name`	Building or plant name	string	`NA`	alphanumeric
`opex_fixed_a_USD`	Annual fixed operational expenditure (O&M)	float	`[$USD(2015)/yr]`	{0.0…n}
`opex_var_a_USD`	Annual variable operational expenditure (energy costs)	float	`[$USD(2015)/yr]`	{0.0…n}
`scale`	Supply system scale (BUILDING or DISTRICT)	string	`NA`	alphanumeric
`TAC_USD`	Total annualised cost (capex_a + opex_fixed_a + opex_var_a)	float	`[$USD(2015)/yr]`	{0.0…n}
`type`	Row type (building or plant)	string	`NA`	alphanumeric
`whatif_name`	What-if scenario name	string	`NA`	alphanumeric
`x_coord`	Building centroid x coordinate	float	`[m]`	{n…n}
`y_coord`	Building centroid y coordinate	float	`[m]`	{n…n}

`get_costs_whatif_components_file`

Path: outputs/data/analysis/{whatif_name}/costs/costs_components.csv
File type: csv
Created by: system_costs
Used by: (none)

Variable	Description	Type	Unit	Values
`assembly_code`	Supply assembly code (e.g., SUPPLY_HEATING_AS3)	string	`NA`	alphanumeric
`capacity_kW`	Component capacity in kilowatts (peak / efficiency)	float	`[kW]`	{0.0…n}
`capex_a_USD`	Annualised capital expenditure for this component	float	`[$USD(2015)/yr]`	{0.0…n}
`capex_total_USD`	Total capital expenditure for this component	float	`[$USD(2015)]`	{0.0…n}
`carrier`	Energy carrier (NATURALGAS, GRID, OIL, etc.)	string	`NA`	alphanumeric
`component_code`	Component code (e.g., BO1, HP1, CH1, PU1)	string	`NA`	alphanumeric
`name`	Building or plant name	string	`NA`	alphanumeric
`opex_fixed_a_USD`	Annual fixed operational expenditure (O&M)	float	`[$USD(2015)/yr]`	{0.0…n}
`opex_var_a_USD`	Annual variable operational expenditure (energy costs)	float	`[$USD(2015)/yr]`	{0.0…n}
`peak_service_kW`	Peak service demand in kilowatts	float	`[kW]`	{0.0…n}
`scale`	Supply system scale (BUILDING or DISTRICT)	string	`NA`	alphanumeric
`service`	Energy service (hs, ww, cs, E, hs_booster, ww_booster, hs_pumping, hs_piping, cs_pumping, cs_piping, PV_, SC_, PVT_*)	string	`NA`	alphanumeric
`TAC_USD`	Total annualised cost (capex_a + opex_fixed_a + opex_var_a)	float	`[$USD(2015)/yr]`	{0.0…n}

`get_emissions_whatif_buildings_file`

Path: outputs/data/analysis/{whatif_name}/emissions/emissions_buildings.csv
File type: csv
Created by: emissions
Used by: (none)

Variable	Description	Type	Unit	Values
`biogenic_kgCO2e`	Total lifecycle biogenic carbon storage across all years (negative = sequestration)	float	`[kgCO2e]`	{n…n}
`case`	Connectivity case number from final-energy	float	`NA`	{n…n}
`case_description`	Human-readable description of connectivity case	string	`NA`	alphanumeric
`demolition_kgCO2e`	Total lifecycle demolition GHG emissions across all years	float	`[kgCO2e]`	{n…n}
`GFA_m2`	Gross floor area (null for plants)	float	`[m2]`	{0.0…n}
`name`	Building name or plant identifier (e.g. B1001, NODE16)	string	`NA`	alphanumeric
`operation_kgCO2e`	Total annual operational GHG emissions	float	`[kgCO2e/yr]`	{n…n}
`production_kgCO2e`	Total lifecycle production (embodied) GHG emissions across all years	float	`[kgCO2e]`	{n…n}
`scale`	System scale (BUILDING for standalone, DISTRICT for networked)	string	`NA`	alphanumeric
`type`	Entity type (building or plant)	string	`NA`	{building, plant}
`whatif_name`	What-if scenario name	string	`NA`	alphanumeric
`x_coord`	X coordinate of building centroid or plant node location	float	`[m]`	{n…n}
`y_coord`	Y coordinate of building centroid or plant node location	float	`[m]`	{n…n}

`get_emissions_whatif_operational_file`

Path: outputs/data/analysis/{whatif_name}/emissions/emissions_operational.csv
File type: csv
Created by: emissions
Used by: (none)

Variable	Description	Type	Unit	Values
`date`	Hourly timestamp	string	`NA`	alphanumeric

`get_emissions_whatif_timeline_file`

Path: outputs/data/analysis/{whatif_name}/emissions/emissions_timeline.csv
File type: csv
Created by: emissions
Used by: (none)

Variable	Description	Type	Unit	Values
`period`	Year label (e.g. Y_2025)	string	`NA`	alphanumeric

`get_final_energy_building_file`

Path: outputs/data/analysis/{whatif_name}/final-energy/{building}.csv
File type: csv
Created by: final_energy
Used by: (none)

Variable	Description	Type	Unit	Values
`case`	Connectivity case: 1=Standalone, 2=DH+DC, 3=DH only, 4=DC only, 4.01/4.02/4.03=DC with boosters	float	`NA`	{n…n}
`case_description`	Human-readable description of connectivity case	string	`NA`	alphanumeric
`date`	Timestamp for each hour (8760 rows per year)	date	`NA`	YYYY-MM-DD
`E_sys_GRID_kWh`	Hourly grid electricity consumption for appliances/lighting/ventilation	float	`[kWh]`	{0.0…n}
`E_sys_kWh`	Hourly electricity system demand (appliances, lighting, ventilation)	float	`[kWh]`	{0.0…n}
`PV_roof_kWh`	Hourly solar electrical generation from roof panels	float	`[kWh]`	{0.0…n}
`PV_total_kWh`	Hourly total solar electrical generation (sum of all facades)	float	`[kWh]`	{0.0…n}
`PV_wall_east_kWh`	Hourly solar electrical generation from east wall panels	float	`[kWh]`	{0.0…n}
`PV_wall_north_kWh`	Hourly solar electrical generation from north wall panels	float	`[kWh]`	{0.0…n}
`PV_wall_south_kWh`	Hourly solar electrical generation from south wall panels	float	`[kWh]`	{0.0…n}
`PV_wall_west_kWh`	Hourly solar electrical generation from west wall panels	float	`[kWh]`	{0.0…n}
`Qcs_sys_DC_kWh`	Hourly district cooling consumption	float	`[kWh]`	{0.0…n}
`Qcs_sys_GRID_kWh`	Hourly grid electricity consumption for space cooling	float	`[kWh]`	{0.0…n}
`Qcs_sys_kWh`	Hourly space cooling system demand	float	`[kWh]`	{0.0…n}
`Qhs_booster_NATURALGAS_kWh`	Hourly natural gas consumption for space heating booster	float	`[kWh]`	{0.0…n}
`Qhs_sys_DH_kWh`	Hourly district heating consumption for space heating	float	`[kWh]`	{0.0…n}
`Qhs_sys_GRID_kWh`	Hourly grid electricity consumption for space heating (heat pumps)	float	`[kWh]`	{0.0…n}
`Qhs_sys_kWh`	Hourly space heating system demand	float	`[kWh]`	{0.0…n}
`Qhs_sys_NATURALGAS_kWh`	Hourly natural gas consumption for space heating	float	`[kWh]`	{0.0…n}
`Qww_booster_NATURALGAS_kWh`	Hourly natural gas consumption for hot water booster	float	`[kWh]`	{0.0…n}
`Qww_sys_DH_kWh`	Hourly district heating consumption for hot water	float	`[kWh]`	{0.0…n}
`Qww_sys_kWh`	Hourly domestic hot water system demand	float	`[kWh]`	{0.0…n}
`Qww_sys_NATURALGAS_kWh`	Hourly natural gas consumption for hot water	float	`[kWh]`	{0.0…n}
`scale`	System scale (BUILDING for standalone, DISTRICT for networked)	string	`NA`	alphanumeric
`SOLAR_roof_kWh`	Hourly solar thermal generation from roof collectors	float	`[kWh]`	{0.0…n}
`SOLAR_total_kWh`	Hourly total solar thermal generation (sum of all facades)	float	`[kWh]`	{0.0…n}
`SOLAR_wall_east_kWh`	Hourly solar thermal generation from east wall collectors	float	`[kWh]`	{0.0…n}
`SOLAR_wall_north_kWh`	Hourly solar thermal generation from north wall collectors	float	`[kWh]`	{0.0…n}
`SOLAR_wall_south_kWh`	Hourly solar thermal generation from south wall collectors	float	`[kWh]`	{0.0…n}
`SOLAR_wall_west_kWh`	Hourly solar thermal generation from west wall collectors	float	`[kWh]`	{0.0…n}

`get_final_energy_buildings_file`

Path: outputs/data/analysis/{whatif_name}/final-energy/final_energy_buildings.csv
File type: csv
Created by: final_energy
Used by: (none)

Variable	Description	Type	Unit	Values
`case`	Connectivity case: 1=Standalone, 2=DH+DC, 3=DH only, 4=DC only, 4.01/4.02/4.03=DC with boosters, 5=District plant	float	`NA`	{n…n}
`case_description`	Human-readable description of connectivity case	string	`NA`	alphanumeric
`COAL_MWh`	Annual coal consumption	float	`[MWh/yr]`	{0.0…n}
`DC_MWh`	Annual district cooling consumption	float	`[MWh/yr]`	{0.0…n}
`DH_MWh`	Annual district heating consumption	float	`[MWh/yr]`	{0.0…n}
`E_sys_MWh`	Annual electricity system demand (appliances, lighting, ventilation)	float	`[MWh/yr]`	{0.0…n}
`GFA_m2`	Gross floor area (0 for plants)	float	`[m2]`	{0.0…n}
`GRID_MWh`	Annual grid electricity consumption	float	`[MWh/yr]`	{0.0…n}
`name`	Building name or plant name (e.g., B1001, NODE16)	string	`NA`	alphanumeric
`NATURALGAS_MWh`	Annual natural gas consumption	float	`[MWh/yr]`	{0.0…n}
`OIL_MWh`	Annual oil consumption	float	`[MWh/yr]`	{0.0…n}
`peak_datetime`	Timestamp when peak demand occurs	string	`NA`	alphanumeric
`peak_demand_kW`	Peak total demand (thermal + electrical)	float	`[kW]`	{0.0…n}
`PV_MWh`	Annual solar electrical generation (from PV and PVT panels)	float	`[MWh/yr]`	{0.0…n}
`Qcs_sys_MWh`	Annual space cooling system demand	float	`[MWh/yr]`	{0.0…n}
`Qhs_sys_MWh`	Annual space heating system demand	float	`[MWh/yr]`	{0.0…n}
`Qww_sys_MWh`	Annual domestic hot water system demand	float	`[MWh/yr]`	{0.0…n}
`scale`	System scale (BUILDING for standalone, DISTRICT for networked)	string	`NA`	{BUILDING, DISTRICT}
`SOLAR_MWh`	Annual solar thermal generation (from SC and PVT panels)	float	`[MWh/yr]`	{0.0…n}
`TOTAL_MWh`	Total annual final energy consumption (sum of all carriers)	float	`[MWh/yr]`	{0.0…n}
`type`	Entity type (building or plant)	string	`NA`	{building, plant}
`WOOD_MWh`	Annual wood/biomass consumption	float	`[MWh/yr]`	{0.0…n}
`x_coord`	X coordinate of building centroid or plant node location	float	`[m]`	{n…n}
`y_coord`	Y coordinate of building centroid or plant node location	float	`[m]`	{n…n}

`get_final_energy_file`

Path: outputs/data/analysis/{whatif_name}/final-energy/final_energy.csv
File type: csv
Created by: final_energy
Used by: (none)

Variable	Description	Type	Unit	Values
`COAL_kWh`	Hourly coal consumption (buildings + plants)	float	`[kWh]`	{0.0…n}
`date`	Timestamp for each hour (8760 rows per year)	date	`NA`	YYYY-MM-DD
`DC_kWh`	Hourly district cooling consumption	float	`[kWh]`	{0.0…n}
`DH_kWh`	Hourly district heating consumption	float	`[kWh]`	{0.0…n}
`E_sys_kWh`	Hourly electricity system demand (all buildings aggregated)	float	`[kWh]`	{0.0…n}
`GRID_kWh`	Hourly grid electricity consumption (buildings + plants)	float	`[kWh]`	{0.0…n}
`NATURALGAS_kWh`	Hourly natural gas consumption (buildings + plants)	float	`[kWh]`	{0.0…n}
`OIL_kWh`	Hourly oil consumption (buildings + plants)	float	`[kWh]`	{0.0…n}
`PV_kWh`	Hourly solar electrical generation (from PV and PVT panels)	float	`[kWh]`	{0.0…n}
`Qcs_sys_kWh`	Hourly space cooling system demand (all buildings aggregated)	float	`[kWh]`	{0.0…n}
`Qhs_sys_kWh`	Hourly space heating system demand (all buildings aggregated)	float	`[kWh]`	{0.0…n}
`Qww_sys_kWh`	Hourly domestic hot water system demand (all buildings aggregated)	float	`[kWh]`	{0.0…n}
`SOLAR_kWh`	Hourly solar thermal generation (from SC and PVT panels)	float	`[kWh]`	{0.0…n}
`TOTAL_kWh`	Hourly total final energy consumption (sum of all carriers)	float	`[kWh]`	{0.0…n}
`WOOD_kWh`	Hourly wood/biomass consumption (buildings + plants)	float	`[kWh]`	{0.0…n}

`get_final_energy_plant_file`

Path: outputs/data/analysis/{whatif_name}/final-energy/{plant_name}.csv
File type: csv
Created by: final_energy
Used by: (none)

Variable	Description	Type	Unit	Values
`date`	Timestamp for each hour (8760 rows per year)	date	`NA`	YYYY-MM-DD
`network_name`	Network layout name	string	`NA`	alphanumeric
`network_type`	Network type (DH for district heating, DC for district cooling)	string	`NA`	{DH, DC}
`plant_name`	Plant node name from network shapefile (e.g., NODE16, PLANT_A)	string	`NA`	alphanumeric
`plant_primary_DC_GRID_kWh`	Hourly grid electricity consumption for DC plant primary component (chiller)	float	`[kWh]`	{0.0…n}
`plant_primary_DH_GRID_kWh`	Hourly grid electricity consumption for DH plant primary component (heat pump)	float	`[kWh]`	{0.0…n}
`plant_primary_DH_NATURALGAS_kWh`	Hourly natural gas consumption for DH plant primary component (boiler)	float	`[kWh]`	{0.0…n}
`plant_primary_DH_OIL_kWh`	Hourly oil consumption for DH plant primary component (boiler)	float	`[kWh]`	{0.0…n}
`plant_primary_DH_WOOD_kWh`	Hourly wood/biomass consumption for DH plant primary component (boiler)	float	`[kWh]`	{0.0…n}
`plant_pumping_DC_GRID_kWh`	Hourly grid electricity consumption for DC network pumping	float	`[kWh]`	{0.0…n}
`plant_pumping_DH_GRID_kWh`	Hourly grid electricity consumption for DH network pumping	float	`[kWh]`	{0.0…n}
`plant_tertiary_DC_GRID_kWh`	Hourly grid electricity consumption for DC plant tertiary component (cooling tower fan)	float	`[kWh]`	{0.0…n}
`pumping_load_kWh`	Hourly pumping energy consumption for distribution network	float	`[kWh]`	{0.0…n}
`scale`	System scale (always DISTRICT for plants)	string	`NA`	{DISTRICT}
`thermal_load_kWh`	Hourly thermal load served by the plant (heating or cooling)	float	`[kWh]`	{0.0…n}

`get_heat_rejection_buildings`

Path: outputs/data/heat/heat_rejection_buildings.csv
File type: csv
Created by: anthropogenic_heat
Used by: (none)

Variable	Description	Type	Unit	Values
`GFA_m2`	Gross floor area (0 for plant nodes)	float	`[m2]`	{0.0…n}
`heat_rejection_annual_MWh`	Total annual heat rejection to environment (sum of all energy carriers)	float	`[MWh]`	{0.0…n}
`name`	Building or network plant name	string	`NA`	alphanumeric
`peak_datetime`	Date and time of peak heat rejection	string	`NA`	alphanumeric
`peak_heat_rejection_kW`	Peak hourly heat rejection rate	float	`[kW]`	{0.0…n}
`scale`	System scale (BUILDING for individual building systems, DISTRICT for district network plants)	string	`NA`	alphanumeric
`type`	Type of heat source (building for individual buildings, plant for district energy plants)	string	`NA`	alphanumeric
`x_coord`	X coordinate for spatial location (longitude or projected coordinate)	float	`[m]`	{n…n}
`y_coord`	Y coordinate for spatial location (latitude or projected coordinate)	float	`[m]`	{n…n}

`get_heat_rejection_components`

Path: outputs/data/heat/heat_rejection_components.csv
File type: csv
Created by: anthropogenic_heat
Used by: (none)

Variable	Description	Type	Unit	Values
`component_code`	Component code (e.g., CH1 for chiller type 1, CT1 for cooling tower type 1)	string	`NA`	alphanumeric
`energy_carrier`	Energy carrier code for heat rejection medium (e.g., T_AIR_20C for air at 20C, T_AIR_ODB for outdoor air)	string	`NA`	alphanumeric
`heat_rejection_annual_MWh`	Annual heat rejection for this component and energy carrier	float	`[MWh]`	{0.0…n}
`name`	Building or network plant name	string	`NA`	alphanumeric
`network_type`	Network type (DC for district cooling, DH for district heating) or empty for standalone buildings	string	`NA`	alphanumeric
`peak_heat_rejection_kW`	Peak hourly heat rejection rate for this component	float	`[kW]`	{0.0…n}
`scale`	System scale (BUILDING for individual building systems, DISTRICT for district network plants)	string	`NA`	alphanumeric
`service`	Energy service (e.g., GRID_cs for grid cooling, DC_plant for district cooling plant)	string	`NA`	alphanumeric

`get_heat_rejection_hourly_building`

Path: outputs/data/heat/{building}.csv
File type: csv
Created by: anthropogenic_heat
Used by: (none)

Variable	Description	Type	Unit	Values
`DATE`	Timestamp for this hour (8760 hours total, no leap day)	string	`NA`	alphanumeric
`heat_rejection_kW`	Heat rejection rate at this hour (sum of all energy carriers)	float	`[kW]`	{0.0…n}

`get_heat_rejection_hourly_spatial`

Path: outputs/data/heat/heat_rejection_hourly_spatial.csv
File type: csv
Created by: anthropogenic_heat
Used by: (none)

Variable	Description	Type	Unit	Values
`date`	Timestamp for this hour (8760 hours per location)	string	`NA`	alphanumeric
`heat_rejection_kW`	Heat rejection rate at this hour (sum of all energy carriers)	float	`[kW]`	{0.0…n}
`name`	Building or network plant name	string	`NA`	alphanumeric
`type`	Type of heat source (building for individual buildings, plant for district energy plants)	string	`NA`	alphanumeric

`get_heat_rejection_whatif_building_file`

Path: outputs/data/analysis/{whatif_name}/heat/{name}.csv
File type: csv
Created by: anthropogenic_heat
Used by: (none)

Variable	Description	Type	Unit	Values
`date`	Timestamp for each hour (8760 rows per year)	date	`NA`	YYYY-MM-DD
`heat_rejection_kW`	Heat rejection rate at this hour (sum of all energy carriers)	float	`[kW]`	{0.0…n}

`get_heat_rejection_whatif_buildings_file`

Path: outputs/data/analysis/{whatif_name}/heat/heat_rejection_buildings.csv
File type: csv
Created by: anthropogenic_heat
Used by: (none)

Variable	Description	Type	Unit	Values
`case`	Connectivity case number from final-energy	float	`NA`	{n…n}
`case_description`	Human-readable description of connectivity case	string	`NA`	alphanumeric
`GFA_m2`	Gross floor area (0 for plants)	float	`[m2]`	{0.0…n}
`heat_rejection_annual_MWh`	Total annual heat rejection to the environment	float	`[MWh/yr]`	{0.0…n}
`name`	Building name or plant identifier (e.g. B1001, NODE16)	string	`NA`	alphanumeric
`peak_heat_rejection_kW`	Peak hourly heat rejection rate	float	`[kW]`	{0.0…n}
`scale`	System scale (BUILDING for standalone, DISTRICT for networked)	string	`NA`	alphanumeric
`type`	Entity type (building or plant)	string	`NA`	{building, plant}
`whatif_name`	What-if scenario name	string	`NA`	alphanumeric
`x_coord`	X coordinate of building centroid or plant node location	float	`[m]`	{n…n}
`y_coord`	Y coordinate of building centroid or plant node location	float	`[m]`	{n…n}

`get_heat_rejection_whatif_components_file`

Path: outputs/data/analysis/{whatif_name}/heat/heat_rejection_components.csv
File type: csv
Created by: anthropogenic_heat
Used by: (none)

Variable	Description	Type	Unit	Values
`assembly_code`	Supply assembly code from database	string	`NA`	alphanumeric
`carrier`	Energy carrier (NATURALGAS, GRID, DH, DC, etc.)	string	`NA`	alphanumeric
`component_code`	Primary component code (e.g. BO1, CH1)	string	`NA`	alphanumeric
`heat_rejection_annual_MWh`	Annual heat rejection for this service	float	`[MWh/yr]`	{0.0…n}
`name`	Building name or plant identifier	string	`NA`	alphanumeric
`peak_heat_rejection_kW`	Peak hourly heat rejection for this service	float	`[kW]`	{0.0…n}
`scale`	System scale (BUILDING or DISTRICT)	string	`NA`	{BUILDING, DISTRICT}
`service`	Energy service (hs, ww, cs, hs_booster, ww_booster)	string	`NA`	alphanumeric

`get_lca_embodied`

Path: outputs/data/emissions/Total_LCA_embodied.csv
File type: csv
Created by: emissions
Used by: (none)

Variable	Description	Type	Unit	Values
`GFA_m2`	Gross floor area	float	`[m2]`	{0.0…n}
`GHG_base_tonCO2`	Embodied emissions of basement floor due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{0.0…n}
`GHG_floor_tonCO2`	Embodied emissions of floors due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{0.0…n}
`GHG_part_tonCO2`	Embodied emissions of indoor partition due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{0.0…n}
`GHG_roof_tonCO2`	Embodied emissions of roof due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{0.0…n}
`GHG_sys_embodied_kgCO2m2yr`	Embodied emissions per conditioned floor area due to building or retrofit construction and decommissioning	float	`[kg CO2-eq/m2.yr]`	{0.0…n}
`GHG_sys_embodied_tonCO2yr`	Embodied emissions due to building construction and decommissioning or retrofit	float	`[ton CO2-eq/yr]`	{0.0…n}
`GHG_sys_uptake_kgCO2m2yr`	Embodied emissions per conditioned floor area due to building or retrofit construction and decommissioning	float	`[kg CO2-eq/m2.yr]`	{n…0.0}
`GHG_sys_uptake_tonCO2yr`	Carbon storage with in building materials due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{n…0.0}
`GHG_technical_system_tonCO2`	Embodied emissions of building technical systems due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{0.0…n}
`GHG_wall_tonCO2`	Embodied emissions of external walls due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{0.0…n}
`GHG_window_tonCO2`	Embodied emissions of windows due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{0.0…n}
`name`	Unique building ID. It must start with a letter.	string	`NA`	alphanumeric
`uptake_base_tonCO2`	Carbon storage with in the basement floor due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{n…0.0}
`uptake_floor_tonCO2`	Carbon storage with in the floors due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{n…0.0}
`uptake_part_tonCO2`	Carbon storage with in the indoor partition due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{n…0.0}
`uptake_roof_tonCO2`	Carbon storage with in the roof due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{n…0.0}
`uptake_wall_tonCO2`	Carbon storage with in the external walls due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{n…0.0}
`uptake_window_tonCO2`	Carbon storage with in the windows due to building construction or retrofit	float	`[ton CO2-eq/yr]`	{n…0.0}

`get_lca_mobility`

Path: outputs/data/emissions/Total_LCA_mobility.csv
File type: csv
Created by: emissions
Used by: (none)

Variable	Description	Type	Unit	Values
`GFA_m2`	Gross floor area	float	`[m2]`	{0.0…n}
`GHG_sys_mobility_kgCO2m2`	Operational emissions per unit of conditioned floor area due to mobility	float	`[kg CO2-eq/m2.yr]`	{0.0…n}
`GHG_sys_mobility_tonCO2`	Operational emissions due to mobility	float	`[ton CO2-eq/yr]`	{0.0…n}
`name`	Unique building ID. It must start with a letter.	string	`NA`	alphanumeric

`get_lca_operation`

Path: outputs/data/emissions/Total_LCA_operation.csv
File type: csv
Created by: emissions
Used by: (none)

Variable	Description	Type	Unit	Values
`COAL_hs_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the coal powererd heating system	float	`[kg/m2yr]`	{0.0…n}
`COAL_hs_ghg_ton`	Operational emissions of the coal powered heating system	float	`[ton/yr]`	{0.0…n}
`COAL_hs_nre_pen_GJ`	Operational primary energy demand (non-renewable) for coal powered heating system	float	`[GJ/yr]`	{0.0…n}
`COAL_hs_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the coal powered heating system	float	`[MJ/m2-yr]`	{0.0…n}
`COAL_ww_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the coal powered domestic hot water system	float	`[kg/m2 -yr]`	{0.0…n}
`COAL_ww_ghg_ton`	Operational emissions of the coal powered domestic hot water system	float	`[ton/yr]`	{0.0…n}
`COAL_ww_nre_pen_GJ`	Operational primary energy demand (non-renewable) for coal powered domestic hot water system	float	`[GJ/yr]`	{0.0…n}
`COAL_ww_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the coal powered domestic hot water system	float	`[MJ/m2-yr]`	{0.0…n}
`DC_cdata_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the district cooling for the data center	float	`[kg/m2 -yr]`	{0.0…n}
`DC_cdata_ghg_ton`	Operational emissions of the district cooling for the data center	float	`[ton/yr]`	{0.0…n}
`DC_cdata_nre_pen_GJ`	Operational primary energy demand (non-renewable) for district cooling system for cool room refrigeration	float	`[GJ/yr]`	{0.0…n}
`DC_cdata_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) for district cooling for cool room refrigeration	float	`[MJ/m2-yr]`	{0.0…n}
`DC_cre_ghg_kgm2`	Operational emissions per unit of conditioned floor area for district cooling system for cool room refrigeration	float	`[kg/m2yr]`	{0.0…n}
`DC_cre_ghg_ton`	Operational emissions for district cooling system for cool room refrigeration	float	`[ton/yr]`	{0.0…n}
`DC_cre_nre_pen_GJ`	Operational primary energy demand (non-renewable) for district cooling system for cool room refrigeration	float	`[GJ/yr]`	{0.0…n}
`DC_cre_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) for cool room refrigeration	float	`[MJ/m2-yr]`	{0.0…n}
`DC_cs_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the district cooling	float	`[kg/m2yr]`	{0.0…n}
`DC_cs_ghg_ton`	Operational emissions of the district cooling	float	`[ton/yr]`	{0.0…n}
`DC_cs_nre_pen_GJ`	Operational primary energy demand (non-renewable) for district cooling system	float	`[GJ/yr]`	{0.0…n}
`DC_cs_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the district cooling	float	`[MJ/m2-yr]`	{0.0…n}
`DH_hs_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the district heating system	float	`[kg/m2yr]`	{0.0…n}
`DH_hs_ghg_ton`	Operational emissions of the district heating system	float	`[ton/yr]`	{0.0…n}
`DH_hs_nre_pen_GJ`	Operational primary energy demand (non-renewable) for district heating system	float	`[GJ/yr]`	{0.0…n}
`DH_hs_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the district heating system	float	`[MJ/m2-yr]`	{0.0…n}
`DH_ww_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the district heating domestic hot water system	float	`[kg/m2yr]`	{0.0…n}
`DH_ww_ghg_ton`	Operational emissions of the district heating powered domestic hot water system	float	`[ton/yr]`	{0.0…n}
`DH_ww_nre_pen_GJ`	Operational primary energy demand (non-renewable) for district heating powered domestic hot water system	float	`[GJ/yr]`	{0.0…n}
`DH_ww_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the district heating domestic hot water system	float	`[MJ/m2-yr]`	{0.0…n}
`GFA_m2`	Gross floor area	float	`[m2]`	{0.0…n}
`GHG_sys_kgCO2m2`	Total operational emissions per unit of conditioned floor area	float	`[kg CO2-eq/m2.yr]`	{0.0…n}
`GHG_sys_tonCO2`	Total operational emissions	float	`[ton CO2-eq/yr]`	{0.0…n}
`GRID_ghg_kgm2`	Operational emissions per unit of conditioned floor area from grid electricity	float	`[kg/m2yr]`	{0.0…n}
`GRID_ghg_ton`	Operational emissions of the electrictiy from the grid	float	`[ton/yr]`	{0.0…n}
`GRID_nre_pen_GJ`	Operational primary energy demand (non-renewable) from the grid	float	`[GJ/yr]`	{0.0…n}
`GRID_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) from grid electricity	float	`[MJ/m2-yr]`	{0.0…n}
`name`	Unique building ID. It must start with a letter.	string	`NA`	alphanumeric
`NG_hs_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the natural gas powered heating system	float	`[kg/m2yr]`	{0.0…n}
`NG_hs_ghg_ton`	Operational emissions of the natural gas powered heating system	float	`[ton/yr]`	{0.0…n}
`NG_hs_nre_pen_GJ`	Operational primary energy demand (non-renewable) for natural gas powered heating system	float	`[GJ/yr]`	{0.0…n}
`NG_hs_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the natural gas powered heating system	float	`[MJ/m2-yr]`	{0.0…n}
`NG_ww_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the gas powered domestic hot water system	float	`[kg/m2yr]`	{0.0…n}
`NG_ww_ghg_ton`	Operational emissions of the solar powered domestic hot water system	float	`[ton/yr]`	{0.0…n}
`NG_ww_nre_pen_GJ`	Operational primary energy demand (non-renewable) for natural gas powered domestic hot water system	float	`[GJ/yr]`	{0.0…n}
`NG_ww_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the natural gas powered domestic hot water system	float	`[MJ/m2-yr]`	{0.0…n}
`OIL_hs_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the oil powered heating system	float	`[kg/m2yr]`	{0.0…n}
`OIL_hs_ghg_ton`	Operational emissions of the oil powered heating system	float	`[ton/yr]`	{0.0…n}
`OIL_hs_nre_pen_GJ`	Operational primary energy demand (non-renewable) for oil powered heating system	float	`[GJ/yr]`	{0.0…n}
`OIL_hs_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the oil powered heating system	float	`[MJ/m2-yr]`	{0.0…n}
`OIL_ww_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the oil powered domestic hot water system	float	`[kg/m2yr]`	{0.0…n}
`OIL_ww_ghg_ton`	Operational emissions of the oil powered domestic hot water system	float	`[ton/yr]`	{0.0…n}
`OIL_ww_nre_pen_GJ`	Operational primary energy demand (non-renewable) for oil powered domestic hot water system	float	`[GJ/yr]`	{0.0…n}
`OIL_ww_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the oil powered domestic hot water system	float	`[MJ/m2-yr]`	{0.0…n}
`PV_ghg_kgm2`	Operational emissions per unit of conditioned floor area for PV-System	float	`[kg/m2yr]`	{0.0…n}
`PV_ghg_ton`	Operational emissions of the PV-System	float	`[ton/yr]`	{0.0…n}
`PV_nre_pen_GJ`	Operational primary energy demand (non-renewable) for PV-System	float	`[GJ/yr]`	{0.0…n}
`PV_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) for PV System	float	`[MJ/m2-yr]`	{0.0…n}
`SOLAR_hs_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the solar powered heating system	float	`[kg/m2yr]`	{0.0…n}
`SOLAR_hs_ghg_ton`	Operational emissions of the solar powered heating system	float	`[ton/yr]`	{0.0…n}
`SOLAR_hs_nre_pen_GJ`	Operational primary energy demand (non-renewable) of the solar powered heating system	float	`[GJ/yr]`	{0.0…n}
`SOLAR_hs_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the solar powered heating system	float	`[MJ/m2-yr]`	{0.0…n}
`SOLAR_ww_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the solar powered domestic hot water system	float	`[kg/m2yr]`	{0.0…n}
`SOLAR_ww_ghg_ton`	Operational emissions of the solar powered domestic hot water system	float	`[ton/yr]`	{0.0…n}
`SOLAR_ww_nre_pen_GJ`	Operational primary energy demand (non-renewable) for solar powered domestic hot water system	float	`[GJ/yr]`	{0.0…n}
`SOLAR_ww_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the solar poweed domestic hot water system	float	`[MJ/m2-yr]`	{0.0…n}
`WOOD_hs_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the wood powered heating system	float	`[kg/m2yr]`	{0.0…n}
`WOOD_hs_ghg_ton`	Operational emissions of the wood powered heating system	float	`[ton/yr]`	{0.0…n}
`WOOD_hs_nre_pen_GJ`	Operational primary energy demand (non-renewable) for wood powered heating system	float	`[GJ/yr]`	{0.0…n}
`WOOD_hs_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the wood powered heating system	float	`[MJ/m2-yr]`	{0.0…n}
`WOOD_ww_ghg_kgm2`	Operational emissions per unit of conditioned floor area of the wood powered domestic hot water system	float	`[kg/m2yr]`	{0.0…n}
`WOOD_ww_ghg_ton`	Operational emissions of the wood powered domestic hot water system	float	`[ton/yr]`	{0.0…n}
`WOOD_ww_nre_pen_GJ`	Operational primary energy demand (non-renewable) for wood powered domestic hot water system	float	`[GJ/yr]`	{0.0…n}
`WOOD_ww_nre_pen_MJm2`	Operational primary energy demand per unit of conditioned floor area (non-renewable) of the wood powered domestic hot water system	float	`[MJ/m2-yr]`	{0.0…n}

`get_lca_operational_hourly_building`

Path: outputs/data/emissions/timeline/{building}_operational_hourly.csv
File type: csv
Created by: emission_time_dependent
Used by: (none)

Variable	Description	Type	Unit	Values
`E_sys_kgCO2`	hourly operational emission caused by satisfying electrical appliances demand.	float	`[kg CO2-eq]`	{0.0…n}
`hour`	hour of the year.	int	`[h]`	{0…n}
`Qcs_sys_kgCO2`	hourly operational emission caused by satisfying cooling demand.	float	`[kg CO2-eq]`	{0.0…n}
`Qhs_sys_kgCO2`	hourly operational emission caused by satisfying space heating demand.	float	`[kg CO2-eq]`	{0.0…n}
`Qww_sys_kgCO2`	hourly operational emission caused by satisfying hot water demand.	float	`[kg CO2-eq]`	{0.0…n}

`get_total_yearly_operational_building`

Path: outputs/data/emissions/timeline/Total_yearly_operational_building.csv
File type: csv
Created by: emissions
Used by: (none)

Variable	Description	Type	Unit	Values
`E_sys_kgCO2`	total hourly operational emission of all buildings caused by satisfying electrical appliances demand.	float	`[kg CO2-eq]`	{0.0…n}
`hour`	Hour of the year.	int	`[h]`	{0…8759}
`Qcs_sys_kgCO2`	total hourly operational emission of all buildings caused by satisfying cooling demand.	float	`[kg CO2-eq]`	{0.0…n}
`Qhs_sys_kgCO2`	total hourly operational emission of all buildings caused by satisfying space heating demand.	float	`[kg CO2-eq]`	{0.0…n}
`Qww_sys_kgCO2`	total hourly operational emission of all buildings caused by satisfying hot water demand.	float	`[kg CO2-eq]`	{0.0…n}

← Thermal Network Design | Glossary index | Energy Supply System Optimisation →

Source: view raw on GitHub ↗