Skip to content
LIBRARY
Interfaces.PartialTwoPortTransport.md

Interfaces.PartialTwoPortTransport ​

Partial element transporting fluid between two ports without storing mass or energy.

Extending components provide the pressure-flow relation and the two outflow enthalpy equations. Composition and trace substances pass through unchanged.

This component extends from FluidComponents.Interfaces.PartialTwoPort

Usage ​

FluidComponents.Interfaces.PartialTwoPortTransport(showDesignFlowDirection=true, dp_start, m_flow_start, m_flow_small)

Parameters: ​

NameDescriptionUnitsDefault value
medium_data–
allowFlowReversal–
port_a_exposesState–false
port_b_exposesState–false
nX–MediaCompon...edium_data)
nXi–MediaCompon...edium_data)
nC–MediaCompon...edium_data)
reducedX–MediaCompon...edium_data)
fixedX–MediaCompon...edium_data)
show_T–true
show_V_flow–true
showDesignFlowDirection–true
dp_startPa
m_flow_startkg/s
m_flow_smallkg/s

Connectors ​

  • port_a - Generic fluid connector at the design inlet. (FluidPort_a)

  • port_b - Generic fluid connector at the design outlet. (FluidPort_b)

Variables ​

NameDescriptionUnits
m_flowkg/s
dpPa
V_flowm3/s
port_a_TK
port_b_TK
port_a_outflow_Xkg/kg
port_b_outflow_Xkg/kg

Source ​

dyad
"""
Partial element transporting fluid between two ports without storing mass or
energy.

Extending components provide the pressure-flow relation and the two outflow
enthalpy equations. Composition and trace substances pass through unchanged.
"""
partial component PartialTwoPortTransport
  extends FluidComponents.Interfaces.PartialTwoPort(final port_a_exposesState = false, final port_b_exposesState = false)
  # Number of mass fractions [-]
  final structural parameter nX::Integer = MediaComponents.Interfaces.medium_nX(medium_data)
  # Number of independent mass fractions [-]
  final structural parameter nXi::Integer = MediaComponents.Interfaces.medium_nXi(medium_data)
  # Number of extra transported properties [-]
  final structural parameter nC::Integer = MediaComponents.Interfaces.medium_nC(medium_data)
  # Whether the medium mass fractions sum to one [-]
  final structural parameter reducedX::Boolean = MediaComponents.Interfaces.medium_reducedX(medium_data)
  # Whether the medium composition is fixed [-]
  final structural parameter fixedX::Boolean = MediaComponents.Interfaces.medium_fixedX(medium_data)
  # Start value of the pressure difference [Pa]
  parameter dp_start::Pressure
  # Start value of the mass flow rate [kg/s]
  parameter m_flow_start::MediaComponents.Types.MassFlowRate
  # Small mass flow rate used to regularize flow-direction changes [kg/s]
  parameter m_flow_small::MediaComponents.Types.MassFlowRate
  # Whether port temperatures are computed for diagnostics [-]
  structural parameter show_T::Boolean = true
  # Whether volume flow rate is computed for diagnostics [-]
  structural parameter show_V_flow::Boolean = true
  "Thermodynamic state of fluid entering through port_a."
  state_a = MediaComponents.Interfaces.ThermodynamicState(medium_data = medium_data)
  "Thermodynamic state of fluid entering through port_b."
  state_b = MediaComponents.Interfaces.ThermodynamicState(medium_data = medium_data)
  # Mass flow rate in the design-flow direction [kg/s]
  variable m_flow::MediaComponents.Types.MassFlowRate(min = allowFlowReversal ? -Inf : 0)
  # Pressure difference between port_a and port_b [Pa]
  variable dp::Pressure
  # Volume flow rate at the inflowing port [m3/s]
  variable V_flow::VolumeFlowRate if show_V_flow
  # Temperature close to port_a [K]
  variable port_a_T::Temperature if show_T
  # Temperature close to port_b [K]
  variable port_b_T::Temperature if show_T
  # Outflow composition used by the port_a temperature diagnostic [kg/kg]
  variable port_a_outflow_X::MediaComponents.Types.MassFraction[nX] if show_T
  # Outflow composition used by the port_b temperature diagnostic [kg/kg]
  variable port_b_outflow_X::MediaComponents.Types.MassFraction[nX] if show_T
relations
  guess m_flow = m_flow_start
  guess dp = dp_start
  state_a.p = port_a.p
  state_a.h = instream(port_a.h_outflow)
  state_b.p = port_b.p
  state_b.h = instream(port_b.h_outflow)
  if fixedX
    state_a.X = MediaComponents.Interfaces.medium_reference_X(medium_data)
    state_b.X = MediaComponents.Interfaces.medium_reference_X(medium_data)
  elseif reducedX
    if nXi > 0
      for j in 1:nXi
        state_a.X[j] = instream(port_a.Xi_outflow[j])
        state_b.X[j] = instream(port_b.Xi_outflow[j])
      end
      state_a.X[nX] = 1 - sum(instream(port_a.Xi_outflow))
      state_b.X[nX] = 1 - sum(instream(port_b.Xi_outflow))
    else
      state_a.X[nX] = 1
      state_b.X[nX] = 1
    end
  else
    for j in 1:nX
      state_a.X[j] = instream(port_a.Xi_outflow[j])
      state_b.X[j] = instream(port_b.Xi_outflow[j])
    end
  end
  state_a.T = MediaComponents.Interfaces.temperature_phX(medium_data, state_a.p, state_a.h, state_a.X)
  state_a.d = MediaComponents.Interfaces.density_phX(medium_data, state_a.p, state_a.h, state_a.X)
  state_b.T = MediaComponents.Interfaces.temperature_phX(medium_data, state_b.p, state_b.h, state_b.X)
  state_b.d = MediaComponents.Interfaces.density_phX(medium_data, state_b.p, state_b.h, state_b.X)
  dp = port_a.p - port_b.p
  m_flow = port_a.m_flow
  port_a.m_flow + port_b.m_flow = 0
  if nXi > 0
    for j in 1:nXi
      port_a.Xi_outflow[j] = instream(port_b.Xi_outflow[j])
      port_b.Xi_outflow[j] = instream(port_a.Xi_outflow[j])
    end
  else
    port_a.Xi_outflow[1] = 0
    port_b.Xi_outflow[1] = 0
  end
  if nC > 0
    for j in 1:nC
      port_a.C_outflow[j] = instream(port_b.C_outflow[j])
      port_b.C_outflow[j] = instream(port_a.C_outflow[j])
    end
  else
    port_a.C_outflow[1] = 0
    port_b.C_outflow[1] = 0
  end
  if show_V_flow
    V_flow = m_flow / FluidComponents.regStep(m_flow, state_a.d, state_b.d, m_flow_small)
  end
  if show_T
    if fixedX
      port_a_outflow_X = MediaComponents.Interfaces.medium_reference_X(medium_data)
      port_b_outflow_X = MediaComponents.Interfaces.medium_reference_X(medium_data)
    elseif reducedX
      if nXi > 0
        for j in 1:nXi
          port_a_outflow_X[j] = port_a.Xi_outflow[j]
          port_b_outflow_X[j] = port_b.Xi_outflow[j]
        end
        port_a_outflow_X[nX] = 1 - sum(port_a.Xi_outflow)
        port_b_outflow_X[nX] = 1 - sum(port_b.Xi_outflow)
      else
        port_a_outflow_X[nX] = 1
        port_b_outflow_X[nX] = 1
      end
    else
      for j in 1:nX
        port_a_outflow_X[j] = port_a.Xi_outflow[j]
        port_b_outflow_X[j] = port_b.Xi_outflow[j]
      end
    end
    port_a_T = FluidComponents.regStep(port_a.m_flow, state_a.T, MediaComponents.Interfaces.temperature_phX(medium_data, port_a.p, port_a.h_outflow, port_a_outflow_X), m_flow_small)
    port_b_T = FluidComponents.regStep(port_b.m_flow, state_b.T, MediaComponents.Interfaces.temperature_phX(medium_data, port_b.p, port_b.h_outflow, port_b_outflow_X), m_flow_small)
  end
end
Flattened Source
dyad
"""
Partial element transporting fluid between two ports without storing mass or
energy.

Extending components provide the pressure-flow relation and the two outflow
enthalpy equations. Composition and trace substances pass through unchanged.
"""
partial component PartialTwoPortTransport
  # Immutable medium definition selected at model construction [-]
  structural parameter medium_data::MediaComponents.Interfaces.AbstractPartialMediumData
  # Whether flow may reverse from the positive design direction [-]
  structural parameter allowFlowReversal::Boolean
  # Fluid connector at the design inlet [-]
  port_a = FluidComponents.Interfaces.FluidPort_a(medium_data = medium_data) {
    "Dyad": {
      "placement": {
        "icon": {"iconName": "default", "x1": -50, "y1": 450, "x2": 50, "y2": 550, "rot": 0}
      }
    }
  }
  # Fluid connector at the design outlet [-]
  port_b = FluidComponents.Interfaces.FluidPort_b(medium_data = medium_data) {
    "Dyad": {
      "placement": {
        "icon": {"iconName": "default", "x1": 950, "y1": 450, "x2": 1050, "y2": 550, "rot": 0}
      }
    }
  }
  # Whether port_a exposes the state of an internal fluid volume [-]
  structural parameter port_a_exposesState::Boolean = false
  # Whether port_b exposes the state of an internal fluid volume [-]
  structural parameter port_b_exposesState::Boolean = false
  # Whether to show the positive design-flow direction [-]
  parameter showDesignFlowDirection::Boolean = true
  # Number of mass fractions [-]
  final structural parameter nX::Integer = MediaComponents.Interfaces.medium_nX(medium_data)
  # Number of independent mass fractions [-]
  final structural parameter nXi::Integer = MediaComponents.Interfaces.medium_nXi(medium_data)
  # Number of extra transported properties [-]
  final structural parameter nC::Integer = MediaComponents.Interfaces.medium_nC(medium_data)
  # Whether the medium mass fractions sum to one [-]
  final structural parameter reducedX::Boolean = MediaComponents.Interfaces.medium_reducedX(medium_data)
  # Whether the medium composition is fixed [-]
  final structural parameter fixedX::Boolean = MediaComponents.Interfaces.medium_fixedX(medium_data)
  # Start value of the pressure difference [Pa]
  parameter dp_start::Pressure
  # Start value of the mass flow rate [kg/s]
  parameter m_flow_start::MediaComponents.Types.MassFlowRate
  # Small mass flow rate used to regularize flow-direction changes [kg/s]
  parameter m_flow_small::MediaComponents.Types.MassFlowRate
  # Whether port temperatures are computed for diagnostics [-]
  structural parameter show_T::Boolean = true
  # Whether volume flow rate is computed for diagnostics [-]
  structural parameter show_V_flow::Boolean = true
  "Thermodynamic state of fluid entering through port_a."
  state_a = MediaComponents.Interfaces.ThermodynamicState(medium_data = medium_data)
  "Thermodynamic state of fluid entering through port_b."
  state_b = MediaComponents.Interfaces.ThermodynamicState(medium_data = medium_data)
  # Mass flow rate in the design-flow direction [kg/s]
  variable m_flow::MediaComponents.Types.MassFlowRate(min = allowFlowReversal ? -Inf : 0)
  # Pressure difference between port_a and port_b [Pa]
  variable dp::Pressure
  # Volume flow rate at the inflowing port [m3/s]
  variable V_flow::VolumeFlowRate if show_V_flow
  # Temperature close to port_a [K]
  variable port_a_T::Temperature if show_T
  # Temperature close to port_b [K]
  variable port_b_T::Temperature if show_T
  # Outflow composition used by the port_a temperature diagnostic [kg/kg]
  variable port_a_outflow_X::MediaComponents.Types.MassFraction[nX] if show_T
  # Outflow composition used by the port_b temperature diagnostic [kg/kg]
  variable port_b_outflow_X::MediaComponents.Types.MassFraction[nX] if show_T
relations
  guess m_flow = m_flow_start
  guess dp = dp_start
  state_a.p = port_a.p
  state_a.h = instream(port_a.h_outflow)
  state_b.p = port_b.p
  state_b.h = instream(port_b.h_outflow)
  if fixedX
    state_a.X = MediaComponents.Interfaces.medium_reference_X(medium_data)
    state_b.X = MediaComponents.Interfaces.medium_reference_X(medium_data)
  elseif reducedX
    if nXi > 0
      for j in 1:nXi
        state_a.X[j] = instream(port_a.Xi_outflow[j])
        state_b.X[j] = instream(port_b.Xi_outflow[j])
      end
      state_a.X[nX] = 1 - sum(instream(port_a.Xi_outflow))
      state_b.X[nX] = 1 - sum(instream(port_b.Xi_outflow))
    else
      state_a.X[nX] = 1
      state_b.X[nX] = 1
    end
  else
    for j in 1:nX
      state_a.X[j] = instream(port_a.Xi_outflow[j])
      state_b.X[j] = instream(port_b.Xi_outflow[j])
    end
  end
  state_a.T = MediaComponents.Interfaces.temperature_phX(medium_data, state_a.p, state_a.h, state_a.X)
  state_a.d = MediaComponents.Interfaces.density_phX(medium_data, state_a.p, state_a.h, state_a.X)
  state_b.T = MediaComponents.Interfaces.temperature_phX(medium_data, state_b.p, state_b.h, state_b.X)
  state_b.d = MediaComponents.Interfaces.density_phX(medium_data, state_b.p, state_b.h, state_b.X)
  dp = port_a.p - port_b.p
  m_flow = port_a.m_flow
  port_a.m_flow + port_b.m_flow = 0
  if nXi > 0
    for j in 1:nXi
      port_a.Xi_outflow[j] = instream(port_b.Xi_outflow[j])
      port_b.Xi_outflow[j] = instream(port_a.Xi_outflow[j])
    end
  else
    port_a.Xi_outflow[1] = 0
    port_b.Xi_outflow[1] = 0
  end
  if nC > 0
    for j in 1:nC
      port_a.C_outflow[j] = instream(port_b.C_outflow[j])
      port_b.C_outflow[j] = instream(port_a.C_outflow[j])
    end
  else
    port_a.C_outflow[1] = 0
    port_b.C_outflow[1] = 0
  end
  if show_V_flow
    V_flow = m_flow / FluidComponents.regStep(m_flow, state_a.d, state_b.d, m_flow_small)
  end
  if show_T
    if fixedX
      port_a_outflow_X = MediaComponents.Interfaces.medium_reference_X(medium_data)
      port_b_outflow_X = MediaComponents.Interfaces.medium_reference_X(medium_data)
    elseif reducedX
      if nXi > 0
        for j in 1:nXi
          port_a_outflow_X[j] = port_a.Xi_outflow[j]
          port_b_outflow_X[j] = port_b.Xi_outflow[j]
        end
        port_a_outflow_X[nX] = 1 - sum(port_a.Xi_outflow)
        port_b_outflow_X[nX] = 1 - sum(port_b.Xi_outflow)
      else
        port_a_outflow_X[nX] = 1
        port_b_outflow_X[nX] = 1
      end
    else
      for j in 1:nX
        port_a_outflow_X[j] = port_a.Xi_outflow[j]
        port_b_outflow_X[j] = port_b.Xi_outflow[j]
      end
    end
    port_a_T = FluidComponents.regStep(port_a.m_flow, state_a.T, MediaComponents.Interfaces.temperature_phX(medium_data, port_a.p, port_a.h_outflow, port_a_outflow_X), m_flow_small)
    port_b_T = FluidComponents.regStep(port_b.m_flow, state_b.T, MediaComponents.Interfaces.temperature_phX(medium_data, port_b.p, port_b.h_outflow, port_b_outflow_X), m_flow_small)
  end
metadata {}
end


Test Cases ​

No test cases defined.

  • Examples

  • Experiments

  • Analyses