modelPipeFlowVLE_L4_Advanced_WH_VCM
Copy of PipeFlowVLE_L4_Advanced with adaptation of speed of sound according and vapour cavity model
Extends from ClaRa.Basics.ControlVolumes.FluidVolumes.VolumeVLE_L4_Advanced_WH_VCM (Copy of VolumeVLE_L4_Advanced with adaptation of speed of sound according and vapour cavity model), ClaRa.Basics.Icons.Pipe_L4_a.
Information
For detailed model documentation please consult the html-documentation shipped with ClaRa.
Authorship and Copyright Statement for original (initial) Contribution
Author:
ClaRa development team, Copyright © 2017 - 2025.References:
For references please consult the html-documentation shipped with ClaRa.
Remarks:
This component was developed for ClaRa library.
Acknowledgements:
CLA:
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Real | Zeta_in (from VolumeVLE_L4_Advanced_WH_VCM) | 0 | Inlet losses additional to wall friction |
| Real | Zeta_out (from VolumeVLE_L4_Advanced_WH_VCM) | 0 | Outlet losses additional to wall friction |
| SI.DensityMassSpecific[geo.N_cv] | rho_nom (from VolumeVLE_L4_Advanced_WH_VCM) | TILMedia.VLEFluid.Functions.density_phxi(medium, p_nom, h_nom) | Nominal density |
| SI.Temperature[geo.N_cv] | T_start (from VolumeVLE_L4_Advanced_WH_VCM) | TILMedia.VLEFluid.Functions.temperature_phxi(medium, p_start, h_start) | Nominal Temperature |
| Real | suppFreqCorr (from VolumeVLE_L4_Advanced_WH_VCM) | if suppressHighFrequencyOscillations then suppHighFreqCorr else 0 | |
| ClaRa.Basics.Units.Time | Tau_T_ps (from VolumeVLE_L4_Advanced_WH_VCM) | 1e-4 | Time constant for pseudo state for temperature. |
| Real | exportToFMUPreFactor (from VolumeVLE_L4_Advanced_WH_VCM) | if exportToFMU then 1.0 else 0.0 | |
| Real | useStiffWallPreFactor (from VolumeVLE_L4_Advanced_WH_VCM) | if useStiffWall then 1.0 else 0.0 | |
| Real | userDefinedSpeedOfSoundPreFactor (from VolumeVLE_L4_Advanced_WH_VCM) | if userDefinedSpeedOfSound then 1.0 else 0.0 | |
| Fundamental Definitions | |||
| TILMedia.VLEFluid.Types.BaseVLEFluid | medium (from VolumeVLE_L4_Advanced_WH_VCM) | simCenter.fluid1 | Medium in the component |
| Boolean | frictionAtInlet (from VolumeVLE_L4_Advanced_WH_VCM) | false | True if pressure loss shall be located between first cell and inlet |
| Boolean | frictionAtOutlet (from VolumeVLE_L4_Advanced_WH_VCM) | false | True if pressure loss shall be located between last cell and outlet |
| Nominal Values | |||
| SI.Pressure[geo.N_cv] | p_nom (from VolumeVLE_L4_Advanced_WH_VCM) | ones(geo.N_cv)*1e5 | Nominal pressure |
| SI.EnthalpyMassSpecific[geo.N_cv] | h_nom (from VolumeVLE_L4_Advanced_WH_VCM) | ones(geo.N_cv)*1e5 | Nominal specific enthalpy for single tube |
| SI.MassFlowRate | m_flow_nom (from VolumeVLE_L4_Advanced_WH_VCM) | 100 | Nominal mass flow for single tube |
| SI.Pressure | Delta_p_nom (from VolumeVLE_L4_Advanced_WH_VCM) | 1e4 | Nominal pressure loss w.r.t. all parallel tubes |
| Initialisation | |||
| Integer | initOption (from VolumeVLE_L4_Advanced_WH_VCM) | 1 | Type of initialisation |
| SI.EnthalpyMassSpecific[geo.N_cv] | h_start (from VolumeVLE_L4_Advanced_WH_VCM) | ones(geo.N_cv)*800e3 | Initial specific enthalpy for single tube |
| SI.Pressure[geo.N_cv] | p_start (from VolumeVLE_L4_Advanced_WH_VCM) | ones(geo.N_cv)*1e5 | Initial pressure |
| SI.MassFlowRate[geo.N_cv + 1] | m_flow_start (from VolumeVLE_L4_Advanced_WH_VCM) | ones(geo.N_cv + 1)*100 | Initial mass flow rate |
| SI.MassFraction[medium.nc - 1] | xi_start (from VolumeVLE_L4_Advanced_WH_VCM) | zeros(medium.nc - 1) | Initial composition |
| Initialisation › Model Settings | |||
| Boolean | useHomotopy (from VolumeVLE_L4_Advanced_WH_VCM) | simCenter.useHomotopy | True, if homotopy method is used during initialisation |
| Summary and Visualisation | |||
| Boolean | showExpertSummary (from VolumeVLE_L4_Advanced_WH_VCM) | simCenter.showExpertSummary | True, if a summary shall be shown, else false |
| Boolean | showData (from VolumeVLE_L4_Advanced_WH_VCM) | false | True, if a data port containing p,T,h,s,m_flow shall be shown, else false |
| Boolean | contributeToCycleSummary | simCenter.contributeToCycleSummary | True if component shall contribute to automatic efficiency calculation |
| Boolean | heatFlowIsLoss | true | True if negative heat flow is a loss (not a process product) |
| Expert Settings | |||
| Boolean | suppressHighFrequencyOscillations (from VolumeVLE_L4_Advanced_WH_VCM) | false | Suppress oscillations at frequencies greater than inverse travelling time of sound |
| Real | suppHighFreqCorr (from VolumeVLE_L4_Advanced_WH_VCM) | 1 | Damping factor. Increase it will increase damping |
| Real | pressureAdvCalc (from VolumeVLE_L4_Advanced_WH_VCM) | 0 | Parameter for a method of calculation advective pressure drop using:|| 0:= upstream velocities | 1:= velocities in energy cells |
| Expert Settings › Mass Flow Stabilization | |||
| Boolean | useMeanEnthalpyAtInlet (from VolumeVLE_L4_Advanced_WH_VCM) | false | Use mean enthalpy at inlet, stabilises zero flows |
| Boolean | useMeanEnthalpyAtOutlet (from VolumeVLE_L4_Advanced_WH_VCM) | false | Use mean enthalpy at inlet, stabilises zero flows |
| Boolean | advectivePressureLoss (from VolumeVLE_L4_Advanced_WH_VCM) | true | |
| Boolean | limitMassChange (from VolumeVLE_L4_Advanced_WH_VCM) | false | Set to true to limit time derivative of control volume mass. CAUTION: Precise short time dynamics is artificially changed! Can be useful if simulation stops in case of phase change. |
| Real | massChangeLimit (from VolumeVLE_L4_Advanced_WH_VCM) | 10 | Limit abs(drhodt[I]/rho[I])=abs(der(mass[I])/mass[I])<= massChangeLimit |
| Water Hammer › FMU export | |||
| Boolean | exportToFMU (from VolumeVLE_L4_Advanced_WH_VCM) | false | True if user defined media data shall not change structure | false else |
| Water Hammer › User Defined Physical Properties | |||
| Boolean | useStiffWall (from VolumeVLE_L4_Advanced_WH_VCM) | true | True for stiff walls | False to account for elasticity of wall material |
| Boolean | userDefinedSpeedOfSound (from VolumeVLE_L4_Advanced_WH_VCM) | false | True for user definition of speed of sound |
| SI.ElasticityModule | E (from VolumeVLE_L4_Advanced_WH_VCM) | 120e9 | Young's modulus |
| Real | my (from VolumeVLE_L4_Advanced_WH_VCM) | 0.34 | Possion's ratio |
| SI.Length | e (from VolumeVLE_L4_Advanced_WH_VCM) | 0.00163 | Wall thickness |
| SI.Velocity | a_def (from VolumeVLE_L4_Advanced_WH_VCM) | 1319 | User defined speed of sound |
| Boolean | userDefinedDynamicViscosity (from VolumeVLE_L4_Advanced_WH_VCM) | false | True for user definition of speed of sound |
| SI.DynamicViscosity[geo.N_cv + 1] | eta_FM_def (from VolumeVLE_L4_Advanced_WH_VCM) | ones(geo.N_cv + 1)*1e-3 | User defined dynamic viscosity |
| Boolean | useUnsteadyFriction (from VolumeVLE_L4_Advanced_WH_VCM) | true | True for Unsteady Friction |
| Geometry | |||
| ClaRa.Basics.Units.Length | length | 1 | Length of the pipe (one pass) |
| ClaRa.Basics.Units.Length | diameter_i | 0.1 | Inner diameter of the pipe |
| ClaRa.Basics.Units.Length | z_in | 0.1 | Height of inlet above ground |
| ClaRa.Basics.Units.Length | z_out | 0.1 | Height of outlet above ground |
| Integer | N_tubes | 1 | Number Of parallel pipes |
| Integer | N_passes | 1 | Number of passes of the tubes |
| Integer | orientation | 0 | Main orientation of tube bundle (N_passes>1) |
| Discretisation | |||
| Integer | N_cv | 3 | Number of finite volumes |
| ClaRa.Basics.Units.Length[N_cv] | Delta_x | ClaRa.Basics.Functions.GenerateGrid({0}, length*N_passes, N_cv) | Discretisation scheme |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| ClaRa.Basics.Interfaces.FluidPortIn | inlet (from VolumeVLE_L4_Advanced_WH_VCM) | Inlet port | |
| ClaRa.Basics.Interfaces.FluidPortOut | outlet (from VolumeVLE_L4_Advanced_WH_VCM) | Outlet port | |
| ClaRa.Basics.Interfaces.HeatPort_a[geo.N_cv] | heat (from VolumeVLE_L4_Advanced_WH_VCM) | ||
| ClaRa.Basics.Interfaces.EyeOut | eye |
Components
Revisions
For revisions please consult the html-documentation shipped with ClaRa.