GUIDEBOOK · GLOSSARY

Thermal Network Design

Thermal Network Design

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: 25


Files


get_network_energy_pumping_requirements_file

  • Path: outputs/data/thermal-network/DH__plant_pumping_load_kW.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
pressure_loss_return_kWpumping electricity required to overcome pressure losses in the return networkfloat[kWh]{0.0…n}
pressure_loss_substations_kWpumping electricity required to overcome pressure losses in the substationsfloat[kWh]{0.0…n}
pressure_loss_supply_kWpumping electricity required to overcome pressure losses in the supply networkfloat[kWh]{0.0…n}
pressure_loss_total_kWpumping electricity required to overcome pressure losses in the entire networkfloat[kWh]{0.0…n}

get_network_layout_edges_shapefile

  • Path: outputs/data/thermal-network/DH/edges.shp
  • File type: shp
  • Created by: network_layout
  • Used by: thermal_network
VariableDescriptionTypeUnitValues
geometryGeometryLineStringNA
length_mlength of this edgefloat[m]{0.0…n}
nameUnique network pipe ID.stringNAalphanumeric
pipe_DNClassifies nominal pipe diameters (DN) into typical bins.stringNAalphanumeric
type_matMaterial typestringNAalphanumeric

get_network_layout_nodes_shapefile

  • Path: outputs/data/thermal-network/DH/nodes.shp
  • File type: shp
  • Created by: network_layout
  • Used by: thermal_network
VariableDescriptionTypeUnitValues
BuildingUnique building ID. e.g. “B01”stringNAalphanumeric
geometryGeometryPointNA
nameUnique node ID. e.g. “NODE1”stringNAalphanumeric
TypeType of node.stringNA{PLANT, CONSUMER, NONE}

get_network_linear_pressure_drop_edges

  • Path: outputs/data/thermal-network/DH__linear_pressure_drop_edges_Paperm.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
PIPE0linear pressure drop in this pipe sectionfloat[Pa/m]{0.0…n}

get_network_linear_thermal_loss_edges_file

  • Path: outputs/data/thermal-network/DH__linear_thermal_loss_edges_Wperm.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
PIPE0linear thermal losses in this pipe sectionfloat[Wh/m]{0.0…n}

get_network_pressure_at_nodes

  • Path: outputs/data/thermal-network/DH__pressure_at_nodes_Pa.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
NODE0pressure at this nodefloat[Pa]{0.0…n}

get_network_temperature_plant

  • Path: outputs/data/thermal-network/DH__temperature_plant_K.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
temperature_return_KPlant return temperature at each time stepfloat[C]{0.0…n}
temperature_supply_KPlant supply temperature at each time stepfloat[C]{0.0…n}

get_network_temperature_return_nodes_file

  • Path: outputs/data/thermal-network/DH__temperature_return_nodes_K.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
NODE0Return temperature at node NODE0 (outlet temperature of NODE0) at each time stepfloat[C]{0.0…n}

get_network_temperature_supply_nodes_file

  • Path: outputs/data/thermal-network/DH__temperature_supply_nodes_K.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
NODE0Supply temperature at node NODE0 (inlet temperature of NODE0) at each time stepfloat[C]{0.0…n}

get_network_thermal_loss_edges_file

  • Path: outputs/data/thermal-network/DH__thermal_loss_edges_kW.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
PIPE0Thermal losses along pipe PIPE0 at each time stepfloat[kWh]{0.0…n}

get_network_total_pressure_drop_file

  • Path: outputs/data/thermal-network/DH__plant_pumping_pressure_loss_Pa.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: optimization
VariableDescriptionTypeUnitValues
pressure_loss_return_PaPressure losses in the return network at each time stepfloat[Pa]{0.0…n}
pressure_loss_substations_PaPressure losses in all substations at each time stepfloat[Pa]{0.0…n}
pressure_loss_supply_PaPressure losses in the supply network at each time stepfloat[Pa]{0.0…n}
pressure_loss_total_PaTotal pressure losses in the entire thermal network at each time stepfloat[Pa]{0.0…n}

get_network_total_thermal_loss_file

  • Path: outputs/data/thermal-network/DH__total_thermal_loss_edges_kW.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: optimization
VariableDescriptionTypeUnitValues
thermal_loss_return_kWThermal losses in the supply network at each time stepfloat[kWh]{0.0…n}
thermal_loss_supply_kWThermal losses in the return network at each time stepfloat[kWh]{0.0…n}
thermal_loss_total_kWThermal losses in the entire thermal network at each time stepfloat[kWh]{0.0…n}

get_nominal_edge_mass_flow_csv_file

  • Path: outputs/data/thermal-network/Nominal_EdgeMassFlow_at_design_{network_type}__kgpers.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: thermal_network
VariableDescriptionTypeUnitValues
PIPE0Mass flow rate in pipe PIPE0 at design operating conditionsfloat[kg/s]{0.0…n}

get_nominal_node_mass_flow_csv_file

  • Path: outputs/data/thermal-network/Nominal_NodeMassFlow_at_design_{network_type}__kgpers.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: thermal_network
VariableDescriptionTypeUnitValues
NODE0Mass flow rate in node NODE0 at design operating conditionsfloat[kg/s]{0.0…n}

get_thermal_demand_csv_file

  • Path: outputs/data/thermal-network/DH__thermal_demand_per_building_W.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
B01Thermal demand for building B01 at each simulation time stepfloat[Wh]{0.0…n}

get_thermal_network_edge_list_file

  • Path: outputs/data/thermal-network/DH__metadata_edges.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: optimization
VariableDescriptionTypeUnitValues
D_int_mInternal pipe diameter for the nominal diameterfloat[m]{0.0…n}
length_mLength of each pipe in the networkfloat[m]{0.0…n}
nameUnique network pipe ID.stringNAalphanumeric
pipe_DNNominal pipe diameter (e.g. DN100 refers to pipes of approx. 100 mm in diameter)int[-]{0…n}
type_matMaterial of the pipesstringNAalphanumeric

get_thermal_network_edge_node_matrix_file

  • Path: outputs/data/thermal-network/{network_type}__EdgeNode.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: thermal_network
VariableDescriptionTypeUnitValues
NODENames of the nodes in the networkstringNAalphanumeric
PIPE0Indicates the direction of flow of PIPE0 with respect to each node NODEn: if equal to PIPE0 and NODEn are not connected / if equal to 1 PIPE0 enters NODEn / if equal to -1 PIPE0 leaves NODEnint[-]{-1, 0, 1}

get_thermal_network_layout_massflow_edges_file

  • Path: outputs/data/thermal-network/DH__massflow_edges_kgs.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
PIPE0Mass flow rate in pipe PIPE0 at each time stepfloat[kg/s]{0.0…n}

get_thermal_network_layout_massflow_nodes_file

  • Path: outputs/data/thermal-network/DH__massflow_nodes_kgs.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
NODE0Mass flow rate in node NODE0 at each time stepfloat[kg/s]{0.0…n}

get_thermal_network_node_types_csv_file

  • Path: outputs/data/thermal-network/DH__metadata_nodes.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
BuildingUnique building ID. It must start with a letter.stringNAalphanumeric
nameUnique network node ID.stringNAalphanumeric
TypeType of node: “PLANT” / “CONSUMER” / “NONE” (if it is neither)stringNAalphanumeric

get_thermal_network_plant_heat_requirement_file

  • Path: outputs/data/thermal-network/DH__plant_thermal_load_kW.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
thermal_load_kWThermal load supplied by the plant at each time stepfloat[kWh]{0.0…n}

get_thermal_network_pressure_losses_edges_file

  • Path: outputs/data/thermal-network/DH__pressure_losses_edges_kW.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
PIPE0Pressure losses at pipe PIPE0 at each time stepfloat[kWh]{0.0…n}

get_thermal_network_substation_ploss_file

  • Path: outputs/data/thermal-network/DH__pumping_load_due_to_substations_kW.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
B01Pumping load at building substation B01 for each timestepfloat[kWh]{0.0…n}

get_thermal_network_substation_results_file

  • Path: outputs/data/thermal-network/DH/ww_only/DH_ww_only_substation_B001.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
dateDate and time in hourly intervalsdateNAYYYY-MM-DD
HEX_cdata_area_m2Heat exchanger area for data center cooling (DC only)float[m2]{0.0…n}
HEX_cre_area_m2Heat exchanger area for refrigeration (DC only)float[m2]{0.0…n}
HEX_cs_area_m2Heat exchanger area for space cooling (DC only)float[m2]{0.0…n}
HEX_hs_area_m2Heat exchanger area for space heating (DH only)float[m2]{0.0…n}
HEX_ww_area_m2Heat exchanger area for domestic hot water (DH only)float[m2]{0.0…n}
mdot_DC_result_kgpersSubstation flow rate on the DC side (DC only)float[kg/s]{0.0…n}
mdot_DH_result_kgpersSubstation flow rate on the DH side (DH only)float[kg/s]{0.0…n}
Qcdata_dc_WCooling from district cooling for data center (DC only)float[W]{0.0…n}
Qcre_dc_WCooling from district cooling for refrigeration (DC only)float[W]{0.0…n}
Qcs_dc_WCooling from district cooling for space cooling (DC only)float[W]{0.0…n}
Qhs_booster_WHeat from local booster for space heating (DH only, zero when district heating temperature is sufficient)float[W]{0.0…n}
Qhs_dh_WHeat from district heating for space heating (DH only, may be less than total if booster is used)float[W]{0.0…n}
Qww_booster_WHeat from local booster for domestic hot water (DH only, zero when district heating temperature is sufficient)float[W]{0.0…n}
Qww_dh_WHeat from district heating for domestic hot water (DH only, may be less than total if booster is used)float[W]{0.0…n}
T_return_DC_result_CSubstation return temperature of the district cooling network (DC only)float[C]{-273.15…n}
T_return_DH_result_CSubstation return temperature of the district heating network (DH only)float[C]{-273.15…n}
T_supply_DC_result_CSubstation supply temperature of the district cooling network (DC only)float[C]{-273.15…n}
T_supply_DH_result_CSubstation supply temperature of the district heating network (DH only)float[C]{-273.15…n}
T_target_dhw_CBuilding-side target supply temperature for domestic hot water (from HVAC assembly, non-zero only when booster is active)float[C]{0.0…n}
T_target_hs_CBuilding-side target supply temperature for space heating (from HVAC assembly, non-zero only when booster is active)float[C]{0.0…n}

get_thermal_network_velocity_edges_file

  • Path: outputs/data/thermal-network/DH__velocity_edges_mpers.csv
  • File type: csv
  • Created by: thermal_network
  • Used by: (none)
VariableDescriptionTypeUnitValues
PIPE0Flow velocity of heating/cooling medium in pipe PIPE0float[m/s]{0.0…n}

← Energy Demand Forecasting | Glossary index | Life Cycle Analysis (BETA) →

Source: view raw on GitHub ↗