JARA2i.cutsB

Types of connectors included in JARA library

Information


 

JARA connectors



A set of physical magnitudes is grouped into the same causal connector if their connection corresponds to the same model application context.
Four different model application contexts have been distinguished in JARA:

The causal connectors defined in JARA have only one allowed computational causality.
This is not imposed by the design methodology, but it is a result of the JARA modeling approximations.
Attending to their computational causality, two types of JARA causal connectors are distinguished: capacitive and resistive.

Definition 1. A connector is capacitive if and only if it satisfies the following two conditions:

  1. The across variables are computational outputs and they are only a function of state variables and/or time.
  2. The through variables are computational inputs.

Definition 2. A connector is resistive if and only if it satisfies the following two conditions:

  1. The across variables are computational inputs.
  2. The through variables are computational outputs.

Figure 1.Computational causality of the capacitive and resistive causal connectors.

The capacitive and resistive connectors are causal connectors. The computational causalities of the capacitive and resistive connectors have been schematically represented in Figure 1. The arrow pointing toward the element represents a computational input and the arrow pointing outwards means computational output. The vertical line perpendicular to the arrow represents the breaking of the causality computational loop by means of integrators (the bond graphs notation is adopted ).

The mass-flow, heat-flow, information transmision and volume constraint causal connector classes are described in Table 1, 2, 3 and 4, respectively. The following notation has been used. Suffix C: capacitive connectors; suffix R: resistive connectors; (I): computational inputs; and (O): computational outputs.
Two types of mass-flow connectors have been defined in JARA: one for liquid mixtures and the other for gaseous ones. A capacitive and a resistive connector class have been defined for each type.
Two types of heat-flow connectors have been defined in JARA, one for heat conduction, heat flow-M, and the other for heat convection, heat flow-F. A capacitive and a resistive connector class have been defined of each type.
The necessity of describing the information transmission arises when modeling automatic control loops. This is the purpose of the JARA's information transmission connectors. Two types of information transmission connectors are defined in JARA: emitter and receiver (see Table 3). Both types of causal connectors are only composed of across variables, whose number and meaning depends on the application.
The fourth type of connector in JARA, the volume constraint connector (see Table 4), models the constraints that the recipients impose on the CVs volume.

Causal connectors icons allow identifying easily the type of causal connector. The icon color represents the type of flow: liquid, gas or information. Capacitive connectors icons are filled and resistive connectors icons are bordered. The ''pointed'' shape denotes the existence of through variables (gas, liquid and heat flow connectors). The way of orienting the connector in the interface (inward or outward direction) depicts the sign criteria of the connector through variables.

Table 1. Mass-flow connectors.

Causal connector

Across variables

Flow variables

Gas flow-R

Moles number (vector)

Temperature (I)

Pressure

Molar-flow (vector)

Energy flow (O)

Gas flow-C

Moles number (vector)

Temperature (O)

Pressure

Molar-flow (vector)

Energy flow (I)

Liquid flow-R

Mass (vector)

Temperature (I)

Pressure

Molar-flow (vector)

Energy flow (O)

Liquid flow-C

Mass (vector)

Temperature (O)

Pressure

Molar-flow (vector)

Energy flow (I)



Table 2. Heat-flow connectors.

Causal connector

Across variables

Flow variables

Heat flow-M-R

Matter (vector)

Temperature (I)

Heat flow (O)

Heat flow-M-C

Matter (vector)

Temperature (O)

Heat flow (I)

Heat flow-F-R

Matter flow (vector)

Temperature (I)

Heat flow (O)

Heat flow-F-C

Matter flow (vector)

Temperature (O)

Heat flow (I)



Table 3. Information transmission connectors.

Causal connector

Across variables

Flow variables

Info. emitter-C

Signal (vector) (O)

 

Info. receiver-R

Signal (vector) (I)

 



Table 4. Volume constraint connector.

Causal connector

Across variables

Flow variables

Volume constraint

Three variables

One variable



The rules about the number of connections are:

Connection between causal connectors at the same hierarchy:
  1. A capacitive connector can be left unconnected or it can be connected to an arbitrary number of resistive connectors.
  2. A resistive connector must be connected to one, and only to one, capacitive connector.

Connection between causal connectors at different hierarchies:
  1. A capacitive connector of the molecular class must be connected to one, and only to one, submodel capacitive connector. It also can be connected to an arbitrary number (zero is allowed) of submodel resistive connectors.
  2. A resistive connector of the molecular class must be connected to at least one submodel resistive connector. It cannot be connected to any submodel capacitive connector.



Figure 1.Classes included in cutsB.mo.



Package Content

NameDescription
JARA2i.cutsB.cutEmitter cutEmitter Information emitter.
JARA2i.cutsB.cutGasC cutGasC Gas flow - Connector Capacitive.
JARA2i.cutsB.cutGasR cutGasR Gas flow - Connector Resistive.
JARA2i.cutsB.cutHeatFC cutHeatFC Heat flow - Connector F-C. Connector for the heat convection.
JARA2i.cutsB.cutHeatFR cutHeatFR Heat flow - Connector F-R. Connector for the heat convection.
JARA2i.cutsB.cutHeatMC cutHeatMC Heat flow - Connector M-C. Connector for the heat conduction.
JARA2i.cutsB.cutHeatMR cutHeatMR Heat flow - Connector M-R. Connector for the heat conduction.
JARA2i.cutsB.cutLiquidC cutLiquidC Liquid flow - Connector C. Connector for the liquid flow.
JARA2i.cutsB.cutLiquidR cutLiquidR Liquid flow - Connector R. Connector for the liquid flow.
JARA2i.cutsB.cutReceiver cutReceiver Information receiver.
JARA2i.cutsB.cutVolConstrGas cutVolConstrGas Volume constraint - Gas.
JARA2i.cutsB.cutVolConstrLiq cutVolConstrLiq Volume constraint - Liquid.
JARA2i.cutsB.cutVolConstrVessel cutVolConstrVessel Volume constraint - Vessel.


JARA2i.cutsB.cutEmitter JARA2i.cutsB.cutEmitter

Information emitter.

JARA2i.cutsB.cutEmitter

Information

 
 Information emitter.
The emitter connector is a capacitive causal connector.
This implies that the information emitter connector variables have to break the computational causality loops. This does not imply any practical limitation: it only forces to model the sensor dynamic ''appropriately''.
JARA models whose interface contains the cutEmitter connector: Automatic controller, Signal generator and Sensor.

Parameters

TypeNameDefaultDescription
Integerdim Dimension of the Signals vector

Contents

TypeNameDescription
IntegerdimDimension of the Signals vector
Realsignal[dim]Signals

Modelica definition

connector cutEmitter " Information emitter." 
  
   parameter Integer dim "Dimension of the Signals vector";
  
   Real signal[     dim] "Signals";
  
end cutEmitter;

JARA2i.cutsB.cutGasC JARA2i.cutsB.cutGasC

Gas flow - Connector Capacitive.

JARA2i.cutsB.cutGasC

Information

 
 Gas flow - Connector Capacitive .
Sign criterium: energy and mass flow are positive when flowing into the element.
JARA models whose interface contains the cutGasC connector: Gaseous CV and Gas pressure sources.

Parameters

TypeNameDefaultDescription
IntegernComp1Number of components

Contents

TypeNameDescription
IntegernCompNumber of components
RealmolG[nComp]Mol number of each component [mol]
RealtempGTemperature of the gas mixture [T]
RealpressGGas pressure [M.L-1.t-2]
flow RealmolGF[nComp]Molar flow of each component [mol.t-1]
flow RealenergyGFEnergy flow [M.L2.t3]

Modelica definition

connector cutGasC "Gas flow - Connector Capacitive." 
  
   parameter Integer nComp = 1 "Number of components";
  
   Real molG[ nComp](  unit="mol") "Mol number of each component";
   Real tempG(         unit="T") "Temperature of the gas mixture";
   Real pressG(        unit="M.L-1.t-2") "Gas pressure";
  
   flow Real molGF[ nComp](        unit="mol.t-1") 
    "Molar flow of each component";
   flow Real energyGF(             unit="M.L2.t3") "Energy flow";
  
  
end cutGasC;

JARA2i.cutsB.cutGasR JARA2i.cutsB.cutGasR

Gas flow - Connector Resistive.

JARA2i.cutsB.cutGasR

Information

 
 Gas flow - Connector Resistive .
Sign criterium: energy and mass flow are positive when flowing into the element.
JARA models whose interface contains the cutGasR connector: Gas transport phenomena and Gas flow sources.

Parameters

TypeNameDefaultDescription
IntegernComp1Number of components

Contents

TypeNameDescription
IntegernCompNumber of components
RealmolG[nComp]Mol number of each component [mol]
RealtempGTemperature of the gas mixture [T]
RealpressGGas pressure [M.L-1.t-2]
flow RealmolGF[nComp]Molar flow of each component [mol.t-1]
flow RealenergyGFEnergy flow [M.L2.t3]

Modelica definition

connector cutGasR "Gas flow - Connector Resistive." 
  
   parameter Integer nComp = 1 "Number of components";
  
   Real molG[ nComp](  unit="mol") "Mol number of each component";
   Real tempG(         unit="T") "Temperature of the gas mixture";
   Real pressG(        unit="M.L-1.t-2") "Gas pressure";
  
   flow Real molGF[ nComp](        unit="mol.t-1") 
    "Molar flow of each component";
   flow Real energyGF(             unit="M.L2.t3") "Energy flow";
  
  
end cutGasR;

JARA2i.cutsB.cutHeatFC JARA2i.cutsB.cutHeatFC

Heat flow - Connector F-C. Connector for the heat convection.

JARA2i.cutsB.cutHeatFC

Information

 
 Heat flow - Connector F-C.
Connector for the heat convection.

JARA models whose interface contains the cutHeatFC connector: Liquid TP, Gas TP and Temperature source.

Parameters

TypeNameDefaultDescription
IntegernComp1Number of components

Contents

TypeNameDescription
IntegernCompNumber of components
RealmatterF[nComp]Matter amount of each component [M or mol]
RealtempFTemperature [T]
flow RealheatFHeat flow [M.L2.t-3]

Modelica definition

connector cutHeatFC 
  "Heat flow - Connector F-C. Connector for the heat convection." 
  
   parameter Integer nComp= 1 "Number of components";
  
   Real matterF[ nComp](        unit="M or mol") 
    "Matter amount of each component";
   Real tempF(                  unit="T") "Temperature";
  
   flow Real heatF(             unit="M.L2.t-3") "Heat flow";
  
  
end cutHeatFC;

JARA2i.cutsB.cutHeatFR JARA2i.cutsB.cutHeatFR

Heat flow - Connector F-R. Connector for the heat convection.

JARA2i.cutsB.cutHeatFR

Information

 
 Heat flow - Connector F-R.
Connector for the heat convection.

JARA models whose interface contains the cutHeatFR connector: Heat-flow by convection and Heat-flow source.

Parameters

TypeNameDefaultDescription
IntegernComp Number of components

Contents

TypeNameDescription
IntegernCompNumber of components
RealmatterF[nComp]Matter amount of each component [M or mol]
RealtempFTemperature [T]
flow RealheatFHeat flow [M.L2.t-3]

Modelica definition

connector cutHeatFR "Heat flow - Connector F-R.
 Connector for the heat convection." 
  
   parameter Integer nComp "Number of components";
  
   Real matterF[ nComp](        unit="M or mol") 
    "Matter amount of each component";
   Real tempF(                  unit="T") "Temperature";
  
   flow Real heatF(             unit="M.L2.t-3") "Heat flow";
  
  
end cutHeatFR;

JARA2i.cutsB.cutHeatMC JARA2i.cutsB.cutHeatMC

Heat flow - Connector M-C. Connector for the heat conduction.

JARA2i.cutsB.cutHeatMC

Information

 
 Heat flow - Connector M-C.
Connector for the heat conduction.

JARA models whose interface contains the cutHeatMC connector: Liquid CV, Gaseous CV and Temperature source.

Parameters

TypeNameDefaultDescription
IntegernComp Number of components

Contents

TypeNameDescription
IntegernCompNumber of components
Realmatter[nComp]Matter amount of each component [M or mol]
RealtempTemperature [T]
flow RealheatFHeat flow [M.L2.t-3]

Modelica definition

connector cutHeatMC " Heat flow - Connector M-C.
 Connector for the heat conduction." 
  
   parameter Integer nComp "Number of components";
  
   Real matter[ nComp](        unit="M or mol") 
    "Matter amount of each component";
   Real temp(                  unit="T") "Temperature";
  
   flow Real heatF(            unit="M.L2.t-3") "Heat flow";
  
  
end cutHeatMC;

JARA2i.cutsB.cutHeatMR JARA2i.cutsB.cutHeatMR

Heat flow - Connector M-R. Connector for the heat conduction.

JARA2i.cutsB.cutHeatMR

Information

 
 Heat flow - Connector M-R.
Connector for the heat conduction.

JARA models whose interface contains the cutHeatMR connector: Heat-flow by diffusion and Heat-flow source.

Parameters

TypeNameDefaultDescription
IntegernComp Number of components

Contents

TypeNameDescription
IntegernCompNumber of components
Realmatter[nComp]Matter amount of each component [M or mol]
RealtempTemperature [T]
flow RealheatFHeat flow [M.L2.t-3]

Modelica definition

connector cutHeatMR " Heat flow - Connector M-R.
 Connector for the heat conduction." 
  
   parameter Integer nComp "Number of components";
  
   Real matter[ nComp](        unit="M or mol") 
    "Matter amount of each component";
   Real temp(                  unit="T") "Temperature";
  
   flow Real heatF(            unit="M.L2.t-3") "Heat flow";
  
  
end cutHeatMR;

JARA2i.cutsB.cutLiquidC JARA2i.cutsB.cutLiquidC

Liquid flow - Connector C. Connector for the liquid flow.

JARA2i.cutsB.cutLiquidC

Information

 
 Liquid flow - Connector C.
Connector for the liquid flow.

JARA models whose interface contains the cutLiquidC connector: Liquid CV and Liquid pressure source.

Parameters

TypeNameDefaultDescription
IntegernComp Number of components

Contents

TypeNameDescription
IntegernCompNumber of components
RealmassL[nComp]Mass of each component [M]
RealtempLTemperature [T]
RealpressLPressure [M.L-1.t-2]
flow RealmassLF[nComp]Mass flow of each component [M.t-1]
flow RealenergyLFEnergy flow [M.L2.t-3]

Modelica definition

connector cutLiquidC " Liquid flow - Connector C.
 Connector for the liquid flow." 
  
   parameter Integer nComp "Number of components";
  
   Real massL[ nComp](  unit="M") "Mass of each component";
   Real tempL(          unit="T") "Temperature";
   Real pressL(         unit="M.L-1.t-2") "Pressure";
  
   flow Real massLF[ nComp](           unit="M.t-1") 
    "Mass flow of each component";
   flow Real energyLF(                 unit="M.L2.t-3") "Energy flow";
  
  
end cutLiquidC;

JARA2i.cutsB.cutLiquidR JARA2i.cutsB.cutLiquidR

Liquid flow - Connector R. Connector for the liquid flow.

JARA2i.cutsB.cutLiquidR

Information

 
 Liquid flow - Connector R.
Connector for the liquid flow.

JARA models whose interface contains the cutLiquidR connector: Liquid CV and Liquid pressure source.

Parameters

TypeNameDefaultDescription
IntegernComp Number of components

Contents

TypeNameDescription
IntegernCompNumber of components
RealmassL[nComp]Mass of each component [M]
RealtempLTemperature [T]
RealpressLPressure [M.L-1.t-2]
flow RealmassLF[nComp]Mass flow of each component [M.t-1]
flow RealenergyLFEnergy flow [M.L2.t-3]

Modelica definition

connector cutLiquidR " Liquid flow - Connector R.
 Connector for the liquid flow." 
  
   parameter Integer nComp "Number of components";
  
   Real massL[ nComp](  unit="M") "Mass of each component";
   Real tempL(          unit="T") "Temperature";
   Real pressL(         unit="M.L-1.t-2") "Pressure";
  
   flow Real massLF[ nComp](             unit="M.t-1") 
    "Mass flow of each component";
   flow Real energyLF(                   unit="M.L2.t-3") "Energy flow";
  
  
end cutLiquidR;

JARA2i.cutsB.cutReceiver JARA2i.cutsB.cutReceiver

Information receiver.

JARA2i.cutsB.cutReceiver

Information

 
 Information receiver.
The receiver connector is a resistive causal connector.

JARA models whose interface contains the cutReceiver connector: Automatic controller, Valve and all source types.

Parameters

TypeNameDefaultDescription
Integerdim Dimension of the Signals vector

Contents

TypeNameDescription
IntegerdimDimension of the Signals vector
Realsignal[dim]Signals

Modelica definition

connector cutReceiver " Information receiver." 
  
   parameter Integer dim "Dimension of the Signals vector";
  
   Real signal[     dim] "Signals";
  
end cutReceiver;

JARA2i.cutsB.cutVolConstrGas JARA2i.cutsB.cutVolConstrGas

Volume constraint - Gas.

JARA2i.cutsB.cutVolConstrGas

Information

 
 Volume constraint - Gas.
JARA models whose interface contains the cutVolConstrGas connector: Gaseous CV. The volume constraint connector models the constraints that the recipients impose on the CVs volume.

Contents

TypeNameDescription
RealvcE[3]Recipient Volume
flow RealvcFGas Volume

Modelica definition

connector cutVolConstrGas "Volume constraint - Gas." 
  
   Real vcE[3] "Recipient Volume";
   flow Real vcF "Gas Volume";
  
   // Real      dummyVol  (unit="L3")              "Dummy variable";
   // Real      dummyVol1 (unit="L3")              "Dummy variable";   //= dummyVol
   // Real      press     (unit="M.L-1.t-2")       "Pressure";
  
   // flow Real vesselV   (unit="L3")              "Vessel volume";
  
  
end cutVolConstrGas;

JARA2i.cutsB.cutVolConstrLiq JARA2i.cutsB.cutVolConstrLiq

Volume constraint - Liquid.

JARA2i.cutsB.cutVolConstrLiq

Information

Volume constraint - Liquid
 
JARA models whose interface contains the cutVolConstrLiq connector: Liquid CV.
The volume constraint connector models the constraints that the recipients impose on the CVs volume. 
The liquid CV is always equal to the recipient CV.
   

Contents

TypeNameDescription
RealvcE[3]Recipient Volume
flow RealvcFLiquid Volume

Modelica definition

connector cutVolConstrLiq "Volume constraint - Liquid." 
  
   Real vcE[3] "Recipient Volume";
   flow Real vcF "Liquid Volume";
  
   // Real  vesselV       (unit="L3")              "Vessel volume";
   // Real  dummyVol      (unit="L3")              "Dummy variable";
   // Real  pressTopRef   (unit="M.L-1.t-2")       "Pressure";
  
   // flow  Real  fluidV  (unit="L3")              "Fluid volume";
  
  
end cutVolConstrLiq;

JARA2i.cutsB.cutVolConstrVessel JARA2i.cutsB.cutVolConstrVessel

Volume constraint - Vessel.

JARA2i.cutsB.cutVolConstrVessel

Information

 Volume constraint
 
JARA models whose interface contains the cutVolConstrVessel connector: Recipient.
The volume constraint connector models the constraints that the recipients impose on the CVs volume.
The gaseous CV is equal to the recipient volume if there isn't liquid inside the recipient.
If there is liquid inside the recipient, the gaseous CV is equal to the recipient volume minus the liquid volume.
This connector is used by the class interf.vesselI.

Contents

TypeNameDescription
RealvcE[3]Recipient Volume
flow RealvcF 

Modelica definition

connector cutVolConstrVessel "Volume constraint - Vessel." 
  
   Real vcE[3] "Recipient Volume";
   flow Real vcF;
  
   // Real   vesselV    (unit="L3")          "Vessel volume"; 
   // Real   dummyVol   (unit="L3")          "Dummy variable";
   // Real   dummyPress (unit="M.L-1.t-2")   "Pressure";
   // flow Real dummyVolF  (unit="L3")       "Dummy variable";  // = -dummyVol
  
  
end cutVolConstrVessel;

HTML-documentation generated by Dymola Tue Jul 24 19:08:18 2007.