Package HydraulicsByFluidon.​Components.​Valves.​DirectionalValves
Icon for standard packages

Information

Standard package icon.

Extends from Modelica.​Icons.​Package (Icon for standard packages).

Package Contents

NameDescription
LSDirectionalValves 
PropValve22PT2 
PropValve22PT2TableAx 
PropValve22PT2TableQpx 
PropValve33PT2 
PropValve33PT2TableAx 
PropValve33PT2TableQpx 
PropValve43PT2 
PropValve43PT2TableAx 
PropValve43PT2TableQpx 
PropValve63PT2 
SwitchingValve22 
SwitchingValve33 
SwitchingValve43 

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​SwitchingValve22

Information

The component SwitchingValve22 is a model of a 2-way valve which will open for input signals equal or above Input threshold to open the valve.

Opening and closing times of the valve are set by Time to close 100 % - 0 %/Time to open 0 % - 100 %, the movement is linear with constant speed until the respective end stop is reached.

The valve stroke can be shifted by Relative overlap. In accordance with common valve parameters a negative overlap will open the valve edge.

The default relationship between input signal and flow rate of the metering edge is linear, but can be changed through the use of a 1D look-up table. The look-up table is provided either manually or by importing a text file. If the parameter Table is provided by file is set to false, the manually entered datapoints from Manually provided look-up table will be used. If it is set to true, the table Table name on file from the file File where look-up table is stored will be utilized.

The text file must follow a specific syntax such that it can be read by Modelica. The input values as well as the output values must lie within the range from 0 to 1. An output value of 1 (100 %) corresponds to a fully-opened metering edge. An example for a properly formatted text file with two tables is given in the figure below:

A table is declared by its datatype (e. g. double), followed by the table name (e. g. tab1) and its dimensions in brackets (e. g. (5,2)). As can be seen, multiple tables can be defined in the same text file. The table declaration is followed by the actual data. The first column of the table represents the input of the 1D table, whereas the second column lists the corresponding output values. The input values of the table must be in increasing order. The component interpolates linearly between the listed input values. More information regarding the format of tables can be found at CombiTable1D.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve22 and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x2.

Parameters

TypeNameDefaultDescription
RealSwitchingThreshold0.5input threshold to open the valve
TimeTopen0.1Time to open 0 % - 100 %
TimeTclose0.1Time to close 100 % - 0 %
BooleanenableStrokeOutfalseEnable Stroke Output
VolumeFlowRateNominalVolumeFlow5e-4Nominal volume flow
PressureNominalPressureDifference500000Nominal pressure difference
DensityReferenceDensity860Reference density for volume flow and pressure difference
DimensionlessRatioOverlap0Valve edge relative overlap
BooleantableFromFilefalseTable is provided by file
StringfileName"NoFile"File where look-up table is stored
StringtableName"NoTable"Table name on file
RealmanualTable[:,:][0,0; 1,1]Manually provided look-up table
VolumeFlowRateZeroVolumeFlow0Volume flow due to leakage
PressureZeroFlowPressureDifference500000Pressure difference for leakage flow
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportPHydraulic port P
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​SwitchingValve33

Information

The component SwitchingValve33 is a model of a 3-way valve where the flow (at 100 % valve stroke) is set by NominalVolumeFlow and NominalPressureDifference.

For Input ≥ Input threshold to open the valve the valve switches in positive direction up to right position, for Input ≤ - Input threshold to open the valve the valve switches in negative direction up to left position. For - Input threshold to open the valve < Input < Input threshold to open the valve it switches into resting position (middle position).

The opening of the valve lasts always <>Time to open 0 % - 100 %<>, the closing always <>Time to close 100 % - 0 %<>, i. e. the switching from one end stop position to the other lasts <>Time to close 100 % - 0 %<> + <>Time to open 0 % - 100 %<>.

The valve stroke can be shifted by Valve edge general relative overlap. In accordance with common valve parameters a negative overlap will open the valve edge. Valve edge general relative overlap is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Valve edge PA relative overlap is set to a value different from 0, then Valve edge general relative overlap is ignored and the individual overlaps are used.

The default relationship between input signal and flow rate of the metering edge is linear, but can be changed through the use of a 1D look-up table. The look-up table is provided either manually or by importing a text file. If the parameter Table is provided by file is set to false, the manually entered datapoints from Manually provided look-up table will be used. If it is set to true, the table Table name on file from the file File where look-up table is stored will be utilized.

The text file must follow a specific syntax such that it can be read by Modelica. The input values as well as the output values must lie within the range from 0 to 1. An output value of 1 (100 %) corresponds to a fully-opened metering edge. An example for a properly formatted text file with two tables is given in the figure below:

A table is declared by its datatype (e. g. double), followed by the table name (e. g. tab1) and its dimensions in brackets (e. g. (5,2)). As can be seen, multiple tables can be defined in the same text file. The table declaration is followed by the actual data. The first column of the table represents the input of the 1D table, whereas the second column lists the corresponding output values. The input values of the table must be in increasing order. The component interpolates linearly between the listed input values. More information regarding the format of tables can be found at CombiTable1D.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve33 and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x3.

Parameters

TypeNameDefaultDescription
RealSwitchingThreshold0.5input threshold to open the valve
TimeTopen0.1Time to open 0 % - 100 %
TimeTclose0.1Time to close 100 % - 0 %
BooleanenableStrokeOutfalseEnable Stroke Output
VolumeFlowRateNominalVolumeFlow5e-4Nominal volume flow
PressureNominalPressureDifference500000Nominal pressure difference
DensityReferenceDensity860Reference density for volume flow and pressure difference
DimensionlessRatioOverlap0Valve edge general relative overlap
DimensionlessRatioOverlapPA0Valve edge PA relative overlap
DimensionlessRatioQFactorPA1Factor for edge PA specific flow adjustment
BooleantableFromFilePAfalseTable is provided by file
StringfileNamePA"NoFile"File where look-up table is stored
StringtableNamePA"NoTable"Table name on file
RealmanualTablePA[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
DimensionlessRatioOverlapAT0Valve edge AT relative overlap
DimensionlessRatioQFactorAT1Factor for edge AT specific flow adjustment
BooleantableFromFileATfalseTable is provided by file
StringfileNameAT"NoFile"File where look-up table is stored
StringtableNameAT"NoTable"Table name on file
RealmanualTableAT[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
VolumeFlowRateZeroVolumeFlow0Volume flow due to leakage
PressureZeroFlowPressureDifference500000Pressure difference for leakage flow
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportPHydraulic port P
FluidPortportTHydraulic port T
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​SwitchingValve43

Information

The component SwitchingValve43 is a model of a 3-way valve where the flow (at 100 % valve stroke) is set by Nominal volume flow and Nominal pressure difference.

For Input ≥ Input threshold to open the valve the valve switches in positive direction up to right position, for Input ≤ - Input threshold to open the valve the valve switches in negative direction up to left position. For - Input threshold to open the valve < Input < Input threshold to open the valve it switches into resting position (middle position).

The opening of the valve lasts always Time to open 0 % - 100 %, the closing always Time to close 100 % - 0 %, i. e. the switching from one end stop position to the other lasts Time to close 100 % - 0 % + Time to open 0 % - 100 %.

The valve stroke can be shifted by Valve edge general relative overlap. In accordance with common valve parameters a negative overlap will open the valve edge. Valve edge general relative overlap is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Valve edge PA relative overlap is set to a value different from 0, then Valve edge general relative overlap is ignored and the individual overlaps are used.

The default relationship between input signal and flow rate of the metering edge is linear, but can be changed through the use of a 1D look-up table. The look-up table is provided either manually or by importing a text file. If the parameter Table is provided by file is set to false, the manually entered datapoints from Manually provided look-up table will be used. If it is set to true, the table Table name on file from the file File where look-up table is stored will be utilized.

The text file must follow a specific syntax such that it can be read by Modelica. The input values as well as the output values must lie within the range from 0 to 1. An output value of 1 (100 %) corresponds to a fully-opened metering edge. An example for a properly formatted text file with two tables is given in the figure below:

A table is declared by its datatype (e. g. double), followed by the table name (e. g. tab1) and its dimensions in brackets (e. g. (5,2)). As can be seen, multiple tables can be defined in the same text file. The table declaration is followed by the actual data. The first column of the table represents the input of the 1D table, whereas the second column lists the corresponding output values. The input values of the table must be in increasing order. The component interpolates linearly between the listed input values. More information regarding the format of tables can be found at CombiTable1D.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve43 and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x3.

Parameters

TypeNameDefaultDescription
RealSwitchingThreshold0.5Input threshold to open the valve
TimeTopen0.1Time to open 0 % - 100 %
TimeTclose0.1Time to close 100 % - 0 %
BooleanenableStrokeOutfalseEnable Stroke Output
VolumeFlowRateNominalVolumeFlow5e-4Nominal volume flow
PressureNominalPressureDifference500000Nominal pressure difference
DensityReferenceDensity860Reference density for volume flow and pressure difference
DimensionlessRatioOverlap0Valve edge general relative overlap
DimensionlessRatioOverlapPA0Valve edge PA relative overlap
DimensionlessRatioOverlapPB0Valve edge PB relative overlap
DimensionlessRatioOverlapAT0Valve edge AT relative overlap
DimensionlessRatioOverlapBT0Valve edge BT relative overlap
VolumeFlowRateZeroVolumeFlow0Volume flow due to leakage
PressureZeroFlowPressureDifference500000Pressure difference for leakage flow
RealQFactorPA1Factor for edge PA specific flow adjustment
BooleantableFromFilePAfalseTable is provided by file
StringfileNamePA"NoFile"File where look-up table is stored
StringtableNamePA"NoTable"Table name on file
RealmanualTablePA[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
RealQFactorPB1Factor for edge PB specific flow adjustment
BooleantableFromFilePBfalseTable is provided by file
StringfileNamePB"NoFile"File where look-up table is stored
StringtableNamePB"NoTable"Table name on file
RealmanualTablePB[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
RealQFactorAT1Factor for edge AT specific flow adjustment
BooleantableFromFileATfalseTable is provided by file
StringfileNameAT"NoFile"File where look-up table is stored
StringtableNameAT"NoTable"Table name on file
RealmanualTableAT[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
RealQFactorBT1Factor for edge BT specific flow adjustment
BooleantableFromFileBTfalseTable is provided by file
StringfileNameBT"NoFile"File where look-up table is stored
StringtableNameBT"NoTable"Table name on file
RealmanualTableBT[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportBHydraulic port B
FluidPortportPHydraulic port P
FluidPortportTHydraulic port T
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve22PT2

Information

The component PropValve22PT2 is a model of a 2-way proportional valve where the stroke follows the input signal with a 2nd order delay.

For a positive stroke (right position), the flow is scaled in proportion to the input signal starting from 0 to Input value for 100 % open with nominal flow (as given by Nominal volume flow/Nominal pressure difference) corresponding to an input value of Input value for 100 % open.

The valve stroke can be shifted by Valve edge relative overlap. In accordance with common valve parameters a negative overlap will open the valve edge.

The default relationship between input signal and flow rate of the metering edge is linear, but can be changed through the use of a 1D look-up table. The look-up table is provided either manually or by importing a text file. If the parameter Table is provided by file is set to false, the manually entered datapoints from Manually provided look-up table will be used. If it is set to true, the table Table name on file from the file File where look-up table is stored will be utilized.

The text file must follow a specific syntax such that it can be read by Modelica. The input values as well as the output values must lie within the range from 0 to 1. An output value of 1 (100 %) corresponds to a fully-opened metering edge. An example for a properly formatted text file with two tables is given in the figure below:

A table is declared by its datatype (e. g. double), followed by the table name (e. g. tab1) and its dimensions in brackets (e. g. (5,2)). As can be seen, multiple tables can be defined in the same text file. The table declaration is followed by the actual data. The first column of the table represents the input of the 1D table, whereas the second column lists the corresponding output values. The input values of the table must be in increasing order. The component interpolates linearly between the listed input values. More information regarding the format of tables can be found at CombiTable1D.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve22, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x2, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x2.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
VolumeFlowRateNominalVolumeFlow5e-4Nominal volume flow
PressureNominalPressureDifference500000Nominal pressure difference
DensityReferenceDensity860Reference density for volume flow and pressure difference
DimensionlessRatioOverlap0Valve edge relative overlap
BooleantableFromFilefalseTable is provided by file
StringfileName"NoFile"File where look-up table is stored
StringtableName"NoTable"Table name on file
RealmanualTable[:,:][0,0; 1,1]Manually provided look-up table
VolumeFlowRateZeroVolumeFlow0Volume flow due to leakage
PressureZeroFlowPressureDifference500000Pressure difference for leakage flow
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportPHydraulic port P
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve22PT2TableAx

Information

The component PropValve22PT2TableAx is a model of a 2-way proportional valve where the stroke follows the input signal with a 2nd order delay.

The parameterization of the meetering edge is done by providing the Flow coefficient alphaD and a look-up table of the Cross-sectional area as a function of the input signal. Further information regarding the formatting of the look-up table can be found in the documentation of the component ResistorTableAx.

For a positive stroke, the cross-sectional area of the valve's meetering edge is given as a function of the input signal through a look-up table starting from 0 to maximum area (the cross-sectional area of the valve when it is completely open). The cross-sectional area must be given in m^2. The flow is then calculated based on Flow coefficient alphaD, Cross-sectional area, density of the fluid and pressure difference between the two edges of the valve, according to the formula given below:

The valve stroke can be shifted by Relative overlap general. In accordance with common valve parameters a negative overlap will open the valve edge.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve22TableAx, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x2, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x2.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
DimensionlessRatioOverlap0Valve edge relative overlap
RealalphaD0.6Flow coefficient alphaD
BooleantableFromFilefalseTable is provided by file
StringfileName"NoFile"File where look-up table is stored
StringtableName"NoTable"Table name on file
RealmanualTable[:,:][0,0; 1,2.444e-5]Manually provided look-up table
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportPHydraulic port P
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve22PT2TableQpx

Information

The component PropValve22PT2TableQpx is a model of a 2-way proportional valve where the stroke follows the input signal with a 2nd order delay.

The hydraulic parameterization of the meetering edge is done by providing a look-up table of the flow rate as a function of the pressure drop and the input signal. Further information regarding the formatting of the look-up table can be found in the documentation of the component ResistorTableQpx.

For a positive stroke, the flow rate is increased with increasing input signal starting from 0 to Input value for 100 % open with maximum flow corresponding to an input value of Input value for 100 % open.

The valve stroke can be shifted by Relative overlap general. In accordance with common valve parameters a negative overlap will open the valve edge.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve22TableQpx, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x2, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x2.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
DimensionlessRatioOverlap0Valve edge relative overlap
DensityReferenceDensity860Reference density
StringfileName"NoFile"File where look-up table is stored
StringtableName"NoTable"Table name on file
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportPHydraulic port P
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve33PT2

Information

The component PropValve33PT2 is a model of a 3-way proportional valve where the stroke follows the input signal with a 2nd order delay.

For a positive stroke (right position), the flow is scaled in proportion to the input signal starting from 0 to Input value for 100 % open with nominal flow (as given by Nominal volume flow/Nominal pressure difference) corresponding to an input value of Input value for 100 % open. In case of a negative stroke (left position) the same applies for input from 0 to -Input value for 100 % open.

The valve stroke can be shifted by Valve edge general relative overlap. In accordance with common valve parameters a negative overlap will open the valve edge. Valve edge general relative overlap is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Valve edge PA relative overlap is set to a value different from 0, then Valve edge general relative overlap is ignored and the individual overlaps are used.

The default relationship between input signal and flow rate of the metering edge is linear, but can be changed through the use of a 1D look-up table. The look-up table is provided either manually or by importing a text file. If the parameter Table is provided by file is set to false, the manually entered datapoints from Manually provided look-up table will be used. If it is set to true, the table Table name on file from the file File where look-up table is stored will be utilized.

The text file must follow a specific syntax such that it can be read by Modelica. The input values as well as the output values must lie within the range from 0 to 1. An output value of 1 (100 %) corresponds to a fully-opened metering edge. An example for a properly formatted text file with two tables is given in the figure below:

A table is declared by its datatype (e. g. double), followed by the table name (e. g. tab1) and its dimensions in brackets (e. g. (5,2)). As can be seen, multiple tables can be defined in the same text file. The table declaration is followed by the actual data. The first column of the table represents the input of the 1D table, whereas the second column lists the corresponding output values. The input values of the table must be in increasing order. The component interpolates linearly between the listed input values. More information regarding the format of tables can be found at CombiTable1D.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve33, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x3, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x3.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
VolumeFlowRateNominalVolumeFlow5e-4Nominal volume flow
PressureNominalPressureDifference500000Nominal pressure difference
DensityReferenceDensity860Reference density for volume flow and pressure difference
DimensionlessRatioOverlap0Valve edge general relative overlap
DimensionlessRatioOverlapPA0Valve edge PA relative overlap
DimensionlessRatioQFactorPA1Factor for edge PA specific flow adjustment
BooleantableFromFilePAfalseTable is provided by file
StringfileNamePA"NoFile"File where look-up table is stored
StringtableNamePA"NoTable"Table name on file
RealmanualTablePA[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
DimensionlessRatioOverlapAT0Valve edge AT relative overlap
DimensionlessRatioQFactorAT1Factor for edge AT specific flow adjustment
BooleantableFromFileATfalseTable is provided by file
StringfileNameAT"NoFile"File where look-up table is stored
StringtableNameAT"NoTable"Table name on file
RealmanualTableAT[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
VolumeFlowRateZeroVolumeFlow0Volume flow due to leakage
PressureZeroFlowPressureDifference500000Pressure difference for leakage flow
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportPHydraulic port P
FluidPortportTHydraulic port T
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve33PT2TableAx

Information

The component PropValve33PT2TableAx is a model of a 3-way proportional valve where the stroke follows the input signal with a 2nd order delay.

The parameterization of the valve is done by providing the Flow coefficient alphaD and a look-up table of the Cross-sectional area as a function of the input signal. Each of the two meetering edges is parameterised with a separate look-up table and a Flow coefficient alphaD given by the user. Further information regarding the formatting of the look-up table can be found in the documentation of the component ResistorTableAx. Unlike the Resistor component, the look-up table for valve edges is declared for the input range from -1 to 1.

For a positive and negative stroke, the cross-sectional area of the valve's meetering edge is given as a function of the input signal through a look-up table starting from 0 to maximum area (the cross-sectional area of the valve edge when it is completely open). The cross-sectional area must be given in m^2. The flow is then calculated based on Flow coefficient alphaD, Cross-sectional area, density of the fluid and pressure difference between the two edges of the valve, according to the formula given below:

The valve stroke can be shifted by Relative overlap general. In accordance with common valve parameters a negative overlap will open the valve edge. Relative overlap general is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Relative overlap PA or -AT is set to a value different from 0, then the Relative overlap general is ignored and the individual overlaps are used.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve33TableAx, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x3, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x3.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
DimensionlessRatioOverlap0Valve edge general relative overlap
DimensionlessRatioOverlapPA0Valve edge PA relative overlap
RealalphaDPA0.6Flow coefficient alphaD
BooleantableFromFilePAfalseTable is provided by file
StringfileNamePA"NoFile"File where look-up table is stored
StringtableNamePA"NoTable"Table name on file
RealmanualTablePA[:,:][-1,0; 0,0; 1,2.444e-5]Manually provided look-up table
DimensionlessRatioOverlapAT0Valve edge AT relative overlap
RealalphaDAT0.6Flow coefficient alphaD
BooleantableFromFileATfalseTable is provided by file
StringfileNameAT"NoFile"File where look-up table is stored
StringtableNameAT"NoTable"Table name on file
RealmanualTableAT[:,:][-1,0; 0,0; 1,2.444e-5]Manually provided look-up table
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportPHydraulic port P
FluidPortportTHydraulic port T
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve33PT2TableQpx

Information

The component PropValve33PT2TableQpx is a model of a 3-way proportional valve where the stroke follows the input signal with a 2nd order delay.

The hydraulic parameterization of the valve is done by providing a look-up table of the flow rate as a function of the pressure drop and the input signal. Each of the two meetering edges is parameterised with a separate look-up table given by the user. Further information regarding the formatting of the look-up table can be found in the documentation of the component ResistorTableQpx. Unlike the Resistor component, the look-up table for valve edges is declared for the input range from -1 to 1.

For a positive stroke (right position) the flow is function of input signal (starting from 0 to Input value for 100 % open) and the pressure difference across the valve edge. In case of a negative stroke (left position) the same applies for input from 0 to -Input value for 100 % open.

The valve stroke can be shifted by Relative overlap general. In accordance with common valve parameters a negative overlap will open the valve edge. Relative overlap general is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Relative overlap PA or -AT is set to a value different from 0, then the Relative overlap general is ignored and the individual overlaps are used.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve33TableQpx, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x3, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x3.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
DimensionlessRatioOverlap0Valve edge general relative overlap
DensityReferenceDensity860Reference density
DimensionlessRatioOverlapPA0Valve edge PA relative overlap
StringfileNamePA"NoFile"File where look-up table is stored
StringtableNamePA"NoTable"Table name on file
DimensionlessRatioOverlapAT0Valve edge AT relative overlap
StringfileNameAT"NoFile"File where look-up table is stored
StringtableNameAT"NoTable"Table name on file
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportPHydraulic port P
FluidPortportTHydraulic port T
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve43PT2

Information

The component PropValve43PT2 is a model of a 3-way proportional valve where the stroke follows the input signal with a 2nd order delay.

For a positive stroke (right position), the flow is scaled in proportion to the input signal starting from 0 to Input value for 100 % open with nominal flow (as given by Nominal volume flow/Nominal pressure difference) corresponding to an input value of Input value for 100 % open. In case of a negative stroke (left position) the same applies for input from 0 to -Input value for 100 % open.

The valve stroke can be shifted by Valve edge general relative overlap. In accordance with common valve parameters a negative overlap will open the valve edge. Valve edge general relative overlap is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Valve edge PA relative overlap is set to a value different from 0, then Valve edge general relative overlap is ignored and the individual overlaps are used.

The default relationship between input signal and flow rate of the metering edge is linear, but can be changed through the use of a 1D look-up table. The look-up table is provided either manually or by importing a text file. If the parameter Table is provided by file is set to false, the manually entered datapoints from Manually provided look-up table will be used. If it is set to true, the table Table name on file from the file File where look-up table is stored will be utilized.

The text file must follow a specific syntax such that it can be read by Modelica. The input values as well as the output values must lie within the range from 0 to 1. An output value of 1 (100 %) corresponds to a fully-opened metering edge. An example for a properly formatted text file with two tables is given in the figure below:

A table is declared by its datatype (e. g. double), followed by the table name (e. g. tab1) and its dimensions in brackets (e. g. (5,2)). As can be seen, multiple tables can be defined in the same text file. The table declaration is followed by the actual data. The first column of the table represents the input of the 1D table, whereas the second column lists the corresponding output values. The input values of the table must be in increasing order. The component interpolates linearly between the listed input values. More information regarding the format of tables can be found at CombiTable1D.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve43, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x3, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x3.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
VolumeFlowRateNominalVolumeFlow5e-4Nominal volume flow
PressureNominalPressureDifference500000Nominal pressure difference
DensityReferenceDensity860Reference density for volume flow and pressure difference
DimensionlessRatioOverlap0Valve edge general relative overlap
DimensionlessRatioOverlapPA0Valve edge PA relative overlap
DimensionlessRatioOverlapPB0Valve edge PB relative overlap
DimensionlessRatioOverlapAT0Valve edge AT relative overlap
DimensionlessRatioOverlapBT0Valve edge BT relative overlap
VolumeFlowRateZeroVolumeFlow0Volume flow due to leakage
PressureZeroFlowPressureDifference500000Pressure difference for leakage flow
RealQFactorPA1Factor for edge PA specific flow adjustment
BooleantableFromFilePAfalseTable is provided by file
StringfileNamePA"NoFile"File where look-up table is stored
StringtableNamePA"NoTable"Table name on file
RealmanualTablePA[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
RealQFactorPB1Factor for edge PB specific flow adjustment
BooleantableFromFilePBfalseTable is provided by file
StringfileNamePB"NoFile"File where look-up table is stored
StringtableNamePB"NoTable"Table name on file
RealmanualTablePB[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
RealQFactorAT1Factor for edge AT specific flow adjustment
BooleantableFromFileATfalseTable is provided by file
StringfileNameAT"NoFile"File where look-up table is stored
StringtableNameAT"NoTable"Table name on file
RealmanualTableAT[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
RealQFactorBT1Factor for edge BT specific flow adjustment
BooleantableFromFileBTfalseTable is provided by file
StringfileNameBT"NoFile"File where look-up table is stored
StringtableNameBT"NoTable"Table name on file
RealmanualTableBT[:,:][-1,0; 0,0; 1,1]Manually provided look-up table
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportBHydraulic port B
FluidPortportPHydraulic port P
FluidPortportTHydraulic port T
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve43PT2TableAx

Information

The component PropValve43PT2TableAx is a model of a 3-way proportional valve where the stroke follows the input signal with a 2nd order delay.

The parameterization of the valve is done by providing the Flow coefficient alphaD and a look-up table of the Cross-sectional area as a function of the input signal. Each of the four meetering edges is parameterised with a separate look-up table and a Flow coefficient alphaD given by the user. Further information regarding the formatting of the look-up table can be found in the documentation of the component ResistorTableAx. Unlike the Resistor component, the look-up table for valve edges is declared for the input range from -1 to 1.

For a positive and negative stroke, the cross-sectional area of the valve's meetering edge is given as a function of the input signal through a look-up table starting from 0 to maximum area (the cross-sectional area of the valve edge when it is completely open). The cross-sectional area must be given in m^2. The flow is then calculated based on Flow coefficient alphaD, Cross-sectional area, density of the fluid and pressure difference between the two edges of the valve, according to the formula given below:

The valve stroke can be shifted by Relative overlap general. In accordance with common valve parameters a negative overlap will open the valve edge. Relative overlap general is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Relative overlap PA or -AT is set to a value different from 0, then the Relative overlap general is ignored and the individual overlaps are used.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve43TableAx, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x3, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x3.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
DimensionlessRatioOverlap0Valve edge general relative overlap
DimensionlessRatioOverlapPA0Valve edge PA relative overlap
DimensionlessRatioOverlapPB0Valve edge PB relative overlap
DimensionlessRatioOverlapAT0Valve edge AT relative overlap
DimensionlessRatioOverlapBT0Valve edge BT relative overlap
RealalphaDPA0.6Flow coefficient alphaD
BooleantableFromFilePAfalseTable is provided by file
StringfileNamePA"NoFile"File where look-up table is stored
StringtableNamePA"NoTable"Table name on file
RealmanualTablePA[:,:][-1,0; 0,0; 1,2.444e-5]Manually provided look-up table
RealalphaDPB0.6Flow coefficient alphaD
BooleantableFromFilePBfalseTable is provided by file
StringfileNamePB"NoFile"File where look-up table is stored
StringtableNamePB"NoTable"Table name on file
RealmanualTablePB[:,:][-1,0; 0,0; 1,2.444e-5]Manually provided look-up table
RealalphaDAT0.6Flow coefficient alphaD
BooleantableFromFileATfalseTable is provided by file
StringfileNameAT"NoFile"File where look-up table is stored
StringtableNameAT"NoTable"Table name on file
RealmanualTableAT[:,:][-1,0; 0,0; 1,2.444e-5]Manually provided look-up table
VolumedeadVolume1e-6Dead volume at ports
RealalphaDBT0.6Flow coefficient alphaD
BooleantableFromFileBTfalseTable is provided by file
StringfileNameBT"NoFile"File where look-up table is stored
StringtableNameBT"NoTable"Table name on file
RealmanualTableBT[:,:][-1,0; 0,0; 1,2.444e-5]Manually provided look-up table
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportBHydraulic port B
FluidPortportPHydraulic port P
FluidPortportTHydraulic port T
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve43PT2TableQpx

Information

The component PropValve43PT2TableQpx is a model of a 3-way proportional valve where the stroke follows the input signal with a 2nd order delay.

The hydraulic parameterization of the valve is done by providing a look-up table of the flow rate as a function of the pressure drop and the input signal. Each of the four meetering edges is parameterised with a separate look-up table given by the user. Further information regarding the formatting of the look-up table can be found in the documentation of the component ResistorTableQpx. Unlike the Resistor component, the look-up table for valve edges is declared for the input range from -1 to 1.

For a positive stroke (right position) the flow is function of input signal (starting from 0 to Input value for 100 % open) and the pressure difference across the valve edge. In case of a negative stroke (left position) the same applies for input from 0 to -Input value for 100 % open.

The valve stroke can be shifted by Relative overlap general. In accordance with common valve parameters a negative overlap will open the valve edge. Relative overlap general is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Relative overlap PA or -AT is set to a value different from 0, then the Relative overlap general is ignored and the individual overlaps are used.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve43TableQpx, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_x3, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_x3.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
DensityReferenceDensity860Reference density
DimensionlessRatioOverlap0Valve edge general relative overlap
DimensionlessRatioOverlapPA0Valve edge PA relative overlap
DimensionlessRatioOverlapPB0Valve edge PB relative overlap
DimensionlessRatioOverlapAT0Valve edge AT relative overlap
DimensionlessRatioOverlapBT0Valve edge BT relative overlap
StringfileNamePA"NoFile"File where look-up table is stored
StringtableNamePA"NoTable"Table name on file
StringfileNamePB"NoFile"File where look-up table is stored
StringtableNamePB"NoTable"Table name on file
StringfileNameAT"NoFile"File where look-up table is stored
StringtableNameAT"NoTable"Table name on file
StringfileNameBT"NoFile"File where look-up table is stored
StringtableNameBT"NoTable"Table name on file
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportAHydraulic port A
FluidPortportBHydraulic port B
FluidPortportPHydraulic port P
FluidPortportTHydraulic port T
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position

Model HydraulicsByFluidon.​Components.​Valves.​DirectionalValves.​PropValve63PT2

Information

The component PropValve63PT2 is a model of a 3-way proportional valve where the stroke follows the input signal with a 2nd order delay.

For a positive stroke (right position) the flow is scaled proportional to the input signal starting from 0 to Input value for 100 % open with nominal flow (as given by Nominal volume flow/Nominal pressure difference) corresponding to an input value of Input value for 100 % open. In case of a negative stroke (left position) the same applies for input from 0 to -Input value for 100 % open.

The valve stroke can be shifted by Valve edge general relative overlap. In accordance with common valve parameters a negative overlap will open the valve edge. Valve edge general relative overlap is applied to all valve edges simultaneously. If at least one of the edge-specific values, e. g. Valve edge PA relative overlap is set to a value different from 0, then Valve edge general relative overlap is ignored and the individual overlaps are used.

The default relationship between input signal and flow rate of the metering edge is linear, but can be changed through the use of a 1D look-up table. The look-up table is provided either manually or by importing a text file. If the parameter Table is provided by file is set to false, the manually entered datapoints from Manually provided look-up table will be used. If it is set to true, the table Table name on file from the file File where look-up table is stored will be utilized.

The text file must follow a specific syntax such that it can be read by Modelica. The input values as well as the output values must lie within the range from 0 to 1. An output value of 1 (100 %) corresponds to a fully-opened metering edge. An example for a properly formatted text file with two tables is given in the figure below:

A table is declared by its datatype (e. g. double), followed by the table name (e. g. tab1) and its dimensions in brackets (e. g. (5,2)). As can be seen, multiple tables can be defined in the same text file. The table declaration is followed by the actual data. The first column of the table represents the input of the 1D table, whereas the second column lists the corresponding output values. The input values of the table must be in increasing order. The component interpolates linearly between the listed input values. More information regarding the format of tables can be found at CombiTable1D.

Extends from HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValve63, HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveControlSignal_63, and HydraulicsByFluidon.​Components.​Valves.​Base.​PartialValveProp_63.

Parameters

TypeNameDefaultDescription
RealinputMax10Input value for 100 % open
AngularFrequencyangFreq2 * Modelica.Constants.pi * 50Angular frequency
DampingCoefficientdamping0.7Damping
TimeAgingvMax100max. Velocity
TimeAgingvMin-100min. Velocity
BooleanenableStrokeOutfalseEnable Stroke Output
VolumeFlowRateNominalVolumeFlow5e-4Nominal volume flow
PressureNominalPressureDifference500000Nominal pressure difference
DensityReferenceDensity860Reference density for volume flow and pressure difference
DimensionlessRatioOverlap0Valve edge general relative overlap
DimensionlessRatioOverlapP1T10Valve edge P1T1 relative overlap
DimensionlessRatioOverlapP2A0Valve edge P2A relative overlap
DimensionlessRatioOverlapP2B0Valve edge P2B relative overlap
DimensionlessRatioOverlapAT20Valve edge AT2 relative overlap
DimensionlessRatioOverlapBT20Valve edge BT2 relative overlap
VolumeFlowRateZeroVolumeFlow0Volume flow due to leakage
PressureZeroFlowPressureDifference500000Pressure difference for leakage flow
RealQFactorP1T11Factor for edge P1T1 specific flow adjustment
BooleantableFromFileP1T1falseTable is provided by file
StringfileNameP1T1"NoFile"File where look-up table is stored
StringtableNameP1T1"NoTable"Table name on file
RealmanualTableP1T1[:,:][0,0; 1,1]Manually provided look-up table
RealQFactorP2A1Factor for edge P2A specific flow adjustment
BooleantableFromFileP2AfalseTable is provided by file
StringfileNameP2A"NoFile"File where look-up table is stored
StringtableNameP2A"NoTable"Table name on file
RealmanualTableP2A[:,:][0,0; 1,1]Manually provided look-up table
RealQFactorP2B1Factor for edge P2B specific flow adjustment
BooleantableFromFileP2BfalseTable is provided by file
StringfileNameP2B"NoFile"File where look-up table is stored
StringtableNameP2B"NoTable"Table name on file
RealmanualTableP2B[:,:][0,0; 1,1]Manually provided look-up table
RealQFactorAT21Factor for edge AT2 specific flow adjustment
BooleantableFromFileAT2falseTable is provided by file
StringfileNameAT2"NoFile"File where look-up table is stored
StringtableNameAT2"NoTable"Table name on file
RealmanualTableAT2[:,:][0,0; 1,1]Manually provided look-up table
RealQFactorBT21Factor for edge BT2 specific flow adjustment
BooleantableFromFileBT2falseTable is provided by file
StringfileNameBT2"NoFile"File where look-up table is stored
StringtableNameBT2"NoTable"Table name on file
RealmanualTableBT2[:,:][0,0; 1,1]Manually provided look-up table
VolumedeadVolume1e-6Dead volume at ports
InitinitTypeModelica.​Blocks.​Types.​Init.​InitialStateType of initialization (1: no init, 2: steady state, 3/4: initial output)

Connectors

TypeNameDescription
FluidPortportP1Hydraulic port P1
FluidPortportT1Hydraulic port T1
FluidPortportP2Hydraulic port P2
FluidPortportT2Hydraulic port T2
FluidPortportAHydraulic port A
FluidPortportBHydraulic port B
output RealOutputvalveStrokeOutValve Stroke
input RealInputInputSet value of valve position