SimSci

DYNSIM 5.3.2
OLGA Send/Receive

December 2016
All terms mentionedin this documentation that are known to be trademarks or service marks have
been appropriately capitalized. Schneider Electric Software, LLC. cannot attest to the accuracy of
this information. Use of a term in this documentation should not be regarded as affecting the
validity of any trademark or service mark.

ActiveFactory, ArchestrA, ARPM, AssayCentral, Autonomous, Avantis, Avantis.PRO,

Connoisseur, CrudeManager, CrudeSuite, DATACON, DATAPREP, DT Analyst, DYNSIM,
DYNSIM Power, Esscor, EYESIM, Factelligence, FactorySuite, FactorySuite A, Foxboro,
Foxboro Evo, FSIM Plus, HEXTRAN, Hot Links, I/A Series, IMPACT, IMServ, InBatch,
InControl, Industrial Portal, IndustrialSQL Server, InFusion, INPLANT, InSQL, IntelaTrac,
InTouch, IPact, Invensys, Logic Validator, MBM, NETOPT, PIPEPHASE, PRO/II,
PROVISION, QI Analyst, ROMeo, SCADAlarm, SIM4ME, SimCentral, SimSci, SimSci-Esscor,
Skelta, Skelta BPM.NET, Skelta Sharepoint, Skelta Sharepoint Accelerator, Spiral Software,
SuiteVoyager, TACITE, Tactical Batch, The Simulator, TRISIM Plus, VISUAL FLARE,
VISUAL FLOW, VISUAL FLOW SUITE, VISUAL NETWORK, Visual Solutions,
VOYAGER, WindowMaker, WindowViewer, Wonderware, Wonderware InTouch, and ZI ZHI
are trademarks of Schneider Electric SE, its subsidiaries and affiliated companies.
2016 by Schneider Electric Software, LLC. All rights reserved.
No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by
any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior
written permission of Schneider Electric Software, LLC. No liability is assumed with respect to
the use of the information contained herein.
Although precaution has been taken in the preparation of this documentation, Schneider Electric
Software, LLC assumes no responsibility for errors or omissions. The information in this
documentation is subject to change without notice and does not represent a commitment on the
part of Schneider Electric Software, LLC. The software described in this documentation is
furnished under a license agreement. This software may be used or copied only in accordance
with the terms of such license agreement.
ArchestrA, Avantis, DYNSIM, EYESIM, Foxboro, Foxboro Evo, I/A Series, InBatch, InduSoft,
IntelaTrac, InTouch, PIPEPHASE, PRO/II, PROVISION, ROMeo, Schneider Electric, SIM4ME,
SimCentral, SimSci, Skelta, SmartGlance, Spiral Software, VISUAL FLARE, WindowMaker,
WindowViewer, and Wonderware are trademarks of Schneider Electric SE, its subsidiaries, and
affiliated companies. An extensive listing of Schneider Electric Software, LLC trademarks can be
found at: http://software.schneider-electric.com/legal/trademarks/. All other brands may be
trademarks of their respective owners.
Schneider Electric Software, LLC
26561 Rancho Parkway South
Lake Forest, CA 92630 U.S.A.
(949) 727-3200
http://software.schneider-electric.com/
 Table of Contents
OLGA Send and Receive .................................................................................... 1
INTRODUCTION ........................................................................................................................... 1
EXAMPLE..................................................................................................................................... 4
DATA ENTRY WINDOW USAGE .................................................................................................. 5
PARAMETER TABLE - STREAMRECEIVE ................................................................................... 8
PARAMETER TABLE - STREAMSEND ....................................................................................... 10

Olga Send/Receive i
 OLGA Send and Receive

OLGA Send and Receive

Introduction

The Olga Send/Receive models are used to conveniently transfer pressure/flow data between a
DYNSIM simulation and an Olga simulation running as part of the DYNSIM simulation. The
user need only to specify the Olga engine name and the Olga boundary or source name and the
DYNSIM model will configure the communication between the Olga engine and DYNSIM
engine.

The Olga receive model can be used to establish the data flow with the Olga boundary pressure
node. Olga receive provides pressure, and pressure sensitivities to the Olga boundary node and
also receive temperature, phase mass rates, and mass rate sensitivities.

The Olga Send model can be used to establish the data flow with the Olga Source. Olga send
provides total mass rates, and flow sensitivities to the Olga source and also receive pressure, and
pressure sensitivities.
 OLGA Send and Receive

Fundamentals

Externally Defined Component Distribution

Olga does not have the same concept of components as DYNSIM application. Therefore, Olga
Stream Receive will need to have a component slate with a reasonable component distribution
defined for it. This should be done in a DYNSIM Source model, which will then be associated
with the Olga Stream Receive model.

Olga Simulation Model Names

The user will have to know the label for the pressure boundary in the Olga simulation when
configuring an Olga Stream Receive model. Likewise, the label of the source in the Olga
simulation will need to know to properly configure the Olga Stream Send model. These names
will be entered as text strings when configuring a model.

Configuring the Model

Olga Stream Receive

There are three essential pieces of information needed to configure an Olga Stream Receive
model. The first two are the name of the Olga engine and the label of the boundary in the Olga
engine from which you want to receive the outlet flow. The third piece of information is the
name of a source, which has an appropriately defined component slate and composition to
represent the stream coming out of Olga. Since Olga does not have the same concept of
components as DYNSIM model, this source is critical to transfer the flow from Olga to DYNSIM
application.

The flow can be specified to run just the DYNSIM engine by itself. In this case the Olga Stream
Receive will act as a source with composition specified in the initialization source and flow rate
specified by the flow parameter.

The two check boxes in the DEW are used to allow or disallow the transfer of pressure and flow
sensitivities to the Olga engine and the DYNSIM engine.

On the DYNSIM model side the Olga Stream Receive model needs to be connected to a pressure
node. In general the larger the holdup of the downstream pressure node the more stable the
simulation will be.

Olga Stream Send

There are two pieces of information needed to configure the Olga Stream Send model. They are
the name of the Olga engine and the label of the boundary source, which will receive the flow
from the DYNSIM engine. In addition the model will act as a Sink if it is not connected to an
Olga engine so a pressure ought to be specified if this mode of operation will be used.

The two checkboxes in the DEW are used to allow or disallow the transfer of flow and pressure
sensitivities to the Olga and DYNSIM engines.
 OLGA Send and Receive

On the DYNSIM model side the model needs to be connected to a flow device. The flow
derivatives across the flow device are used to approximate the flow derivatives for the system.
Therefore as a rule of thumb the larger the pressure drop across the flow device the more accurate
the derivatives sent to the OLGA engine.

Transferred Parameters

From Olga to DYNSIM Model

Olga Engine Point Olga Stream Receive Parameter

PT PB
Derivatives:
DPDGGS DPDWV
DPDGLTHLS DPDWL
DPDGLTWTS DPDWL2

Pressure:
P: Pressure
Sensitivities with respect to phase mass flow:
DPDWV: Pressure w.r.t. gas mass rate
DPDWL: Pressure w.r.t. liq mass rate
DPDWL2: Sensitivity w.r.t. water mass rate

From DYNSIM Model to Olga

Olga Engine Point Olga Stream Receive Parameter

TB SOURCE.3
W SOURCE.1
Derivatives:
DWVDP SOURCE_DERIV.0
DWLDP SOURCE_DERIV.1
DWL2DP SOURCE_DERIV.2

Temperature:
T: Temperature
Mass flow rates:
W: total mass flow
Sensitivities: Phase rate with respect to pressure
DWVDP: Vapor mass rate w.r.t pressure
DWLDP: Liquid mass rate w.r.t. pressure
DWL2DP: Liquid 2 mass rate w.r.t. pressure
 OLGA Send and Receive

Example

A separate document with a brief process description with Olga Engine and model configuration
details and an example s4m file is available in the install kit. Please go to the folder:
\DSS44\Engines\ OlgaInterfaceEngine\Examples\example1.
 OLGA Send and Receive

Data Entry Window Usage

Olga Stream Receive

Olga Remote Connection

The Olga engine name corresponds to the parameter OlgaEngineName. It is the name of
Olga engine to feed data into the OlgaStreamReceive.

The Remote object name corresponds to the OlgaRemoteObject parameter. It is the

name of Olga object to feed data into the OlgaStreamReceive.

The enable pressure sensitivities flag from DYNSIM model to Olga corresponds to the
PresSenFlag parameter. This flag is used to control the pressure sensitivities transfer from
DYNSIM model to Olga.

The enable flow sensitivities flag from Olga to DYNSIM model corresponds to the FlowSenFlag
parameter. This flag is used to control the flow sensitivities transfer from Olga to DYNSIM
model.
 OLGA Send and Receive

Boundary Conditions

The boundary flow corresponds to the FB parameter. This parameter is used if Olga
engine name and Remote object are not specified. This object will then act like a StreamSet with
a fixed flow.

The source initialization object corresponds to the OinitSource parameter. It is used to

define DYNSIM model boundary composition.
 OLGA Send and Receive

Olga Stream Send

Olga Remote Connection

The Olga engine name corresponds to the parameter OlgaEngineName. It is the name of
Olga engine to be linked with the OlgaStreamSend object.

The Remote object name corresponds to the OlgaRemoteObject parameter. It is the

name of Olga object to be linked with the OlgaStreamSend object.

The enable flow sensitivities flag from DYNSIM model to Olga corresponds to the FlowSenFlag
parameter. This flag is used to control the flow sensitivities transfer from Olga to DYNSIM
model
The enable pressure sensitivities flag from Olga to DYNSIM model corresponds to the
PresSenFlag parameter. This flag is used to control the pressure sensitivities transfer from Olga
to DYNSIM model.

Boundary Conditions

The boundary pressure corresponds to the PB parameter. This parameter is used if it is a

stream termination. Note that unlike a Source or Sink this parameter is dynamic.
 OLGA Send and Receive

Parameter Table - StreamReceive

Basic
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Sensitivity Mode.
Network sensitivity used in boundary
SensitivityMode condition for pressure/flow solution KI NETWORK No
0 = LOCAL
1 = NETWORK

Boundary conditions
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Boundary flow.
Boundary flow to be used if this is a stream
Fb DD 0 No Kg-mol/sec
origination. This object will then act like a
StreamSet with a fixed flow.
Vapor mass flow from Olga
WVb DD 0 No Kg/sec
Boundary vapor mass flow from Olga
Liquid mass flow from Olga
WLb DD 0 No Kg/sec
Boundary liquid mass flow from Olga
Liquid 2 mass flow from Olga
WL2b DD 0 No Kg/sec
Boundary liquid 2 mass flow from Olga
Temperature from Olga
Tb DD 297.15 No K
Boundary temperature from Olga
Vapor mass flow sensitivity from Olga
Change in calculated vapor mass flow when
DWVDP DD 0 No (kg/sec)/kpa
downstream node pressure changes. Used to
stabilize connection between networks.
Liquid mass flow sensitivity from Olga
Change in calculated vapor mass flow when
DWLDP DD 0 No (kg/sec)/kpa
downstream node pressure changes. Used to
stabilize connection between networks.
Liquid 2 mass flow sensitivity from Olga
Change in calculated vapor mass flow when
DWL2DP DD 0 No (kg/sec)/kpa
downstream node pressure changes. Used to
stabilize connection between networks.
Fraction of boundary flow
Fraction of Fb set to outlet stream when
KF DD 1 Yes fraction
standalone. Use for temporary flow control
before system integration.

Initialization
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Initialization Source.
OInitSource Source No
Defines component slate and default forward
 OLGA Send and Receive

stream properties

Data flow control

Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Pressure sensitivity flag
This flag is used to control the pressure
sensitivities transfer from DYNSIM model to
Olga. If it is enabled, Olga boundary node
PresSenFlag KB TRUE No
will use the pressure sensitivities from
DYNSIM model. If it is disabled, the
pressure sensitivities will be set to zero and
Olga will ignore it. Default is TRUE.
Flow sensitivity flag
This flag is used to control the flow
sensitivities transfer from Olga to DYNSIM
FlowSenFlag model. If it is enabled, DYNSIM No
OlgaReceive will use the flow sensitivities
from Olga. If it is disabled, the OlgaReceive
will ignore it. Default is TRUE

Calculated variables
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Calculated Exit flow
Fx DD No Kg-mol/sec
Exit flow calculated by solver
Calculated pressure sensitivity
Sensitivity of connect Olga node pressure to
DPDWV DD 0 No (kg/sec)/kpa
change in this vapor mass flow. Sent to Olga
boundary node to stabilize network.
Calculated pressure sensitivity
Sensitivity of connect Olga node pressure to
DPDWL DD 0 No (kg/sec)/kpa
change in this liquid mass flow. Sent to Olga
boundary node to stabilize network.
Calculated pressure sensitivity
Sensitivity of connect Olga node pressure to
DPDWL2 DD 0 No (kg/sec)/kpa
change in this liquid 2 mass flow. Sent to
Olga boundary node to stabilize network.

Topology
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Olga remote engine
OEngineName No
Define the remote Olga engine name
Olga remote object
ORemoteObj No
Define the remote Olga object name
Product stream.
OProdStream STREAM No
The Olga Receive product stream
 OLGA Send and Receive

Parameter Table - StreamSend

Basic
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Sensitivity Mode.
Network sensitivity used in boundary
SensitivityMode condition for pressure/flow solution KI NETWORK No
0 = LOCAL
1 = NETWORK

Boundary conditions
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Boundary pressure
Boundary pressure to be used if this is a
Pb DD 0 No Kg-mol/sec
stream origination. This object will then act
like a StreamSet with a fixed flow.
Pressure sensitivity from Olga
Change in boundary pressure when feed
DPDWV DD 0 No (kg/sec)/kpa
vapor mass flow changes. Used to stabilize
connection between networks.
Pressure sensitivity from Olga
Change in boundary pressure when feed
DPDWL DD 0 No (kg/sec)/kpa
liquid mass flow changes. Used to stabilize
connection between networks.
Pressure sensitivity from Olga
Change in boundary pressure when feed
DPDWL2 DD 0 No (kg/sec)/kpa
liquid 2 mass flow changes. Used to
stabilize connection between networks.

Data flow control

Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Pressure sensitivity flag
This flag is used to control the pressure
sensitivities transfer from Olga to DYNSIM
model OlgaSend. If it is enabled, DYNSIM
PresSenFlag No
model OlgaSend will use the pressure
sensitivities from Olga Source. If it is
disabled, the OlgaSend will ignore it.
Default is TRUE.
Flow sensitivity flag
This flag is used to control the pressure
sensitivities transfer from DYNSIM model to
Olga. If it is enabled, Olga boundary node
FlowSenFlag No
will use the pressure sensitivities from
DYNSIM model. If it is disabled, the flow
sensitivities will be set to zero and Olga will
ignore it. Default is TRUE.
 OLGA Send and Receive

Calculated variables
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Calculated total mass rate
W DD 0 No Kg/sec
Total mass rate to Olga source
Calculated vapor mass flow sensitivity
Sensitivity of upstream vapor mass flow to
DWVDP DD 0 No (kg/sec)/kpa
changes in this pressure. Sent to connected
Olga source to stabilize network.
Calculated liquid mass flow sensitivity
Sensitivity of upstream liquid mass flow to
DWLDP DD 0 No (kg/sec)/kpa
changes in this pressure. Sent to connected
Olga source to stabilize network.
Calculated liquid 2 mass flow sensitivity
Sensitivity of upstream liquid 2 mass flow to
DWL2DP DD 0 No (kg/sec)/kpa
changes in this pressure. Sent to connected
Olga source to stabilize network..

Topology
Parameter Dft Dft Eq Arr
Description UOM
Name Cls Val Ok Siz
Olga remote engine
OEngineName No
Define the remote Olga engine name
Olga remote object
ORemoteObj No
Define the remote Olga object name
Feed stream.
OFeedStream STREAM No
The Olga Send feed stream

Legend:
Dfl Cls Default parameter class:
KB - Static Boolean SB - State Boolean DB - Dynamic Boolean
KI - Static Integer SI - State Integer DI - Dynamic Integer
KF - Static Float SF - State Float DF - Dynamic Float
KD - Static Double SD - State Double DD - Dynamic Double

Dft Val A value here indicates the parameters default value. If the parameter is static, no
value indicates that the parameter is optional unless otherwise noted.
Eq Ok An equation can be attached to the parameter if the corresponding value is Yes.
Arr Siz A value here indicates the size of the array. No value indicates that the parameter is
not a vector.
UOM Internal units of measure.
Please refer to the Base Equipment Fundamentals section for pressure node base
parameters, flow device base parameters, and parameters associated with the flash or
reaction submodel.
Invensys Systems, Inc.
26561 Rancho Parkway South
Lake Forest, CA 92630
United States of America
http://iom.invensys.com

Global Customer Support

Inside U.S.: 1-866-746-6477
Outside U.S.: 1-508-549-2424 or contact your
local Invensys Representative.
Email: iom.support@invensys.com
Website: http://support.ips.invensys.com