Circulation Pump Mass
Create Function
- create_circ_pump_const_mass_flow(net, return_junction, flow_junction, p_flow_bar, mdot_flow_kg_per_s, t_flow_k=None, type='auto', name=None, index=None, in_service=True, **kwargs)
Adds one circulation pump with a constant mass flow in table net[“circ_pump_mass”].
A circulation pump is a component that sets the pressure at its outlet (flow junction) and asserts that the correct mass flow is extracted at its inlet (return junction).
In this particular case, the mass flow and the pressure on the flow side are fixed, i.e. the pressure on the return side is just a result of the friction losses in the network. An equal representation is adding an external grid at the flow junction and a sink with the given mass flow at the return junction.
- Parameters:
net (pandapipesNet) – The net for which this pump should be created
return_junction (int) – ID of the junction on one side which the pump will be connected with
flow_junction (int) – ID of the junction on the other side which the pump will be connected with
p_flow_bar (float) – Pressure set point at the flow junction
mdot_flow_kg_per_s (float) – Constant mass flow, which is transported through the pump
t_flow_k (float, default None) – Temperature set point at the flow junction
name (str) – Name of the pump
index (int, default None) – Force a specified ID if it is available. If None, the index one higher than the highest already existing index is selected.
in_service (bool, default True) – True if the circulation pump is in service or False if it is out of service
type (str, default "auto") –
The pump type denotes the values that are fixed:
”auto”: Will automatically assign one of the following types based on the input for p_bar and t_k
”p”: The pressure is fixed.
”t”: The temperature is fixed and will not be solved. Please note that pandapipes cannot check for inconsistencies in the formulation of heat transfer equations yet.
”pt”: The pump shows both “p” and “t” behavior.
kwargs (dict) – Additional keyword arguments will be added as further columns to the net[“circ_pump_mass”] table
- Returns:
index - The unique ID of the created element
- Return type:
int
- Example:
>>> create_circ_pump_const_mass_flow(net, 0, 1, p_flow_bar=5, mdot_flow_kg_per_s=2, >>> t_flow_k=350, type="pt")
Component Table Data
net.circ_pump_mass
Parameter |
Datatype |
Value Range |
Explanation |
name |
string |
Name of the pump |
|
return_junction |
integer |
\(>\) 0 |
Index of junction on the return side (where the pump starts) |
flow_junction |
integer |
\(>\) 0 |
Index of junction on the flow side (where the pump ends) |
p_flow_bar |
float |
\(>\) 0 |
Pressure set point at the pump outlet (at flow side) [bar] |
mdot_flow_kg_per_s |
float |
\(>\) 0 |
Mass flow transported by the pump [kg/s] |
t_flow_k |
float |
\(>\) 0 |
Temperature set point (at flow side) [K] |
in_serivce |
boolean |
True / False |
True for in service or False for out of service |
type |
string |
Type variable to classify the pump |
Physical Model
The circulation pump is a component that controls the flow in a looped network. At its outlet (the flow side), it induces a pressure and temperature level just like an external grid. At the inlet (the return side), it induces a mass flow which should be the same as the mass flow into the system.
Result Table Data
net.circ_pump_mass
Parameter |
Datatype |
Explanation |
deltap_bar |
float |
The pressure lift caused by the pump [bar] |
mdot_flow_kg_per_s |
float |
The mass flow running through the pump [bar] |