Engee documentation

Pressure-Compensated Pump (IL)

A constant pressure pump with a variable working volume in an isothermal fluid network.

blockType: EngeeFluids.IsothermalLiquid.Turbomachinery.PressureCompensatedPump

pressure compensated pump il

Path in the library:

/Physical Modeling/Fluids/Isothermal Liquid/Pumps & Motors/Pressure-Compensated Pump (IL)

Description

Block Pressure-Compensated Pump (IL) simulates a pump with constant pressure and variable displacement in an isothermal fluid network. The change in working volume is regulated by the pressure drop measured between ports X and Y. When this pressure exceeds Set pressure differential, the change in working volume is adjusted according to Leakage and friction parameterization. The working volume is changed for pressures from the range specified by the parameter Pressure regulation range, between Maximum displacement for and Minimum displacement for .

The liquid flow can be directed from port A to port B (forward mode) or from port B to port A (reverse mode). Operation in the pump mode occurs when the pressure in the flow direction increases. The operation mode of the hydraulic motor is realized when the pressure in the flow direction is reduced.

The rotation of the shaft corresponds to the sign of the working volume of the liquid passing through the pump. A positive working volume corresponds to a positive rotation of the shaft in the forward mode. A negative working volume corresponds to a negative angular velocity of the shaft in the forward mode.

The operating modes are shown in the diagram.

variable displacement pump il 1

The unit has eight operating modes. The operating mode depends on the pressure drop from port A to port B , angular velocity and the working volume. In the diagram above, these modes are shown as octants of the diagram. :

  • Mode 1, Direct pump mode: the positive angular velocity of the shaft causes pressure to rise from port A to port B and flow from port A to port B.

  • Mode 2, reverse hydraulic motor mode: the flow from port B to port A causes a decrease in pressure from port B to port A and a negative angular velocity of the shaft.

  • Mode 3, Reverse pump mode: the negative angular velocity of the shaft causes pressure to rise from port B to port A and flow from port B to port A.

  • Mode 4, direct hydraulic motor mode: the flow from port A to port B causes a decrease in pressure from port A to port B and a positive angular velocity of the shaft.

  • Mode 5, reverse hydraulic motor mode: the flow from port B to port A causes a decrease in pressure from port B to port A and a positive angular velocity of the shaft.

  • Mode 6, Direct pump mode: the negative angular velocity of the shaft causes pressure to rise from port A to port B and flow from port A to port B.

  • Mode 7, direct hydraulic motor mode: the flow from port A to port B causes a decrease in pressure from port A to port B and a negative angular velocity of the shaft.

  • Mode 8, Reverse pump mode: The positive angular velocity of the shaft causes pressure to rise from port B to port A and flow from port B to port A.

The pump unit has analytical parameterization, tabular parameterization, and input parameterization. When using tabular data or an input signal for parameterization, you can select the pump operation characteristic based on efficiency or volume and mechanical losses.

In the parameterization options for the tabular data and the input signal, the threshold parameters are Pressure gain threshold for pump-motor transition and Angular velocity threshold for pump-motor transition The areas in which a numerically smoothed flow transition between pump operating modes can occur are determined. Select a transition region that provides some margin for the transition term, but which is small enough in terms of pressure and angular velocity not to affect the calculation results. For the working volume threshold, select a threshold value that is less than the typical working volume during normal operation.

Analytical parameterization of leakage and friction moment

If for the parameter Leakage and friction parameterization the value is set Analytical, then the unit calculates leakage and friction moment based on constant values of shaft rotation speed, pressure drop, mechanical and volumetric efficiency. The leakage rate, which depends on the pressure drop at the pump, is calculated as

where

  • ;

  • — the average density of the liquid;

  • — the Hagen—Poiseuille coefficient for calculating analytical losses:

    where

    • — parameter value Nominal displacement;

    • — parameter value Nominal shaft angular velocity;

    • — parameter value Volumetric efficiency at nominal conditions;

    • — parameter value Nominal pressure gain.

The moment of friction, which depends on the pressure drop in the pump, is calculated as

where

  • — parameter value No-load torque;

  • — the coefficient of dependence of the moment of friction on the pressure at the nominal working volume, which is determined based on the value of the parameter Mechanical efficiency at nominal conditions, :

    where — the moment of friction under nominal conditions:

  • — the angular velocity of the shaft, or .

Tabular parameterization

When using tabular data for pump efficiency or losses, data can be provided for one or more operating modes. The signs of the tabular data determine the operating mode of the block. If data is provided for less than eight operating modes, the block calculates additional data for another mode(s), expanding the specified data into the remaining octants.

Table data — parameterization of volumetric and mechanical efficiency coefficients_

If for the parameter Leakage and friction parameterization the value is set Tabulated data - volumetric and mechanical efficiencies, then the block performs parameterization based on tabular data for volumetric and mechanical efficiency.

The leakage rate is

where

  • ;

  • ;

  • — volumetric efficiency, which is interpolated based on tabular data provided by the user;

  • — a transitional member, represents

    where

    • ;

    • — parameter value Pressure gain threshold for pump-motor transition;

    • ;

    • — parameter value Angular velocity threshold for pump-motor transition.

The moment of friction is

where

  • ;

  • ;

  • — mechanical efficiency, which is interpolated based on tabular data provided by the user.

Table data — parameterization of volume and mechanical losses_

If for the parameter Leakage and friction parameterization the value is set Tabulated data - volumetric and mechanical losses, then the block performs parameterization based on tabular data for volume and mechanical losses.

The leakage rate is

where — parameter-based interpolation Volumetric loss table, q_loss(dp,w,D), which is based on data provided by the user about the pressure drop, the angular velocity of the shaft and the working volume of the liquid.

The friction moment of the shaft is

where — parameter-based interpolation Mechanical efficiency table, e_m(dp,w,D), which is based on data provided by the user about the pressure drop, the angular velocity of the shaft and the working volume of the liquid.

Parameterization via the input signal

If for the parameter Leakage and friction parameterization the value is set Input signal - volumetric and mechanical efficiencies, then ports EV and EM are enabled. Internal leakage and shaft friction are calculated in the same way as with parameterization Tabulated data - volumetric and mechanical efficiencies, except that the values of and They are delivered directly to the EV and EM ports, respectively.

If for the parameter Leakage and friction parameterization the value is set Input signal - volumetric and mechanical losses, then ports LV and LM are enabled. These ports receive the values of the leakage current and the moment of friction in the form of positive scalars. The leakage rate is calculated as

where

  • — volumetric leakage rate received at port LV;

  • — parameter value Pressure gain threshold for pump-motor transition.

The moment of friction is calculated as

where

  • — the moment of friction obtained in the port LM;

  • — parameter value Angular velocity threshold for pump-motor transition.

Volumetric and mechanical efficiency vary between user-defined minimum and maximum values. Any values below or above this range will take the minimum and maximum set values, respectively.

Pump operation

The pump consumption is

where .

The torque of the pump is

where .

The mechanical power developed by the pump shaft is

The hydraulic power of the pump is

If you need to find out if the block is working outside of the provided tabular data, you can set the parameter Check if operating beyond the range of supplied tabulated data meaning Error to stop the simulation in this case. When parameterizing by the input signal for volumetric or mechanical losses, you can receive notifications when the simulation goes beyond the operating modes of the motor using the parameter Check if operating beyond pump mode.

You can also control the pump’s functionality. Set for the parameter Check if pressures are less than pump minimum pressure meaning Error to stop the simulation when the outlet pressure is below the minimum setpoint.

Parameterization of the working volume change

The linear parameterization of the change in the working volume of the pump has the form:

where is the normalized pressure represents

where — this is the sum of the parameter values Set pressure differential and Pressure regulation range.

Dynamics of working volume changes

If the dynamics of the working volume change is simulated, then a delay is introduced into the flow response to the simulated control pressure. Pressure It becomes a dynamic control pressure , otherwise — this is steady-state pressure. The instantaneous change in dynamic control pressure is calculated based on a time constant Time constant, :

By default, the checkbox Displacement dynamics removed, and the dynamics of the working volume change is not modeled.

Numerically smoothed pressure

You can maintain numerical stability in the simulation by adjusting the parameter Smoothing factor. If for the parameter Smoothing factor If a non-zero value is set, the unit ensures a smooth pressure change between the values. and .

Ports

Conserving

# R — mechanical port
rotational mechanics

Details

The angular velocity of rotation and the torque of the shaft.

Program usage name

rod_flange

# C — mechanical port
rotational mechanics

Details

Angular velocity and body torque.

Program usage name

case_flange

# A — isothermal fluid port
isothermal liquid

Details

The liquid inlet or outlet port in the pump.

Program usage name

port_a

# B — isothermal fluid port
isothermal liquid

Details

The liquid inlet or outlet port in the pump.

Program usage name

port_b

# X — reference pressure , MPa
isothermal liquid

Details

Control pressure in the MPa. Control pressure compared with Set pressure differential to start or adjust the working volume of the pump.

Program usage name

port_x

# Y — reference pressure , MPa
isothermal liquid

Details

Control pressure in the MPa. Control pressure compared with Set pressure differential to start or adjust the working volume of the pump.

Program usage name

port_y

Input

# EV — volumetric EFFICIENCY
scalar

Details

Volumetric efficiency, set as a scalar. The value must be in the range of 0 before 1.

Dependencies

To use this port, set the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical efficiencies.

Data types

Float64
Complex numbers support

No

# EM — mechanical efficiency
scalar

Details

The mechanical efficiency of a hydraulic motor, set as a scalar. The value must be in the range of 0 before 1.

Dependencies

To use this port, set the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical efficiencies.

Data types

Float64
Complex numbers support

No

# LV — volumetric leakage rate, m3/s
scalar

Details

Pump losses in m3/s, given as a scalar.

Dependencies

To use this port, set the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical losses.

Data types

Float64
Complex numbers support

No

# LM — moment of friction, NM
scalar

Details

The mechanical losses of the pump in nm, given as a scalar.

Dependencies

To use this port, set the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical losses.

Data types

Float64
Complex numbers support

No

Parameters

Pump

# Leakage and friction parameterization — method for calculating leakage rate and friction moment
Analytical | Tabulated data - volumetric and mechanical efficiencies | Tabulated data - volumetric and mechanical losses | Input signal - volumetric and mechanical efficiencies | Input signal - volumetric and mechanical losses

Details

Parameterization of pump leakage and friction characteristics.

  • Analytical — the leakage rate and the friction moment are calculated using analytical equations.

  • Tabulated data - volumetric and mechanical efficiencies — volumetric and mechanical efficiency are calculated according to user-defined parameters Pressure gain vector, dp, Shaft angular velocity vector, w and Displacement vector, D and are interpolated based on the corresponding three-dimensional tables. Volumetric efficiency table, e_v(dp,w,D) and Mechanical efficiency table, e_m(dp,w,D).

  • Tabulated data - volumetric and mechanical losses — leakage flow rate and friction moment are calculated according to user-defined parameters Pressure gain vector, dp, Shaft angular velocity vector, w and Displacement vector, D and are interpolated based on the corresponding three-dimensional tables. Volumetric loss table, q_loss(dp,w,D) and Mechanical loss table, torque_loss(dp,w,D).

  • Input signal - volumetric and mechanical efficiencies — Volumetric and mechanical efficiency are transmitted as signals to the EV and EM ports, respectively.

  • Input signal - volumetric and mechanical losses — the leakage flow rate and the friction moment are sent as signals to the ports LV and LM, respectively.

Values

Analytical | Tabulated data - volumetric and mechanical efficiencies | Tabulated data - volumetric and mechanical losses | Input signal - volumetric and mechanical efficiencies | Input signal - volumetric and mechanical losses
Default value

Analytical
Program usage name

leakage_and_friction_parameterization
Evaluatable

No

# Nominal displacement — nominal working volume
m^3/rad | mm^3/rad | cm^3/rad | km^3/rad | m^3/deg | cm^3/rev | m^3/rev | l/rad | l/rev | in^3/rad | ft^3/rad | gal/rad | igal/rad | in^3/deg | in^3/rev | gal/rev

Details

The amount of liquid displaced by the pump under nominal operating conditions.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Analytical.

Units

m^3/rad | mm^3/rad | cm^3/rad | km^3/rad | m^3/deg | cm^3/rev | m^3/rev | l/rad | l/rev | in^3/rad | ft^3/rad | gal/rad | igal/rad | in^3/deg | in^3/rev | gal/rev
Default value

30.0 cm^3/rev
Program usage name

nominal_displacement
Evaluatable

Yes

# Nominal shaft angular velocity — nominal angular velocity of the shaft
rad/s | deg/s | rad/min | deg/min | rpm | rps

Details

Angular velocity of the shaft under nominal operating conditions.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Analytical.

Units

rad/s | deg/s | rad/min | deg/min | rpm | rps
Default value

1800.0 rpm
Program usage name

w_nominal
Evaluatable

Yes

# Nominal pressure gain — nominal pressure increase between liquid inlet and outlet
Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg

Details

Increasing the pressure between the pump inlet and outlet under nominal operating conditions.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Analytical.

Units

Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg
Default value

10.0 MPa
Program usage name

p_nominal
Evaluatable

Yes

# Volumetric efficiency at nominal conditions — volumetric EFFICIENCY

Details

The ratio of the actual flow rate to the ideal flow rate under nominal conditions.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Analytical.

Default value

0.92
Program usage name

nominal_volumetric_efficiency
Evaluatable

Yes

# Mechanical efficiency at nominal conditions — mechanical efficiency under nominal conditions

Details

The ratio of the actual torque to the ideal torque generated under rated conditions.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Analytical.

Default value

0.88
Program usage name

nominal_mechanical_efficiency
Evaluatable

Yes

# No-load torque — moment of friction at rest
N*m | uN*m | mN*m | kN*m | MN*m | GN*m | kgf*m | lbf*in | lbf*ft

Details

The minimum amount of torque to overcome the friction of the seal and causing the shaft to move.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Analytical.

Units

N*m | uN*m | mN*m | kN*m | MN*m | GN*m | kgf*m | lbf*in | lbf*ft
Default value

0.0 N*m
Program usage name

no_load_torque
Evaluatable

Yes

# Check if pressures are less than pump minimum pressure — a message about low liquid pressure at the pump outlet
None | Error

Details

Select a value Error to stop the simulation when the outlet pressure drops below the minimum setpoint.

This parameter helps to identify potential conditions for cavitation when the liquid pressure drops below the vapor pressure of the liquid.

Values

None | Error
Default value

None
Program usage name

pressure_assert_action
Evaluatable

No

# Pressure gain vector, dp — vector of pressure increase values for tabular parameterization
Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg

Details

A vector of pressure increase values for tabular parameterization of leaks and torque friction. This vector corresponds to the vectors Shaft angular velocity vector, w and Displacement vector, D and tables Volumetric efficiency table, e_v(dp,w,D) or Mechanical efficiency table, e_m(dp,w,D). The elements of the vector must be listed in ascending order.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Tabulated data - volumetric and mechanical efficiencies or Tabulated data - volumetric and mechanical losses.

Units

Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg
Default value

[0.1, 1.0, 2.0] MPa
Program usage names

delta_p_vector_efficiency, delta_p_vector_loss
Evaluatable

Yes

# Shaft angular velocity vector, w — vector of angular velocity values for tabular parameterization
rad/s | deg/s | rad/min | deg/min | rpm | rps

Details

A vector of angular velocity values for tabular parameterization of leakage and friction moment. This vector corresponds to the vectors Pressure gain vector, dp and Displacement vector, D and tables Volumetric efficiency table, e_v(dp,w,D) or Mechanical efficiency table, e_m(dp,w,D). The elements of the vector must be listed in ascending order.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Tabulated data - volumetric and mechanical efficiencies or Tabulated data - volumetric and mechanical losses.

Units

rad/s | deg/s | rad/min | deg/min | rpm | rps
Default value

[250.0, 500.0, 1000.0, 2000.0, 3000.0, 4000.0] rpm
Program usage names

w_vector_efficiency, w_vector_loss
Evaluatable

Yes

# Displacement vector, D — vector of working volume values for tabular parameterization
m^3/rad | mm^3/rad | cm^3/rad | km^3/rad | m^3/deg | cm^3/rev | m^3/rev | l/rad | l/rev | in^3/rad | ft^3/rad | gal/rad | igal/rad | in^3/deg | in^3/rev | gal/rev

Details

A vector of working volume values for tabular parameterization of leakage and friction moment. This vector corresponds to the vectors Pressure gain vector, dp and Shaft angular velocity vector, w and tables Volumetric efficiency table, e_v(dp,w,D) or Mechanical efficiency table, e_m(dp,w,D). The elements of the vector must be listed in ascending order.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Tabulated data - volumetric and mechanical efficiencies or Tabulated data - volumetric and mechanical losses.

Units

m^3/rad | mm^3/rad | cm^3/rad | km^3/rad | m^3/deg | cm^3/rev | m^3/rev | l/rad | l/rev | in^3/rad | ft^3/rad | gal/rad | igal/rad | in^3/deg | in^3/rev | gal/rev
Default value

[-30.0, -19.0, 19.0, 30.0] cm^3/rev
Program usage names

displacement_vector_efficiency, displacement_vector_loss
Evaluatable

Yes

# Volumetric efficiency table, e_v(dp,w,D) — volume efficiency table

Details

Array on on volumetric efficiency at a given pressure drop of the liquid, the angular velocity of the shaft and the working volume. The block uses linear interpolation between the table elements.

Values , and — these are the sizes of the corresponding vectors:

  • — the number of vector elements in the parameter Pressure gain vector, dp;

  • — the number of vector elements in the parameter Shaft angular velocity vector, w;

  • — the number of vector elements in the parameter Displacement vector, D.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Tabulated data - volumetric and mechanical efficiencies.

Default value

[0.816 0.908 0.954 0.977 0.981 0.984; 0.325 0.663 0.831 0.916 0.925 0.946; 0.137 0.568 0.78 0.892 0.893 0.91;;; 0.816 0.908 0.954 0.977 0.981 0.984; 0.325 0.663 0.831 0.916 0.925 0.946; 0.137 0.568 0.78 0.892 0.893 0.91;;; 0.816 0.908 0.954 0.977 0.981 0.984; 0.325 0.663 0.831 0.916 0.925 0.946; 0.137 0.568 0.78 0.892 0.893 0.91;;; 0.816 0.908 0.954 0.977 0.981 0.984; 0.325 0.663 0.831 0.916 0.925 0.946; 0.137 0.568 0.78 0.892 0.893 0.91]
Program usage name

volumetric_efficiency_matrix
Evaluatable

Yes

# Mechanical efficiency table, e_m(dp,w,D) — table of mechanical efficiencies

Details

Array on on mechanical efficiency at a given pressure drop of the liquid, the angular velocity of the shaft and the working volume. The block uses linear interpolation between table elements.

Values , and — these are the sizes of the corresponding vectors:

  • — the number of vector elements in the parameter Pressure gain vector, dp;

  • — the number of vector elements in the parameter Shaft angular velocity vector, w;

  • — the number of vector elements in the parameter Displacement vector, D.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Tabulated data - volumetric and mechanical efficiencies.

Default value

[0.996 0.996 0.996 0.996 0.996 0.996; 0.988 0.989 0.989 0.989 0.989 0.99; 0.981 0.981 0.982 0.982 0.983 0.984;;; 0.996 0.996 0.996 0.996 0.996 0.996; 0.988 0.989 0.989 0.989 0.989 0.99; 0.981 0.981 0.982 0.982 0.983 0.984;;; 0.996 0.996 0.996 0.996 0.996 0.996; 0.988 0.989 0.989 0.989 0.989 0.99; 0.981 0.981 0.982 0.982 0.983 0.984;;; 0.996 0.996 0.996 0.996 0.996 0.996; 0.988 0.989 0.989 0.989 0.989 0.99; 0.981 0.981 0.982 0.982 0.983 0.984]
Program usage name

mechanical_efficiency_matrix
Evaluatable

Yes

# Pressure gain threshold for pump-motor transition — threshold pressure for the transition mode
Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg

Details

The pressure increase threshold for switching between pump and hydraulic motor operation modes. The transition area is defined in the area of 0 MPa is between the positive and negative values of the threshold pressure drop. Within this area, the calculated leakage rate and friction moment are adjusted according to the transition term to ensure a smooth transition from one mode to another.

Dependencies

To use this parameter, set for Leakage and friction parameterization one of the values is:

  • Tabulated data - volumetric and mechanical efficiencies;

  • Input signal - volumetric and mechanical efficiencies;

  • Input signal - volumetric and mechanical losses.

Units

Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg
Default value

0.001 MPa
Program usage name

p_threshold
Evaluatable

Yes

# Angular velocity threshold for pump-motor transition — threshold angular velocity for the transition mode
rad/s | deg/s | rad/min | deg/min | rpm | rps

Details

The threshold value of the angular velocity for switching between the operating modes of the pump and the hydraulic motor. The transition area is defined around 0 rpm is between the positive and negative values of the threshold angular velocity. Within this area, the calculated leakage rate and friction moment are adjusted according to the transition term to ensure a smooth transition from one mode to another.

Dependencies

To use this parameter, set for Leakage and friction parameterization one of the values is:

  • Tabulated data - volumetric and mechanical efficiencies;

  • Input signal - volumetric and mechanical efficiencies;

  • Input signal - volumetric and mechanical losses.

Units

rad/s | deg/s | rad/min | deg/min | rpm | rps
Default value

100.0 rpm
Program usage name

w_threshold
Evaluatable

Yes

# Check if operating beyond the range of supplied tabulated data — a message about going beyond the limits of the provided data
None | Error

Details

Select a value Error to stop the simulation when the block uses values outside the provided data range.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization one of the values is:

  • Tabulated data - volumetric and mechanical efficiencies;

  • Tabulated data - volumetric and mechanical losses.

Values

None | Error
Default value

None
Program usage name

supplied_range_assert_action
Evaluatable

No

# Volumetric loss table, q_loss(dp,w,D) — volume loss table
m^3/s | mm^3/s | cm^3/s | m^3/hr | m^3/min | l/hr | l/min | l/s | gal/hr | gal/min | gal/s | ft^3/hr | ft^3/min | ft^3/s

Details

Array on on volume losses at a given pressure drop of the liquid, the angular velocity of the shaft and the working volume. The block uses linear interpolation between the table elements.

Values , and — these are the sizes of the corresponding vectors:

  • — the number of vector elements in the parameter Pressure gain vector, dp;

  • — the number of vector elements in the parameter Shaft angular velocity vector, w;

  • — the number of vector elements in the parameter Displacement vector, D.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Tabulated data - volumetric and mechanical losses.

Units

m^3/s | mm^3/s | cm^3/s | m^3/hr | m^3/min | l/hr | l/min | l/s | gal/hr | gal/min | gal/s | ft^3/hr | ft^3/min | ft^3/s
Default value

[2.3e-5 2.3e-5 2.3e-5 2.3e-5 2.85e-5 3.2e-5; 8.44e-5 8.42e-5 8.450000000000001e-5 8.400000000000001e-5 0.00011250000000000001 0.000108; 0.0001079 0.000108 0.00011 0.000108 0.0001605 0.00017999999999999998;;; 2.3e-5 2.3e-5 2.3e-5 2.3e-5 2.85e-5 3.2e-5; 8.44e-5 8.42e-5 8.450000000000001e-5 8.400000000000001e-5 0.00011250000000000001 0.000108; 0.0001079 0.000108 0.00011 0.000108 0.0001605 0.00017999999999999998;;; 2.3e-5 2.3e-5 2.3e-5 2.3e-5 2.85e-5 3.2e-5; 8.44e-5 8.42e-5 8.450000000000001e-5 8.400000000000001e-5 0.00011250000000000001 0.000108; 0.0001079 0.000108 0.00011 0.000108 0.0001605 0.00017999999999999998;;; 2.3e-5 2.3e-5 2.3e-5 2.3e-5 2.85e-5 3.2e-5; 8.44e-5 8.42e-5 8.450000000000001e-5 8.400000000000001e-5 0.00011250000000000001 0.000108; 0.0001079 0.000108 0.00011 0.000108 0.0001605 0.00017999999999999998] m^3/s
Program usage name

volumetric_loss_matrix
Evaluatable

Yes

# Mechanical loss table, torque_loss(dp,w,D) — table of mechanical losses
N*m | uN*m | mN*m | kN*m | MN*m | GN*m | kgf*m | lbf*in | lbf*ft

Details

Array on on mechanical losses at a given pressure drop of the liquid, the angular velocity of the shaft and the working volume. The block uses linear interpolation between table elements.

Values , and — these are the sizes of the corresponding vectors:

  • — the number of vector elements in the parameter Pressure gain vector, dp;

  • — the number of vector elements in the parameter Shaft angular velocity vector, w;

  • — the number of vector elements in the parameter Displacement vector, D.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Tabulated data - volumetric and mechanical losses.

Units

N*m | uN*m | mN*m | kN*m | MN*m | GN*m | kgf*m | lbf*in | lbf*ft
Default value

[0.002 0.002 0.002 0.002 0.002 0.002; 0.0607 0.0556 0.0556 0.0556 0.0556 0.0505; 0.1937 0.1937 0.1833 0.1833 0.1729 0.1626;;; 0.002 0.002 0.002 0.002 0.002 0.002; 0.0607 0.0556 0.0556 0.0556 0.0556 0.0505; 0.1937 0.1937 0.1833 0.1833 0.1729 0.1626;;; 0.002 0.002 0.002 0.002 0.002 0.002; 0.0607 0.0556 0.0556 0.0556 0.0556 0.0505; 0.1937 0.1937 0.1833 0.1833 0.1729 0.1626;;; 0.002 0.002 0.002 0.002 0.002 0.002; 0.0607 0.0556 0.0556 0.0556 0.0556 0.0505; 0.1937 0.1937 0.1833 0.1833 0.1729 0.1626] N*m
Program usage name

mechanical_loss_matrix
Evaluatable

Yes

# Minimum volumetric efficiency — minimum value of volumetric efficiency

Details

The minimum value of volumetric efficiency. If the input signal is below this value, the volumetric efficiency is set to the minimum volumetric efficiency value.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical efficiencies.

Default value

0.001
Program usage name

min_volumetric_efficiency
Evaluatable

Yes

# Maximum volumetric efficiency — the maximum value of volumetric efficiency

Details

The maximum value of volumetric efficiency. If the input signal exceeds this value, the volumetric efficiency is set to the maximum value of the volumetric efficiency.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical efficiencies.

Default value

1.0
Program usage name

max_volumetric_efficiency
Evaluatable

Yes

# Minimum mechanical efficiency — minimum value of mechanical efficiency

Details

The minimum value of mechanical efficiency. If the input signal is below this value, the mechanical efficiency is set to the minimum value of the mechanical efficiency.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical efficiencies.

Default value

0.001
Program usage name

min_mechanical_efficiency
Evaluatable

Yes

# Maximum mechanical efficiency — maximum value of mechanical efficiency

Details

The maximum value of mechanical efficiency. If the input signal is higher than this value, the mechanical efficiency is set to the maximum value of the mechanical efficiency.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical efficiencies.

Default value

1.0
Program usage name

max_mechanical_efficiency
Evaluatable

Yes

# Check if operating beyond pump mode — a message about the operation of the unit outside the pump mode
None | Error

Details

Select a value Error to stop the simulation when the unit is operating in direct or reverse hydraulic motor modes.

Dependencies

To use this parameter, set for the parameter Leakage and friction parameterization meaning Input signal - volumetric and mechanical losses.

Values

None | Error
Default value

None
Program usage name

operating_mode_assert_action
Evaluatable

No

Pressure Compensation

# Maximum displacement — the upper limit of the pump’s working volume value
m^3/rad | mm^3/rad | cm^3/rad | km^3/rad | m^3/deg | cm^3/rev | m^3/rev | l/rad | l/rev | in^3/rad | ft^3/rad | gal/rad | igal/rad | in^3/deg | in^3/rev | gal/rev

Details

The upper limit of the pump’s working volume.

Units

m^3/rad | mm^3/rad | cm^3/rad | km^3/rad | m^3/deg | cm^3/rev | m^3/rev | l/rad | l/rev | in^3/rad | ft^3/rad | gal/rad | igal/rad | in^3/deg | in^3/rev | gal/rev
Default value

30.0 cm^3/rev
Program usage name

max_displacement
Evaluatable

Yes

# Minimum displacement — lower limit of the pump’s working volume value
m^3/rad | mm^3/rad | cm^3/rad | km^3/rad | m^3/deg | cm^3/rev | m^3/rev | l/rad | l/rev | in^3/rad | ft^3/rad | gal/rad | igal/rad | in^3/deg | in^3/rev | gal/rev

Details

The lower limit of the pump’s working volume.

Units

m^3/rad | mm^3/rad | cm^3/rad | km^3/rad | m^3/deg | cm^3/rev | m^3/rev | l/rad | l/rev | in^3/rad | ft^3/rad | gal/rad | igal/rad | in^3/deg | in^3/rev | gal/rev
Default value

0.1 cm^3/rev
Program usage name

min_displacement
Evaluatable

Yes

# Set pressure differential — threshold value for regulating the working volume of the pump
Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg

Details

The threshold value of the pressure drop, after which the operating volume of the pump is adjusted.

Units

Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg
Default value

10.0 MPa
Program usage name

delta_p_set
Evaluatable

Yes

# Pressure regulation range — operating pressure range
Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg

Details

The operating pressure range of the pump volume control. The pump operates in the range between Set pressure differential and the maximum pump pressure, which is .

Units

Pa | uPa | hPa | kPa | MPa | GPa | kgf/m^2 | kgf/cm^2 | kgf/mm^2 | mbar | bar | kbar | atm | ksi | psi | mmHg | inHg
Default value

0.6 MPa
Program usage name

p_regulation_range
Evaluatable

Yes

# Smoothing factor — numerical smoothing factor

Details

The continuous smoothing coefficient, which ensures a smooth pressure change between the values and .

Default value

0.01
Program usage name

smoothing_factor
Evaluatable

Yes

# Displacement dynamics — should the reaction of the flow to a change in the working volume be taken into account?

Details

Is it necessary to take into account the transient effects in the fluid system caused by a change in the working volume? Check the box Displacement dynamics approximates a change in the opening conditions by introducing a first-order delay into the flow response. Parameter Time constant It also affects the simulated opening dynamics.

Default value

false (switched off)
Program usage name

displacement_dynamics
Evaluatable

No

# Time constant — the time constant
s | ns | us | ms | min | hr | d

Details

A constant that determines the time it takes for a liquid to reach a steady state when the working volume changes. This parameter affects the modeling of the dynamics of the working volume change.

Dependencies

To use this option, check the box Displacement dynamics.

Units

s | ns | us | ms | min | hr | d
Default value

0.1 s
Program usage name

tau
Evaluatable

Yes