Pressure Control¶

Physical Model¶

The pressure control component enforces a specific pressure at the controlled_junction. This is achieved by adding a required pressure lift or pressure drop between the from_junction and to_junction, so that controlled_p_bar will be reached at the controlled junction. The controlled junction can be identical to the to_junction to control the pressure directly at the outlet.

Internally, the behaviour is achieved by fixing the pressure variable at controlled_junction in the system matrix and keeping the pressure drop of the pressure control unit variable, so that is calculated during the Newton-Raphson-calculation.

Note

The temperature at the inlet and outlet junction will not be adapted by the pressure control unit. Therefore, these components usually operate isothermal (inlet temperature = outlet temperature). It is assumed that temperature changes due to compression or expansion (Joule-Thomson-effect) are balanced internally by adding or removing heat.

Warning

A sufficient hydraulic connection between from_junction, to_junction and controlled_junction is crucial for proper operation of this component. Hydraulically impossible configurations (e.g., if the controlled junction is on a different stub) or contradicting other pressure control units will lead to non-convergence of the pipeflow.

Create Function¶

For creating a single pressure control unit:

create_pressure_control(net, from_junction, to_junction, controlled_junction, controlled_p_bar, control_active=True, loss_coefficient=0.0, name=None, index=None, in_service=True, type='pressure_control', **kwargs)

Adds one pressure control that enforces a pressure at a specific junction.

The pressure control unit creates a pressure drop / lift between the ‘from’ and the ‘to’ junction so that the pressure set point at the controlled junction is met. It is required that the controlled junction is hydraulically properly connected to the from and to junction and no other pessure control unit is inbetween.

Parameters
• net (pandapipesNet) – The net for which this pressure control should be created

• from_junction (int) – ID of the junction on one side which the pressure control will be connected with

• to_junction (int) – ID of the junction on the other side which the pressure control will be connected with

• controlled_junction (int) – ID of the junction at which the pressure is controlled

• controlled_p_bar (float) – Pressure set point

• control_active (bool, default True) – Variable to state whether the pressure control is active (otherwise behaviour similar to open valve)

• loss_coefficient (float, default 0) – The pressure loss coefficient introduced by the component’s shape (used only if control is not active).

• name (str) – Name of the pressure control element

• 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 pressure control is in service or False if it is out of service

• type (str, default "pressure_control") – Currently not used - possibility to specify a certain type of pressure control

• kwargs (dict) – Additional keyword arguments will be added as further columns to the net[“press_control”] table

Returns

index - The unique ID of the created element

Return type

int

Example

Connect junction 0 and 1 and set the pressure at junction 1 to 5 bar.

>>> create_pressure_control(net, 0, 1, 1, controlled_p_bar=5)


For creating multiple pressure control units at once:

create_pressure_controls(net, from_junctions, to_junctions, controlled_junctions, controlled_p_bar, control_active=True, loss_coefficient=0.0, name=None, index=None, in_service=True, type='pressure_control', **kwargs)

Convenience function for creating many pressure controls at once. Parameters ‘from_junctions’ and ‘to_junctions’ must be arrays of equal length. Other parameters may be either arrays of the same length or single values.

Pressure control units enforce a pressure at a specific junction by creating a pressure drop / lift between the ‘from’ and the ‘to’ junction so that the pressure set point at the controlled junction is met. It is required that the controlled junction is hydraulically properly connected to the from and to junction and no other pessure control unit is inbetween.

Parameters
• net (pandapipesNet) – The net for which these pressure controls should be created

• from_junctions (Iterable(int)) – IDs of the junctions on one side which the pressure controls will be connected to

• to_junctions (Iterable(int)) – IDs of the junctions on the other side to which the pressure controls will be connected to

• controlled_junctions (Iterable or int) – IDs of the junctions at which the pressure is controlled

• controlled_p_bar (Iterable or float) – Pressure set points

• control_active (bool, default True) – Variable to state whether the pressure control is active (otherwise behaviour similar to open valve)

• loss_coefficient (float, default 0) – The pressure loss coefficient introduced by the component’s shape (used only if control is not active).

• name (Iterable or str) – Name of the pressure control elements

• index (Iterable(int), default None) – Force specified IDs if they are available. If None, the index one higher than the highest already existing index is selected and counted onwards.

• in_service (Iterable or bool, default True) – True if the pressure controls are in service or False if they are out of service

• type (Iterable or str, default "pressure_control") – Currently not used - possibility to specify a certain type of pressure control

• kwargs – Additional keyword arguments will be added as further columns to the net[“press_control”] table

Returns

index - The unique IDs of the created elements

Return type

array(int)

Example

Create one unit to connect junction 0 and 1, set the pressure at junction 1 to 5 bar.

And create a 2nd unit to connect junction 2 and 4, set the pressure at junction 3 to 4.9 bar.

>>> create_pressure_controls(net, [0, 2], [1, 4], [1, 3],
>>>                          controlled_p_bar=[5, 4.9])


Component Table Data¶

net.press_control

 Parameter Datatype Value Range Explanation net pandapipesNet The pandapipes net object in whose press_control table the new unit will be added from_junction integer $$>$$ 0 Index of junction at which the pressure control unit starts to_junction integer $$>$$ 0 Index of junction at which the pressure control unit ends controlled_junction integer > 0 ID of the junction at which the pressure is controlled controlled_p_bar float > 0 Pressure set point [barg] control_active boolean If false, the unit behaves like an open valve loss_coefficient float > ß Pressure loss coefficient (only effective if control is not active) name string Name of the pressure control unit index integer > 0 Force specific index the press_control-DataFrame, if available in_service boolean True / False If false, the unit behaves like a closed valve. type string Type variable to classify different kinds of pressure control units (not considered by pandapipes’ calculations)

Result Table Data¶

net.res_press_control

 Parameter Datatype Explanation p_from_bar float Pressure at “from”-junction [bar] p_to_bar float Pressure at “to”-junction [bar] t_from_k float Temperature at “from”-junction [K] t_to_k float Temperature at “to”-junction [K] mdot_to_kg_per_s float Mass flow out of pressure control unit [kg/s] mdot_from_kg_per_s float Mass flow into pressure control unit [kg/s] vdot_norm_m3_per_s float Norm volume flow [m^3/s] deltap_bar float Pressure difference between to- and from junction created by the pressure controller [bar]