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]