OLGA 6 GUI User Manual

_GUI USER MANUAL
V E R S I ON 6.0
be dynamic ®
O L G A GUI U S E R M A N U A L Page i
TABLE OF CONTENTS
Page
1. INTRODUCTION 1
2. STARTING THE PROGRAM 2
3. THE OLGA OVERALL STRUCTURE 2

3.1 GUI Object model 2
3.2 Pipe model 3
3.3 Files and file extensions 4
3.4 Organizing and working with Projects and Cases 4
3.5 Converting cases from previous OLGA versions 7
3.5.1 Converting OLGA 2000 cases 7
3.5.2 Converting OLGA 5 cases 8
4. SELECTING THE SIMULATION ENGINE AND OTHER SETTINGS 9
5. GUI LAYOUT 12
5.1 Start page 12
5.2 The Graphic editor 13
5.2.1 Network view 13
5.2.2 Flow path view 25
5.2.3 3-D view 27
5.3 Model view 28
5.4 File view 29
5.5 Components view 30
5.6 Properties 31
5.7 Output view 32
6. CASE DESIGN 34
6.1 New project 34
6.2 New case 34
6.2.1 Build from empty template 35
6.2.1.1 Case information 35
6.2.1.2 Flowpath 35
6.2.1.3 Complete the defined objects 36
6.2.1.4 Changing a global label 36
6.2.1.5 Add new objects 38
6.2.1.6 Copy/Paste 38
6.2.1.7 Define output variables 39
6.2.1.8 Activate OLGA Viewer 44
6.3 Open existing projects/cases 45
6.3.1 Open project 45
6.3.2 Open case 45
7. INPUT EDITORS 46
7.1 Time series editor 46
7.2 INITIALCONDITIONS and HEATTRANSFER 47
7.2.1 Initial conditions 47
7.2.2 Heat transfer 51
8. SIMULATION WITH CONTROLLERS 55

8.1 Signal network terminology 55
8.2 Graphical configurations of controller connections 55
i
O L G A GUI U S E R M A N U A L Page ii
9. SIMULATIONS WITH SEPARATORS 59

9.1 Graphical configuration and multiphase coupling of separator 59
10. SIMULATION WITH BUNDLES 61

10.1 About SHAPES 62
10.2 About LINES 62
10.3 About CROSSOVER nodes 63
11. GEOMETRY EDITOR 65

11.1 Activating 65
11.2 Enter a new profile 66
11.3 Edit Geometries 68
11.3.1 Edit the table 69
11.3.2 Edit the graph 69
11.3.3 Check angle distribution 70
11.3.4 Filter the data 71
11.3.5 Complete the data 71
11.3.6 Define sectioning 71
11.3.7 Use the new geometry 74
11.3.8 Menus 75
11.4 Limitations 76
12. PARAMETRIC STUDY 77
13. SIMULATION 84
13.1 OLGA 6 Command Prompt 85
14. VIEW YOUR RESULTS 86

14.1 Active case trend plot 86
14.2 Active case profile plot 88
14.3 Adding notes on the plot 89
14.4 Some general features of the plotting tool 90
14.5 Plot templates 90
14.6 Export/import data to/from MS Excel 92
14.7 Multi-case plotting 94
14.8 Fluid properties 95
14.9 OLGA Viewer 97
14.10 Menus 97
14.11 Reports 98
15. ONLINE HELP 99
16. GENERAL WINDOW OPERATIONS 100

16.1 Moving windows 100
16.2 Moving objects inside graphical editor 100
16.3 Hot keys 100
16.4 Moving view in 3D 101
17. MENUS 102

17.1 File 102
17.2 Edit 102
17.3 View 102
17.4 Project 103
17.5 Simulation 103
17.6 Tools 103
17.7 Windows 103
17.8 Help 103
ii
O L G A GUI U S E R M A N U A L Page iii
18. TOOL BARS 104

18.1 Standard 104
18.2 Simulate 104
18.3 Plot 104
18.4 Layout 104
iii
O L G A GUI U S E R M A N U A L Page 1
1. INTRODUCTION
This document shall help you to get started with OLGA 6.0. OLGA 6 uses the same
Graphical User Interface (GUI) as OLGA 5 with some additional and some changed
features.
The main differences compared to OLGA 5.3 are:
Graphical configuration of
• Controllers
• Bundles
• Separators
Plot templates
Possible to give a pvt-file as input in multiphase toolkit
Utility for running cases without opening the GUI
The main new features of the GUI compared to the old OLGA 2000 GUI are:
Graphical configuration and visualization of complex networks with

• Drag and drop
• Graphical copy and paste
• Automatic detection and classification of internal nodes
• Positive flow direction can be indicated on flowpath
• Pressure boundary nodes are distinguished
• Network coupling table with configuration capability
Design time verification of model and listing missing items

• Errors are detected while the model is created
• Action buttons for missing items 1
GEOMETRY Editor with spreadsheet type input

Copy directly from Excel
Both XY and Length-Elevation input are displayed.
Automatic Sectioning without simplification
Direct access to simplification procedure with new angle distribution details
Automatic inversion of pipe profiles which facilitates e.g. annular models
New Plotting Functions

• Select variables from a complete list with descriptions
• Make your own standard sets of variables with units
• Within a graph - copy directly to and from Excel
Spreadsheet type input and visualization of input series
New Parametric study function
New RESTART function
Context sensitive help
1
2. STARTING THE PROGRAM
OLGA may be started in one of the following ways:
• Start menu Æ All Programs ÆSPT Group Æ OLGA 6.0

• Double click the OLGA icon on the desktop
• Click on the OLGA icon in the QuickLaunch bar (if available)
3. THE OLGA OVERALL STRUCTURE
3.1 GUI Object model

The GUI works with objects, which are generally organized as follows (see also an
example of a "Model View" on the next page):
• Project-X Top level, a Project can hold several cases

o Case-XY1 Simulation information for Case-Y in Project-
X
Library Keywords globally available
Materials
Walls
Case definition Case title, author, date etc.
Network components Flowpaths with objects

Boundary and initial conditions
Piping
• BRANCH
• GEOMETRY
o PIPES
Process equipment
Output
Nodes
Type and type specific input
Coordinates
FA-models Inputs for flow assurance modules like

Slugtracking
Waxdeposition
Corrosion etc.
Compositional Input for compositional models

AdvancedThermal Input regarding FEMTherm, Bundle etc.
Output Global output definitions
o Case-XY2 Simulation information for Case-XY2 in

Project-X
o Case-XY3
o
o Case-XYn etc.
2
3.2 Pipe model

In the chapter above we have mentioned the term Flowpath. Flowpath is a more
general term than Branch and comprises well tubing, special risers, topside piping
etc.
In the OLGA GUI the Flowpath has only one keyword - namely its Label, while any
Branch has the same fixed label, i.e. BRANCH. In the model file that is sent to the
OLGA simulator the BRANCH key gets the label of the Flowpath.
3
When you open an OLGA 2000 .inp file with OLGA, ref. section 3.5, you will see that
the Flowpaths take the labels of the Branches in the original file.
Moreover, in the new GUI the Geometries must have separate labels. The
Geometries can be identical in all other respects, as before.
3.3 Files and file extensions

A Project has its own xml-file with a filename e.g. Test-C-5.opp (ref. previous
section). This file only refers to a collection of case files e.g. Case-0.opi, Case-01.opi,
etc., which also are xml-files and contain the input specifications etc.
When the case is run, the OLGA output files are produced (.out, .tpl, .ppl and .rsw).
These are the same as for OLGA 5 and OLGA 2000. In addition a text-file with the
extension .genkey is also printed. This is an input-file used by the OLGA 6 simulation
engine. A corresponding file with the extension .geninp was created by OLGA 5. The
format of the .genkey is slightly different from .geninp.
The files with a ~ prefix e.g. ~Case-0.opi is the case file from the last save. With auto-
save on, ref. chapter 4, all case files in a project are saved with user-specified
intervals.
3.4 Organizing and working with Projects and Cases

The "Project" concept was introduced in OLGA 5. The idea is that a Project contains
references to all files relevant to an OLGA project. This could include specifications,
special calculations in Excel, reports etc.
The OLGA GUI requires that you work with a project and here are some ground-
rules:
When you open the OLGA GUI all projects accessible with your user account on your
network are listed on the GUI Front-page (you can hide the list in
TOOLSÆOPTIONS).
When you make your first project (or a new one), you can select to create a normal
explorer folder for the project (the folder gets the same name as the project).
By the same token you may select not to create a new folder but use an existing one.
If you start your session by making a New Project– the GUI will first ask you for the
name of a new project (.opp), and then you may create a New Case.
4
The window below opens and you can select a blank case (to start from absolute
scratch), a single-branch template (OLGA Basic) or a three-branch template (OLGA
Basic Network). The two templates are runnable cases.
5
Below you see a Model view of the OLGA Basic Network template case.
You can have only one Project open at the time 2 .

If you open another project you will be asked if you want to save the current one.
You can select save or save as and close the project (FILE menu).
You can create and keep the project files (.opp) and the case files (.opi) in separate
locations.
With “Save Project” you save the Project and the case files in their origins.
2
You can have several instances of OLGA with the same project open – actually working with
the same case. This should be used with great care.
6
You can add as many new cases as you like (FILE-menu) to your project. Existing
cases (from other Projects or OLGA 2000 .inp files) can be copied over to your
current project.
You can also remove a case from a project (case is not deleted, just de-coupled from
the project). All cases belonging to the project shall be visible in one of the GUI views
(Model or File- view).
3.5 Converting cases from previous OLGA versions

When you open old cases in the OLGA 6 GUI they will be converted to the OLGA 6
format. Most cases will be converted automatically, but some need additional manual
steps to be runnable in OLGA 6. This is mainly cases with bundles and separators.
The automatic conversion is described in the next two sections – all exceptions are
described in the ‘OLGA 6.0 Conversion Guide’ (available from the start menu Æ All
Programs Æ SPT Group Æ OLGA 6.0 Æ Documentation).
3.5.1 Converting OLGA 2000 cases
When you have installed OLGA, you will notice that the OLGA 2000 input files have
been attributed with a special icon.
You can convert your OLGA 2000 input files (.inp) with the new GUI. The
straightforward way is to open an .inp file with the GUI which then makes a project
and a case with the name of the .inp file. If you open more .inp cases they will be
added to the project.
If you want to convert a folder of OLGA 2000 cases into OLGA format you can do as
illustrated below:
1. Select all the cases (e.g. shift left-click on the topmost case)
2. Drag the cases over to the e.g. Model view window in the OLGA GUI
The GUI will now make a project using the same name as one of the cases.
7
3.5.2 Converting OLGA 5 cases
All *.opi files are stored with a version tag, indicating which version they were stored
with. This has the implications that when you are using the latest version to open a
case or project from earlier versions you will get a question about conversion.
If you for example have produced a case in version 5.3 and want to open it in version
6, start the OLGA 6 GUI, open the case and in the following question choose convert.
If you have produced a case in version 6 and want to open it in version 5, start the
OLGA 5 GUI and open the case and in the following question choose convert.
Note that all cases in one project must use the same version of the engine.
8
4. SELECTING THE SIMULATION ENGINE AND OTHER SETTINGS

The overall simulator settings are specified under Tools->Options.
Settings under the General tab are:
- My Project Location: Location where file dialogs will open.

- Show start page at start-up: If applied - start-page with recent projects will
appear when starting the GUI. A sub-setting is "show the project list on the start-
page".
- Use cached static data: This is set by default during installation. The GUI will
then store certain data the first time the simulator is started. This speeds up file
loading and is recommended to obtain the best performance from the program.
The General tab can also be used to specify if the program shall execute auto-save
at specified intervals.
In the OLGA version tab one can specify which version to use by marking one of the
displayed versions. It is possible to work with different simulation engines under the
same GUI (this includes OLGA 2000 versions as long as it accepts the keywords you
actually use). Refer to the ‘Installation Guide’ for a description on how to set up
several simulation engines in the OLGA 6 GUI.
External programs that should be available from the Tools menu can be specified
under the External Tools tab. Some programs are set by default during installation
and the user can specify additional programs like Excel, a text-editor etc.
The Graphics tab is used to specify the pipeline layout view:

- Turn the background grid on and off and specify the colours of the gridlines.
- Set the canvas colour.
- Choose the interpolation method for the flowpath lines.
- Set flowpath colour.
The Default Units tab is used to select your preferred set of units. You can select
between three predefined sets (SI, metric and oilfield) or you may specify your own
set of units.
9
10
11
5. GUI LAYOUT
5.1 Start page

When opening the OLGA graphical user interface the Start page will appear. The
central window contains a list of recent projects and the date when they were last
modified. A project can be opened by clicking on the case name.
A new project can be started from the New Project button at the bottom of the screen.
12
5.2 The Graphic editor

5.2.1 Network view
Below you see a snapshot from the GUI with the template case Case0 loaded. All the
windows are described in the following sections. The windows may be moved around
(outside or inside the frame) and may be docked as described in section 16.1.
Click left button on canvas and

use mouse wheel to zoom in/out
The central view in the figure above shows the Network view with its Graphical editor
functions.
• Zooming in and out is done by the mouse wheel.

• Moving the mouse while the left mouse button is held down will move the layout
within the window.
• Pressing Q adjusts the graphical view to the frames. Holding Shift and pressing
Q zooms out in steps.
• Focus is shifted away from selected objects by pointing to the background while
holding down the Shift key.
Nodes and flow lines are drawn schematically. Network components (Nodes and
Flowpaths) can be dragged into this view from the “Components” window. Sources,
Pressure boundaries and Process equipment are visible and their properties may be
entered or modified by selecting the object (left-click) and filling in their “Properties”.
In the figure the properties of the NODE OUTLET are shown to the right.
13
Double click on
blue line:
The window above is the 2-dimensional Flowpath view which shows one Flowpath at
the time. The functions for "moving" the graph are the same as for the Network view,
ref. Chapter 5.2.2 for more details.
14
You can drag equipment to the canvas from the Process Equipment Components on the
left. When e.g. a valve is dropped on the canvas it "attach" to the middle of the Flowpath as
illustrated below. The actual position and other data for the valve can be entered in the
Properties window for the Valve which now is in focus (to the right).
By entering the data e.g. the PIPE and SECTIONBOUNDARY the valve will take its
specified position on the Flowpath.
Each graphic view has its own tab and if you click on the Case0-tab (see below) you get
back to the Network view.
Click here to get back to

Network view
Select NODE
and drag it onto
the canvas
How to make a new Flowpath:

Start with dragging a Node from the Components window and drop it on the canvas, as
shown above.
Then you make a new Flowpath by following the instructions in the drawing below:
15
To make a new flowpath:

Right-click in the blue square:
Keep right button down and drag
towards the OUTLET Node.
(the cursor looks like this- )
When the cursor looks like: +

release and select” Connect”
in the window below.
A new Flowpath has been added:
The new Node and Flowpath also appears in the Model View window, see below:
16
An alternative method for adding a flowpath.
Select the Components window
Select a FLOWPATH and drag it to the canvas. Then drag a new node to the canvas.
17
A new Flowpath and a new

Node have appeared.
Then do as illustrated below.
1
Right-click on
canvas and
select Network
Connections.
2 Couple the Flowpath_1 From

OUTLET To NODE_1
18
Re-configure the network:
Move node(s) to
make the network
look better
Connecting Nodes and Flowpaths can be done as follows:

• Point to the red dot at one end of a Flowpath (the red dot indicates that
this end of the Flowpath is not connected).
• Hold down the right mouse button, initially pointing to the blue square that
has appeared at the end of the Flowpath.
• Move the mouse pointer to the Node which the Flowpath should be
connected to and release.
• Select connect from the pop-up box that appears. The dot at the end of
the Flowpath turns green, indicating that a connection is established.
Alternatively:
• Right-click on the view background and select Network Connections.
• Select the "from-to" nodes for each Flowpath and click OK. The network
should appear as specified.
19
Select Red dot on Flowpath
Right-click within the blue square and move pointer towards NODE_0. Select Connect to
…and release mouse button.
Do the same with the other end of the Flowpath.
20
Disconnect a Flowpath from a Node by left-clicking on the Flowpath and then point to the
green dot at the end of the Flowpath. Hold down the left mouse button while moving the
end of the Flowpath away from the node and release. The dot at the end of the Flowpath
should now be red, indicating that it is not connected.
Left-click on Flowpath, select green dot (left-click) and drag endpoint away from Node.
21
Right-click while pointing to an object in the Model view brings up various menus
depending on the object:
- Add : Add items to the network object.

- Verify : Checks input file and reports errors and missing input in the output view..
- Copy : Copy selected item.
- Paste : Paste the copied item onto the currently selected item.
- Delete : Delete selected object.
- Properties : Starts property editor for selected object. For a Flowpath this would be the
Geometry Editor while for other items it would typically be a time series
editor.
For example: pointing to a Flowpath gives the alternatives below.
22
Text labels in the Network view (which reside in their separate text boxes) can be rotated
and scaled in addition to moved (except those for Flowpaths). Move is the default edit
mode.
You can either select the edit mode on the toolbar
m s r
or you can type one of the following letters to change the edit mode for the selected text
box.
s: Scale: (left-click in the triangle and drag

while keeping the mouse button down)
r: Rotate: (left-click in the sector and drag horizontally)
m: Move: (left-click in the square and drag)
You can add fixed points on a Flowpath by pressing Ctrl while double-clicking anywhere on
it. A fixed point, indicated by a small square, appears on the Flowpath.
The fixed points can be moved to shape the Flowpath (this does not change the actual
geometry of the Flowpath).
23
More points are added by repeating the Ctrl double clicking. You remove the fixed points
by Ctrl double click within its blue square.
Right-click in the Network view activates a menu with the following items:
Copy as picture: A "Case.jpg" file with the Network view is copied to the folder
where the project resides.
Network Connections: Opens the network overview/connection window
24
Network plot allows for a quasi-animated plotting of profiles in the Network view.
Configure: Allows for (re)configuration of e.g. colours and line interpolation.
3D View Changes to 3D view as described in section 5.2.3.
Show directions Direction arrows are displayed on each Flowpath.
5.2.2 Flow path view
The actual profile of the geometry may be viewed by opening the flow path; double click
FLOWPATH in the “Model View”. This opens a new tab in the Graphical Editor
25
showing the selected flow path only (including equipment). In the Flowpath view equipment
may be added by drag and drop from the “Components” window (the available components
are now the ones that is located on a specific Flowpath).
Focus an object by a left mouse click to bring up the Property editor, and the properties of
the object can be entered or modified.
Focus is shifted away from selected objects by pointing to the background while holding
down the Shift key.
26
Zooming in and out is done by the mouse wheel and moving the mouse while the left
mouse button is held down will move the layout within the window.
5.2.3 3-D view
Both the Network view and the Flowpath view are available in 3-D. Right click on the
view background and check 3D View in the menu. See Section 16.4 about moving
the "camera" position, moving the pipeline network and zooming in 3-D.
The Flowpath view will show the real pipeline profile. If the correct coordinates are
given for the nodes the network view will be correct. Otherwise a schematic view of
the network is transformed to 3D.
27
5.3 Model view
The Model View is used for navigation between the objects of the system. The
objects are ordered hierarchically with a Project on top comprising one or more
cases. A case contains Case Definitions, Libraries, Output, Network Connections and
Network Components.
• Case Definitions describe information common to the whole system simulated.

• Network Components describe the properties of the flow network (currently
either a node or a flow path).
• Libraries contain keywords that can be accessed globally (for instance Material
and Wall).
• Output contains global output definitions, such as plotting intervals for trend,
profile and output.
• FA-models contain input to flow assurance models.
• Compositional has input to the compositional model.
28
• Advanced thermal contains input to the FEMTherm and bundle models and
input to annulus calculations.
When selecting an object in the project explorer, the object is made active and its
properties may be edited in the “Properties” view.
The model view contains input for all cases in the project. Switching between the
different cases is done by clicking on the file name in model view.
5.4 File view

The “File View” shows the input files of the project.
By right clicking on a file the file can be removed or the input file can be opened in a
text editor. The format of the text file is the OLGA 6 simulation engines .key format.
This is slightly different from the OLGA 2000 .inp format. You may edit the text file
and reload it into the GUI by right-clicking the opi-file and select ‘Reload from text file’
29
5.5 Components view
Simulation objects may be fetched from the “Components” window by Drag & Drop
onto the Graphical Editor. Only objects available at the network level presented are
available. This means that e.g. process equipment can be introduced this way only
when the Flowpath is open.
30
5.6 Properties
The “Properties” window is a common interface to

all simulation objects (keywords). Here the objects
are defined setting values on the different keys.
The left column gives the property name (currently
the key name), the right its value.
Units may be altered as shown in the figure. By

default the value will update when the unit is
changed. To keep the value: Press the Shift key
while changing the unit.
When a property is selected, a description is

shown in the field at the bottom.
Values may be inserted by typing or by selecting

one or several values presented by the interface.
The colours of the keys have the following

meaning:
Black : Key can be given but not required.

Red : Key required.
Grey : Key cannot be given.
Note that the colours will change as input is given.

As an example: Two keys are mutually exclusive
and one of them must be given. Both will then
initially be red (required). When a value is given for
one of the keys its colour will change to black (key
is given and no more input required for that key)
while the other key will turn grey (can not be
given).
Some keywords have a special property page to

make the process of entering data easier. These
property pages can be accessed through the
property editor button at the top bar of the property
editor window (see chapter 7 for a description on
input editors).
31
5.7 Output view

The output view (not to be confused with the OUTPUT keyword/OUTPUT File) gives
information about the state of the cases, modelling and simulations. The information
comes out three categories:
• Error messages (and task list) - : Cannot simulate

o Errors in input
o Errors from initialization phase
o Errors during simulation
o List of incomplete keywords.
o Click on the symbol to go to the incomplete keyword
• Warnings - : The simulation may still be performed 3
• Information -
o Simulator state changes
o Progress during simulation
o Any messages during simulation (info previously directed to DOS
window)
The windows can be cleared from the context menu (right click).
Text can be copied:

• Mark text
• Right click and copy
3
Warnings from the OLGA interpretation of fluid files which takes place when the simulation has started are
categorized as Information
32
Which Output categories are active are indicated by the "orange" background around the
category names in the top bar of the output window. A left mouse click on the text will
activate and deactivate.
By default the output from the active case is shown. Output from other cases is selected
from the pull-down menu at the top of the output window.
33
6.CASE DESIGN
All cases reside inside projects, and projects may hold one or several cases. Project
files have extension .opp, case files have extension .opi.
6.1 New project

A new project is defined by:
• Select File/New/Project
• Ctrl+Shift+N
• Click the New Case icon or New Project at the base of the Start Page.
When starting a new project a new folder can optionally be created by checking the
“Create folder” box.
6.2 New case

A new case is defined in one of the following ways:
• Select File/New/Case (you will be taken into a dialog to create a new project if
not already done)
• Ctrl+N
• Click the New Case icon
Then, the window below appears:
34
Enter a case name (or use default), fill inn location (or use default) and select
template.
• OLGA Case File. This generates an empty case.

• OLGA Basic Case. This generates a complete basic case. Ready for
simulation.
• OLGA Network case. This generates a complete basic case with an internal
merge node.
6.2.1 Build from empty template
A case containing the minimum required information is built as follows:
6.2.1.1 Case information
Complete the information of the following elements by right click on the case in the
Model view and selecting from the drop down menu:
CaseDefinition > CASE

CaseDefinition > FILES
CaseDefinition > INTEGRATION
CaseDefinition > OPTIONS
NOTE:
Software (e.g. PVTsim) for generation of fluid-files may be started from the GUI
through the Tools Menu. How to add programs to the Tools menu is described in
section 4.
6.2.1.2 Flowpath
Define a flowpath like this:
1. Drag two nodes from the component bar

2. Drag a Flowpath from the component bar.
35
3. Connect the nodes as described in section 5.2.1.
A default Geometry is created. Refer to chapter 10 about the Geometry Editor for
modification of the Geometry,
6.2.1.3 Complete the defined objects
The defined simulation objects must now be completed. Information that needs to be
given can be found as follows:
1. Verify by
a. Press F7 or
b. right click on the case in the Model View and select Verify or
c. Click the Verify button in the Simulate toolbar
2. View the instructions presented in the task list in the Output window
3. Double click the task to open the relevant object in the “Properties”
4. Complete the fields marked red
5. View the instructions given in “Errors”.
Once enough information is given to the simulator, the state will change from Not
Runnable to Ready to Simulate.
Ready to simulate does not necessarily mean that the case is completely perfect for
OLGA. This is because the rules applied through GUI are not covering all input
checks which may let incomplete specifications or wrong definitions slip through.
A typical example: if you have specified initial conditions for the individual pipes in a
Flowpath (Branch) and then add a pipe without specifying initial conditions for that,
the rules are not able to catch this before starting the simulation.
6.2.1.4 Changing a global label
In the GUI the update of a modified object label is performed semi-automatically, e.g.
if you change a Wall label which has already been applied and you run verify, you get
an error message and a way to amend this as given below:
36
In the case outlined above the first 3 pipes and the 5th pipe have WALL-2. Now you
change the WALL-2 label to WALL-2B (for your own good reasons) and run Verify:
You now get the following error messages:
and the Properties window shows a "common key" where all instances of use of the
original key (WALL-2 in this case) are listed and checked, see below.
You can now change the WALL-2 to WALL-2B and run verify again:
37
The change of the WALL-label is now acknowledged (only the plotting specification
remains) as you also see from the PIPE-specifications, e.g. for PIPE-1:
6.2.1.5 Add new objects
New objects may be added in two ways:
• Right click on a FLOWPATH in the Model View and select from the appearing
groups
• Open the Flowpath view (double click on a FLOWPATH in the model view) and
drag & drop from the “Components”.
As new objects are introduced, the simulator state normally changes to Not
Runnable. Complete the definitions as described above.
6.2.1.6 Copy/Paste
By right clicking on an object in the model view it can be copied (alternatively by Ctrl-
C) and pasted at the desired location by right click and Paste (alternatively Ctrl-V).
38
Copy/Paste can also be performed directly in the canvas by pointing at an object,

right click and select copy, point to where the object is to be pasted and select past.
Currently multiple select can be used within a Flowpath, but multiple select can not
be used on Flowpaths.
6.2.1.7 Define output variables
Variables can be specified on two levels: On a case level and on a flowpath (branch)
level.
Output intervals (DTOUT and DTPLOT) are usually defined on the case level.
Global variables are specified on the case level. You may also specify variables
common to all branches, equipment and modules on the case level.
Output definitions are set up by right clicking on either case or FLOWPATH and
selecting Add/Output and then select the relevant output function:
This introduces a case Output-key which contains the output definitions on the case
level.
Click on Output, select the time-unit for DTOUT in the Properties and enter e.g. 2:
39
You may now add the DTPLOT for profiles, trends and OLGA-viewer by right-clicking
on Output (or on the case label) select ADD Æ e.g. PROFILE,
and then fill in the DTPLOT in the properties window for PROFILE
(do the same for TREND).
Now you specify plot-variables common to all branches in the case.
You may select the case-Output again and select e.g. PROFILEDATA.
40
Click in the VARIABLE field in the Properties window and then the - box.
Select variables from the window shown below. The variables may be sorted:
• Alphabetically (by name or description)

• Categorized (as seen below)
• Those already selected (click the check box)
The units for plotting variables can be changed when actually plotting, ref. Ch. 14.
When you check OK in the relevant variable selection window all selected variables
appear in the Properties window:
41
Now you can do the same with the global Trend-data.
To specify e.g. local trend data you right-click Flowpath and select ADD etc., as
illustrated below.
You check the variable select-box in the Properties window and make the selection:
You can now give the selection a label and save it. This can then be re-used at
several positions.
In the Properties window you specify where to plot the variables. When checking the
box in the PIPE entry you get into the pipe selection window where you select the
pipe(s) you want. Then you specify the section(s). Observe that you also get an
indication of the absolute position – relative to the start of the Flowpath.
42
You may now add another trend definition by right clicking on the FLOWPATH-Output
key: (you can also define it by right clicking the FLOWPATH):
When you get back to the "Select output variables" window, you can click on the
orange pull-down to re-use the "Rates".
By clicking OK you return to the properties. You enter the pipe selection again and
complete the specification by giving the section(s), see below:
43
6.2.1.8 Activate OLGA Viewer
The OLGA Viewer is a stand-alone animation tool that is installed and defined as an
external tool by default, see the Tools – menu.
The PLOT-key is needed by the OLGA Viewer, and it is always specified on a case
level:
In the Properties window for the PLOT – key you specify both the plotting interval
DTPLOT and the variables. The variables are all plotted for all flow paths (branches)
and all sections of the case.
44
6.3 Open existing projects/cases

You may open an existing Project, an existing OLGA case or an existing OLGA 2000
case (.inp). If you open an existing case after you have opened or created a project
the case will be added to the project. However, if you open an existing case without
having a project, a project with the case name is created. You should save this
project immediately
6.3.1 Open project
Select either of these:

• Select File/Open/Project
• Ctrl+Shift+o
and open a file with extension .opp.
6.3.2 Open case
Select either of these:

• Select File/Open/Case
• Ctrl+o
• Click the Open Case icon
and open a file with extension .opi, .key or .inp.
45
7. INPUT EDITORS
7.1Time series editor

Input keys with time series can be edited in a time series editor. The time series
editor is accessed through the properties for the relevant keyword.
If there are several independent time-varying parameters within one keyword the
graph of these can be displayed by checking them in the graph legend (which shows
the minimum necessary input parameters).
46
You can insert columns in the spreadsheet by right-clicking on a column-header.
Selecting "cancel" nullifies all actions performed within the time series editor.
A trick: to fill in the same value for several time points: enter the value in the column
for the last time-point and then enter.
7.2 INITIALCONDITIONS and HEATTRANSFER

Special editors are available for editing initial conditions and heat transfer statements.
The input is graphically displayed together with the data. An example of an initial
condition is shown in some detail below. An example of heat transfer specification is
also given.
7.2.1 Initial conditions
You access these screens through the property editor button on the
INITIALCONDITION statements.
Note that these screens can only be used when entering data section-wise. However, by
selecting cells in the spreadsheet and right clicking, a number of interpolation options are
available. These will help input the desired data. Also, if incomplete data is given it will
automatically be completed when exiting the editor.
The procedure for entering INITIAL CONDITIONS could then be:

Set OPTIONS STEADY STATE= OFF
Add Initial conditions by right clicking on the relevant FLOWPATH:
47
The property window for Initial Conditions (IC) comes up similar to the left window
below:
In the IC Editor the default pressure unit is used and you cannot change it within the
IC Editor. You must do it in the Section-wise part of the window below. To make the
unit change active, you must also enter a pressure value.
To activate the IC Editor you click the property button on top, see below:
48
The IC Editor screen.
We see the profile of the pipeline (ref GEOM-A in next section) and the constant pressure
that was entered (50 bara).
To enter a realistic pressure profile left-click on the top of a column (selects all) and then
right click and then left click in Interpolate. The Interpolate window below comes up.
Select interpolation method and then Start/Stop values and OK. Now all sections are
filled in e.g.
49
Fill in Temperature, Void Fraction, Watercut and MassFlow in the same manner (or by
applying a mix of manual input and automatic interpolation). When finished, the Initial
Conditions Property windows would look like below:
50
7.2.2 Heat transfer
The heat transfer properties could look like below:
By clicking the properties icon of this window you enter the Heat Transfer Editor
(HT Editor).
51
The methods for manipulating the parameters are the same as for the Initial Conditions,
but here we shall illustrate how to enter two constant values for ambient temperature.
We assume that the temperature is changing from 6 to 4 C at the top of the first hill and
remains (sufficiently) constant at 4 C for the rest of the pipe distance. The first hill is at
about 25 km (X) and we can use the HT Editor to see in which PIPE that is (the X-column
to the left) namely at the end of PIPE-14 (i.e. beginning of PIPE-15).
52
Now you select all the pipes from PIPE-15 to the end by Left-clicking in the Tambient-
column for PIPE-15 and drag to the bottom.
Right click anywhere in the selected column and enter 4 C for start and stop-value, see
below:
You now see that the ambient temperature drops from 6 to 4 C on the first hill.
53
Click OK and the HT properties window is also updated.
54
8. SIMULATION WITH CONTROLLERS

In OLGA 6 the controllers are signal components. Signal components are a special kind of
network components, able to transfer signals between each other. Coupling in the signal
network is possible between the following components (notice that a controller is always
involved):
• Pipeline section variable (via a transmitter) to controller
• Inline component (ex. valve, pump, compressor etc.) to controller
• Sources (source and well) to controller
• Node variable to controller
• Separator variable to controller
• Controller to controller
• Controller to inline component
• Controller to separator
• Controller to source
This chapter describes how to connect signal components in the GUI.
8.1 Signal network terminology

The following explanations of the terminology used for signal networks can make it easier
to understand how controllers are connected to other components.
A signal component is a component that can send and/or receive a signal. A signal
component (e.g. a controller) is connected to other signal components (e.g. a flowpath) via
terminals.
Terminals are best explained with an example; A PID Controller has 3 terminals, 2 for
receiving signals (the setpoint signal terminal and the measured signal terminal) and one
for sending signals (the output signal terminal). Another signal component like a separator
can send its holdup value as a signal to the PID Controller. The holdup will be sent via the
measured signal terminal of the controller. The PID Controller will calculate an output signal
based on the measured value and send it via the output signal terminal to e.g. a valve.
A signal is just a value. There isn’t much difference between a signal in a signal network
and a flow in a flow network. The flow represents a physical flow of oil, gas or water while
the signal can represent anything – the meaning of the signal to the signal component
depends on which terminal that is used to send the signal. In the example above the signal
represented a measured value since it was sent via the measured signal terminal.
A flowpath may send measured values as signals. To do this one must add a transmitter to
the flowpath. The transmitter acts as an output signal terminal for the flowpath. Most inline
process equipment added to the flowpath can act as a signal terminal for the flowpath in
the same way as a transmitter (you may for example connect a controller directly to a
valve).
8.2 Graphical configurations of controller connections

Coupling of signal components is possible with two different techniques in the graphical
user interface;
i) Coupling with drag and drop - or -

ii) Coupling through the connection view
Drag and drop coupling

55
The drag and drop coupling between two signal components is done in the same manner
as between two multiphase network components:
1. Click a component and drag towards another component in the signal network (see list
of legal couplings above)
2. Release on the second component.
A context menu is shown with available terminals to connect from and to
3. Choose one of the available terminals to connect from (only OUTSIG_1 is available in
the figure above) and a terminal to connect to (MEASRD and SETPOINT is available in
the figure above). A connection between the two components is created.
4. Select variable to transmit.

If the coupling is between a transmitter and a controller, a variable to be transmitted has
to be given. Setting this variable must be done in the connection view
56
Coupling using the connection view

The drag and drop technique for coupling components in the signal network is less
practical when the case is large with many components. Dragging from one component to
another may involve zooming to view both components, and thereby making the coupling
difficult.
It is possible to connect signal components using the connection view without seeing the
other components.
In the figure below the connections for a PID-controller is shown. All terminals (in-/out-
signals) for controller CNTRL-1 are listed in column one (Terminal). Column two
(Connected NC) and three (Connected terminal) lists which network components and
terminals the controller is connected to. If a user-chosen variable is supposed to be
transmitted column four (Variable) is used.
The connection view has two modes. The above figure shows connections for a selected
component. The other mode is for showing all connections in the case. In this mode it is
easier to see the direction of the signals (see figure below)
57
Hiding and deleting connections

If there are many controllers the case may be too complicated to get a good overview. In
such cases you may hide the controllers and their connections. Do this by right clicking on
a controller and select ‘Hide’. To hide all controllers select ‘Hide all of this type’.
If you have connected a controller by mistake you may delete the connection by selecting it
and pressing the ‘Delete’ button. NOTE: If you delete a controller the connection is not
deleted automatically - you have to select the connection and press the ‘Delete’ button.
58
9. SIMULATIONS WITH SEPARATORS

In OLGA 6 the separator is a network component. This means that it can not be inserted
into a flowpath the same way as inline process equipment (like sources and valves).
The separator has four types of terminals, INLET, GAS, OIL and WATER (only for three-
phase separator). One or more flowpaths leads into the separator and are connected to the
separator INLET terminals. It is required to connect at least one flowpath to each terminal
type. All terminals allow both in and out flow from the separator.
A separator is connected to flowpaths much the same way as nodes. Chapter 8.1 shows
how a separator is coupled to flowpaths and nodes.
9.1 Graphical configuration and multiphase coupling of separator

The multiphase coupling of a separator is made in the same manner as a multiphase
coupling between a node and a flow path.
Add a node and a separator to your case from the component view.
Connect a flowpath from the node to the separator as follows:

1. Click the node and drag.
2. Release on separator.
3. A context menu will display which out-terminals on the node it is possible to connect
from and which in-terminals on the separator it is possible to connect to. In the figure
below the flow path is connected to the inlet terminal of the separator
Add another node to your case.
Connect a flowpath from one of the separator outlets to the node as follows:
1. Click the separator and drag.
59
2. Release on the node.

3. A context menu will display which out-terminals on separator it is possible to connect
from and which in-terminals on the node it is possible to connect to. In the figure below
the flow path is connected from the gas outlet terminal of the separator to node 1. The
oil outlet terminal of the separator is connected via another flowpath to node 2.
60
10.SIMULATION WITH BUNDLES

This description covers Fluid Bundles, Solid Bundles and Annuluses. In OLGA 6 these
bundle types are network components. In this chapter the simulation of bundles is
illustrated by a SOLIDBUNDLE example.
To add a SOLIDBUNDLE right click the case level tab and choose Add >
ThermalComponent > SOLIDBUNDLE (see figure below).
When the Solid Bundle is added, go to the property window and

specify the required fields: DELTAT and DTPLOT. These
parameters govern the frequency of updates of output from the
FEMTherm computation (i.e. the computation of temperatures in
the solid). The LABEL and MESHFINENESS fields may also be
updated.
A bundle in OLGA 6 consists of several components. The components of the bundle are
flowpaths, shapes and possibly internal bundles. Note that all the components that
constitute the bundle must be defined (added) elsewhere. Flowpaths and Lines must be
defined as FlowComponents, Shapes must be defined under Library and bundles must be
defined as ThermalComponents. Position labels to use for the specification of TO and
FROM must be defined for each flowpath under “Piping”.
To add a component to a bundle (i.e. to specify that it is a part of the current bundle)
choose Add > BundleComponents > COMPONENT in the Model View as shown in the
figure below.
In the property window for the new component, specify the

required fields:
• The type of the component (specify either a FLOWPATH, a

61
LINE, a FLUIDBUNDLE, an ANNULUS or a SHAPE)

• The start and stop position of the Bundle (TO and FROM)
• The geometric center of the component (XOFFSET and YOFFSET)
• The OUTERHVALUE of the component (optional)
Note that the position of the origin of any cross-sectional coordinates is irrelevant as long
as all coordinates within one and the same bundle refers to the same coordinate system. It
is only the relative cross-sectional position that matters.
10.1 About SHAPES

A SHAPE in OLGA 6 defines the circumference of an area where a
cross-sectional temperature profile may be computed by the
FEMTherm module. Within this area heat is assumed to be
transported by conduction in the radial direction.
To add a SHAPE to a case right click the Library in the Model View
and choose Add > SHAPE. In the property window for the new
shape, fill out the type of the shape (CIRCLE, ELLIPSE,
RECTANGLE, POLYGON) and the material. For any type of SHAPE
the layout of the cross-section must also be defined. As illustrated by
the property window to the right, a Circle requires the specification of
a radius, an ellipse requires a width and a height, a rectangle
requires the specification of coordinates of the lower left and upper
right corners, and a polygon must be defined by a series of
coordinates.
10.2 About LINES

A LINE in OLGA 6 is a flowpath for which a simplified one-phase
computation is performed. LINEs can be connected in networks, just
as regular flowpaths can, but in a LINE network all the network
components must have the parameter LINE set to YES. A complete
case may contain several LINE-networks and several multiphase
networks, but the two types of networks can not be coupled to each
other.
To add a line to a case in the GUI, right click the FlowComponent in

the Model View and choose Add > FLOWPATH. In the property
window for the new flowpath select LINE=YES. Then select
FLUIDTYPE (gas, oil or water).
Connect the LINE to a node in the same manner as other flowpaths
are connected. Note, however, that the connected nodes must also have the parameter
LINE set to YES.
62
10.3 About CROSSOVER nodes

A CROSSOVER node in Olga 6 is a special type of single phase
node which can be used in LINE networks only. The CROSSOVER
node is a pressure boundary node with the following additional
features: It must be connected to two LINES, and it imposes a given
pressure difference (called MAXPRESSUREBOOST) between these
two lines (at the connection point).
A crossover node is added to a case in the same manner as any

node is added: right click the FlowComponent in the Model View and
choose Add > NODE. In the property window for the new node
select TYPE=PRESSURE and LINE=CROSSOVER, then enter the
rest of the required fields.
63
64
11.GEOMETRY EDITOR
11.1 Activating
Pipeline profiles are edited in the Geometry Editor. The tool can be started like this:
• Tools/Geometry Editor (opens with only default data) or

• Select the Property page for the active geometry (opens with data for the selected
geometry)
You may also select FLOWPATH (or GEOMETRY) in the Model-View and right click and
then select Properties:
You will now see this graph of the default geometry for the single branch template:
65
11.2 Enter a new profile

You can work with an existing profile in the .xy-format by File/Import and opening the
relevant xy-file with the browser (e.g. Profile-A.xy - this Geometry is given below).
66
You should save this new Geometry with a new label while in the Geometry Editor (e.g.
GEOM-A. The saved geometry file has the extension .geo:
You must also give the new Geometry relevant sections, diameters, roughness and walls.
How to do this is described below.
You can also copy directly from an Excel –worksheet:

Open the Geometry Editor and select FileÆ New. You will get a new Geometry with one
pipe and default values as given below. The geometry is now presented in a tabular
format and you can toggle between this and the graphic format by clicking on the relevant
tab.
Open the Excel-file with your profile-data, select the X-Y columns and copy.
Select the Start Point 0, 0 in the Geometry Editor with the default geometry open and then
Paste. You will get the question below. Answer yes and the data will be pasted directly
over to your open geometry.
67
Please observe that if your excel geometry contains fewer pipes than the one you
paste over, you must delete the obsolete pipes.
You can now save this Geometry (e.g. GEOM-B) and use it for one or several
Flowpaths in any model. First you must of course complete it with sections, diameters
etc., as you do in the window below.
11.3 Edit Geometries

When opening the Geometry Editor you have seen that two views are available i.e.
the graph of the profile and a table of pipes. The two windows can be viewed
simultaneously by selecting the e.g. plot tab and drag it towards the bottom of the
window (as has been done below).
68
11.3.1Edit the table
New pipes are added, renamed or deleted, by right-clicking in the Pipe column and
selecting the relevant action.
X and Y in the table give the data for the end point of the pipe. Changing Length-
Elevation affects X-Y and vice-versa 4 .
Units are changed by right clicking in the title cell (e.g. “Diameter [m]”) and selecting a
unit.
11.3.2Edit the graph
You can also edit the Geometry by the following actions under the Actions menu:
4
There is a bug in OLGA v5.0. Entering X-values instead of Length should eliminate the problem.
69
Normal (no change)

A: Add a point
M: Move a point
D: Delete a point
Restrictions on the graphic editor can be imposed (Actions -> Restrictions):
X Fixed (X remains fixed, Y can be changed)

X Bound (Point X-value can not be moved upstream or downstream neighbors)
Y Fixed (Y remains fixed, X can be changed)
Y Bound (Point Y-value can not be moved above or below neighbors)
Recursive (all points downstream will follow the point that is being moved)
11.3.3Check angle distribution
You can check the angle distribution of a Geometry by selecting Tools -> Check
angle distribution. You can see the angle groups that are used by right clicking when
in the output window from the angle distribution calculation. You can also change the
angel groups.
70
The color of the bars and the % values in the output window indicate the difference
between the average angle of the pipes within a group and the mean value of the
angle group. Green (and a low % deviation) means a good relevance of the angle
group. The % value is a numerically calculated standard deviation divided by half of
the angle group span.
11.3.4Filter the data
Select Tools/Filter. You have two options: a Box filter or a preservation of angle
distribution / total flowpath length (the algorithm is identical to the one used in the
OLGA 2000 Grid Generator).
Box filter: This filter is more relevant for removing relatively small disturbances from
a pipeline survey. Enter the horizontal sample distance and the vertical sample
height. These values define a moving rectangle (a box) within which all data points
will be filtered out. The filtered data appear as a new geometry which may be further
filtered/ edited.
Angel distribution: Enter the maximum pipe length that shall be used to filter the
profile while maintaining the angle distribution and the total pipe length.
When filtering has been completed it is a good idea to compare the angle
distributions of the original geometry and the filtered ones. The filter with the best
reproduction of the original geometry should be used – keeping in mind that the angel
groups should be representative.
11.3.5Complete the data
You may want to open the e.g. GEOM-A.geo file.
All fields except the “Length of sections” are editable directly, and copy/paste may be
used for single cells. The "Length of sections" has its own input support-tools
In contrast to OLGA2000 all Pipes must have a Diameter, a Roughness and a Wall (if
relevant). You can use copy-paste functions to achieve this.
If defined in the OLGA case, walls may be selected from the drop down menu.
Within the Graph window the profile may be edited activating either of the four menu
functions (found under Actions -> Graphical):
11.3.6Define sectioning
The pipe sectioning can be performed in two ways:
1. Manually enter number of sections in the “# Sections” column. This gives you
equally long sections for a given pipe.
2. If you double click in the Length of Section list you enter a tool to distribute
sections of various lengths over the pipe-length.
71
Change (the nominal) no of sections to 3 and enter 4.75 m in Section 1 and click OK.
You get 2 sections of 4.75 m and 1 of 4.64214 m.
72
The main rule is that the tool ensures that you get a sum of sections which is equal to
the pipe length. Moreover, open section lengths mean that you repeat the value
above.
The "remaining of total" is the total pipe length minus length accumulated over the
section lengths specified (including the open ones).
If you double-click in the Length of Sections field again:
You get the window below and you see that the remaining now is very close to zero.
73
To start over again you can set # of sections to 0.
3. Use the discretization tool (Tools/Discretize). Then all pipes are given the same
selected number of sections.
11.3.7Use the new geometry
A new geometry may be imported to a case as follows:

Open the geometry files you want to use (you can open them from the Geometry
editor or in explorer). Right click on FLOWPATH or Piping in the Model View, select
“Exchange Geometry” and pick the desired geometry. If you use the same Geometry
file for several branches you must re-label the Geometries afterwards to secure that
the labels are genuine.
You can also exchange geometries between flow paths in the same case. Select the
flow path and its Property Page of the Geometry you want to distribute to other flow
paths. Then you select the flow paths that you want to import to and select Exchange
Geometry:
Select FLOWPATH and click on Properties. This opens the Geometry GEOM-1_2
Select destination FLOWPATH and click on Exchange Geometries and then on

GEOM-1_2.
74
11.3.8Menus
The Geometry Editor features the following menus:
File
New New geometry
Import Import xy-data
Open Open geometry file (*.geo)
Close Close geometry
Save Save geometry
Save As Save geometry as new file
Print Print active window
Print Preview
Print Setup
<Recent File>
Send
Exit
Edit
Undo
Cut
Copy
Paste
Configure Configure graph window
View
Global Overview
Standard
Restrictions
Graph
Status Bar
Labels
Walls
Actions
Graphical Normal/Add/Move/Delete
Restrictions X Fixed/X Bound/Y Fixed/Y Bound/Recursive
Tools
Angle groups
Check Angle Distribution
Check section lengths calculate the length ratio of adjoining sections.
Discretize Automatic pipe sectioning (all equal)
Filter Filter data
Reset Pipe Labels Use default pipe labeling
Reverse geometry Creates a geometry that is the mirror image of the
original geometry (in x-direction).
Window
New window New window with active data (works on same data set)
New window Select graph or table representation
New Horizontal Tab Group
New Vertical Tab Group
More Windows
Help
Help Topics Not implemented
About Geometry Version Information
75
11.4 Limitations
The following important limitation applies:
1. For export to Excel, dot (“.”) must be selected as decimal separator for Excel
76
12. PARAMETRIC STUDY

Parametric studies are defined through Tools-Studies, where new studies can be
added or previously performed studies reopened.
The input screen for parametric studies is shown below.
The number of parameters is given in the field labeled “#Parameters”.
At present studies can only be performed on the local machine, but the number of
simultaneous simulation can be given (#Parallel simulations). This can be useful for
machines with multiple processors or multithreading.
77
The quick way to enter an equidistant parameter variation is given below:
Right-click in MASSFLOW below and select Set Value(s)
78
Set the e.g. the values below:
This results in the definition of 4 cases ready for running. You may save the study by
clicking OK. The study is saved in a separate folder together with the Project/Case.
79
Click Run Study and observe the progress:
80
When finished select e.g. Trend Plot:
81
Select variables for plotting e.g. QLT at PIPE-86 (outlet total liquid flow):
Change units and then plot.
82
More details on plotting are given in Ch. 11 and for more details on Matrix.. and XY-
Plot see Tutorial (accessed from the Help menu in GUI).
Set up a study with non-equidistant parameter values:
Add a new study and right click on the Case column to add new entries.
Now follow the same procedure as for equidistant parameter values:
Right click on the column with (<Right click to select parameter>), select Source
and then Massflow.
Enter one value for mass flow for each case and press Run Study. When cases are
finished you can plot to see the results.
83
13. SIMULATION
Simulation is controlled by the simulation menu. There are some alternative ways to
run a simulation.
Run simulation
Press “Run simulation” for starting a simulation. Progress is visualized in the output
window and on the progress-bar in the lower right-hand corner.
Run in batch
Press ‘Run Batch’ to start the simulation in a separate command prompt. Output and
progress is shown in the command prompt
Run Project and Run Project Batch

If you have more than one case in your project you have two alternative options. ‘Run
Project’ and ‘Run Project Batch’ are available in the simulation menu and runs all cases in
the current project in sequence. You can specify the sequence by setting the project
84
dependencies. Right click the project in the Model View and select ‘Project
Dependencies…’.
Set dependencies in the dialog to obtain the wanted simulation order.
13.1 OLGA 6 Command Prompt

You may also run your cases without even opening the GUI. Select the ‘OLGA 6 Command
prompt’ from your start menu (Start Æ All Programs ÆSPT Group Æ OLGA 6.0 Æ Tools Æ
OLGA 6 Command Prompt). A command prompt is opened and you may use the special
‘opi’ command. Type ‘opi /?’ to bring up help on all available options for this command.
Here are some examples of what you can do with the opi command:
Run a single simulation from the current folder

opi sample.opi
Run all cases in the current folder

opi *.opi
Run all cases in the current folder and all sub-folders

opi /recursive *.opi
Run all cases that starts with the letter ‘a’ with a specific version of the OLGA engine
opi /recursive /version 6.0 a*.opi
The opi command may run opi-files, inp-files, key-files, geninp-files and genkey-files.
85
14. VIEW YOUR RESULTS

Trend and profile plot output as defined by the user can be viewed during and after
simulation. The plotting buttons on the top menu will show red lines when plot files
are available for the active case.
Trend Profile PVT File
14.1 Active case trend plot

Select trend plot with the buttons in the top menu. Trend plot gives you the menu
below. Select the variables you want to plot. Double click on the selection or right
click and chose one of the options displayed. Click OK to see the graph.
There are many ways to filter the content of the dialog above. Note that the filtering is
a tool for locating the variables. The selected variables are plotted even if they are
‘filtered away’.
86
The default time unit for a Trend plot is seconds which you change at the lower left.
87
14.2Active case profile plot

You select the profile button and then select variable(s) to plot:
You may now "play-back" the profile plot, either by dragging the slide or by clicking the
green triangle. You may also freeze a curve by clicking the "needle" button.
88
You get a frozen curve each time you click it. You "un-freeze" by disable the needle.
The play-back is stopped by clicking the blue square. You may play-back several profiles
simultaneously, but the speed will of course depend on your PC-capacity.
14.3 Adding notes on the plot

You may add a descriptive note to the plot by selecting Edit ÆAdd Note from the
context menu. The dialog allows you to enter a text and to attach the case to one of
the series in the graph.
89
You may change or delete the note by right clicking it and select Edit Æ Edit Note
from the context menu.
14.4 Some general features of the plotting tool

The plotting tool is a quite sophisticated program and you have access to several
functions for modifying your graph 5 .
• Add/remove data to plot:

o Right click and select Dataset/Select or
o Menu Options/Select Plot Variables
• View values: Right click and select Track values
• For profile plots: select plot time point with slider at bottom right
• Collapse/expand axes: Right click and select
o Axes/Collapse all or
o Axes/Expand all
• Display legend: Right click and select Show legend
• Modify settings
o Right click and select Configuration (window as below) or
o Menu Options/Configuration
• Zoom:
o Select upper left corner with left mouse button
o Drag to lower right corner while holding button
o Release
• Un-zoom: Do as for zoom, but drag to the left (any start and end point works)
• Zoom in/zoom out/un-zoom buttons are also available
14.5 Plot templates

If you need to generate the same plot several times you may save the plot configuration as
a plot template. A plot template includes information of the selected variables, sequence of
selected variables, colours, units and more. Plot templates are convenient if you for
5
You may also change default colours, text styles etc.
90
example need to run the same case several times or if you have several nearly identical
cases (e.g. restart cases).
To create a plot template you first configure the plot, and then select FileÆSave As
Template… The template is stored as a .tpl.tz/.ppl.tz file in the location you specify.
To use a plot template click on the arrow on the right side of the profile/trend plotting
buttons.
Select template from the drop down with recent templates or select ‘Browse’ to locate a
template not in the list.
A plot template can also be opened from within the plot (FileÆOpen Template). Note that a
plot template will overwrite the current plot when opened this way.
91
14.6 Export/import data to/from MS Excel

• Export data: In the Select variable… dialog, mark the variables that you want to
export and then press the Export button. Select if you would like to export
data to clipboard or to file. If exporting to file you need to specify a location
and name of the file. The file can be opened in any text editor. If exporting to
clipboard, the marked variable data are now copied to the clipboard and can
easily be pasted into MS Excel. Some examples are shown below.
• Paste from Excel: Select data columns in and select copy. In Plot window right
click and select Dataset->Paste.
Trend:
LIQC PIPELINE Total liquid content in PT PIPELINE PIPE-1 1

TIME[s] branch[m3] Pressure[Pa]
15.84771 0.43636 5779854
31.682301 0.439139 5781598
45.757488 0.440115 5782584
61.592091 0.440356 5782887
75.667282 0.440408 5782946
91.501877 0.440434 5782971
100.298897 0.440441 5782979
All the variables marked in the selection dialog are copied to separate columns in the
Excel-worksheet.
92
Profile:
When exporting profile variables, there are some options. First, choose the points in time
that are of interest. Secondly, choose the output grouping. On time copies the variables
sorted on time, while the On variable option copies the variables sorted on variables. See
examples below:
FLOWPATH_1
TIME 0.000000 s
HOLHL PT TM
LENGTH[m] FLOWPATH_1[-] FLOWPATH_1[Pa] FLOWPATH_1[K]
25 0.267856 5020177 333.145386
66.666504 0.269094 5018455 333.140137
TIME 100.655602 s
HOLHL PT TM
LENGTH[m] FLOWPATH_1[-] FLOWPATH_1[Pa] FLOWPATH_1[K]
25 0.266281 5017835 333.145996
66.666504 0.252789 5016175 333.139435
Showing data sorted on time
93
PT[Pa] FLOWPATH_1
Time[s]: 0 30.892229 60.790829 90.689438
Pipeline length[m]
25 5020177 5017983 5017583 5017751
66.6665 5018455 5016377 5015958 5016098
HOLHL[-]
FLOWPATH_1
Time[s]: 0 30.892229 60.790829 90.689438
Pipeline length[m]
25 0.267856 0.252411 0.259354 0.264995
66.6665 0.269094 0.253909 0.249044 0.251571
Showing data sorted on variable
14.7 Multi-case plotting

It is possible to plot results from several cases/projects simultaneously. For example
you can plot data from all the cases in your project (use the Plot Project button in the
select variables… dialog), the in-active as well as the one active. You can open
several results files by the ToolsÆ Plot menu (select several files, either trend (.tlp) or
profile (.plt) or from within the plot tool itself by adding files, see below. You plot as for
single cases.
94
Note that for profile plots where different plotting intervals have been used in the different
files the profile closest to the selected time will be used and no interpolation is currently
applied.
14.8 Fluid properties

You can use the plot-tool to plot fluid-properties. Select Tools-Plot and then open a fluid-
properties file (.tab). You then select the property or properties you want to see and
proceed as usual.
You may use the freeze-function as for profile plots. You click the nail and then the green
triangle. You repeat clicking the nail to freeze more curves.
The default x-axis is temperature. You can change this by moving the column header
fields in the right-hand side window to locate the "X-Axis" field (which is in the far right
position by default) and select Pressure instead of Temperature (see figure below).
95
96
14.9 OLGA Viewer

The OLGA viewer is activated from the Tools-menu from the list of external tools.
You must open the appropriate .plt – file.
The figure shows a snap-shot from the OLGA viewer
14.10 Menus
File
Reload
Save Save chart configuration (tee) with link to data file
(tpl/ppl)
Print
Print Preview
Close
Options
Configuration Configure plot (Chart and Series display options)
Select Plot Variables Select data to be plotted
Help
About Not activated
97
14.11 Reports
A case report can be generated and viewed in WINDOWS Internet Explorer from
Tools Æ Generate Report. This is the first version of pre-defined report format and
has a limited content. This will be expanded in future versions. Since it has a java
script, you must accept the security warning you get in Windows Explorer, before the
functions in the report is activated.
Use the yellow labels to browse the report or check "Printer Friendly version” to
remove the menu system.
98
15.ONLINE HELP
OLGA is equipped with on-line help documentation which can be opened directly
from the user interface. The help can be reached in several ways:
• Click the Properties view and press F1 -> leads to the information on the
relevant model
• Select Help/Help topics from the main menu
The on-line help has the standard features:
• Contents
• Index
• Search
99
16. GENERAL WINDOW OPERATIONS
16.1 Moving windows

Windows may be hidden and re-opened through the view menu. They may be
detached from the frame (floating) and may be docked again by moving the window
to the border of the frame. Double click on a floating window to move it back to the
last docked position.
In the picture below the blue area indicates where the window will end up if dropped
at the current location. If the cursor is moved over one of the arrows towards the
edge of the screen the window will dock on the corresponding border of the frame. If
dropped on one of the four arrows in the centre of the screen the window will dock
towards the corresponding side of the frame of the pipeline schematic window.
Double clicking on the top bar of a docked window makes it float and double clicking
on the top bar of a floating window makes it dock.
16.2 Moving objects inside graphical editor

1. Click on object
2. Click square handle and move in plane
3. Click on arrow and move along axis
16.3 Hot keys

Ctrl+z Undo
z Enable zoom in graphical editor; mark area with mouse
Left shift+z Enable un-zoom in graphical editor; mark area with mouse
Mouse wheel Zoom in or out in graphical editor
Delete Deletes object
100
16.4 Moving view in 3D

The following illustration shows how to navigate the camera in fly mode. In Orbit
Mode left mouse button + moving the mouse will make the camera orbit around the
pivot point. If you release the left mouse button you can use the key combinations to
move around.
Camera manoeuvring:
• Mouse wheel Zoom in/out
• Arrows Move camera in/out/left/right
• Right shift Move up
• Left shift Move down (or: Insert move down)
Left mouse button No selection: Rotate camera

Network selected: Rotate network (see below)
Camera Movement Speed

Slow to Fast Keys 1 – 9
Rotate/Move/Scale
Rotate Select object + key R + left mouse button + move mouse
Move Select object + key M + left mouse button + move mouse
Scale Select object + key S + left mouse button + move mouse
Scene View Shortcuts

Fly Mode Key F
Orbit Mode Key O (recommended to get best overview)
Field of View Mouse wheel, or
key Z + left mouse button + mark area, or
key Z + left mouse click (zoom in)’
Left Shift + key Z + left mouse click (zoom out)
Space Deselect interaction mode
Escape Deselect objects
Q (in 2D View) Zoom to extent
Delete [Del] Delete selected object.
101
17.MENUS
17.1 File
New > Project… Create new project
New > Case… Create new case
Open > Project… Open project
Open > Case… Open case
Save Case Save case
Save Case As… Save a new case
Duplicate Case… Makes a copy of the selected case
Save Project Save project
Close Project Close (and save) project
Print… Disabled
Print Preview Disabled
Print setup…
Recent projects List of projects recently opened
Recent cases List of cases recently opened
Exit Exit
17.2 Edit
Standard windows commands
Undo
Redo
Cut Disabled
Copy
Paste
Paste special… Disabled
17.3 View
Select what windows and toolbars to be visible.
102
17.4 Project
Add New Item… Same as New Case
Add Existing Item… Open an existing file e.g. an .opi file
Project Dependencies
Close Project
17.5 Simulation
Run Start simulation (Start simulation in batch-
messages from simulation are sent to the Output
window)
Stop Stop simulation. Returns to initial state
Pause Pause simulation. Simulation may be resumed
(Not implemented for OLGA).
Run Project Start to run all cases in a project in a given order
Run Batch Start simulation in a DOS-control window.
Run Project Batch Start to run all cases in a project in a DOS-control
window
Verify Verify input
17.6 Tools
The tools available are listed below.
17.7 Windows
Standard windows operations.
17.8 Help
Help topics Online documentation
Getting started Opens pdf file with getting started document.
About Release information
103
18.TOOL BARS
18.1 Standard
New case
Open case
Save Saves Case
Save Project
Copy
Paste
Undo
Redo
Model view
Property editor
Components
File view
Output view
Connection view Disabled
18.2 Simulate
Run Start simulation

Stop Stop simulation. Returns to initial state.
Pause Disabled
Run batch Run batch in DOS window
Verify Verify case
18.3 Plot
Plot current trend plot

Plot current profile plot
Plot current PVT file
View current Output File
18.4 Layout
Fit window
Move Moves a graphic object
Scale Scales an object
Rotate Rotates an object
Circular For systems with defined
Grid Nodes placed in grid
104
Hierarchical type 1 Hierarchy

Hierarchical type 2 Hierarchy
Radial For systems with defined center
V Layout algorithm direction is vertical.
H Layout algorithm direction is horizontal.
Layout of equipment Toggle between relative and sequential layout of
inline equipment
Snap to grid Toggle snap to grid
105
www.sptgroup.com
A product by

OLGA 6 GUI User Manual

Uploaded by

Document Informationclick to expand document information

Document Informationclick to expand document information

Copyright:

Available Formats

OLGA 6 GUI User Manual

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

OLGA 6 GUI User Manual

Uploaded by

Copyright:

Available Formats

_GUI USER MANUAL

2. STARTING THE PROGRAM 2

3. THE OLGA OVERALL STRUCTURE 2

4. SELECTING THE SIMULATION ENGINE AND OTHER SETTINGS 9

8. SIMULATION WITH CONTROLLERS 55

9. SIMULATIONS WITH SEPARATORS 59

10. SIMULATION WITH BUNDLES 61

11. GEOMETRY EDITOR 65

12. PARAMETRIC STUDY 77

14. VIEW YOUR RESULTS 86

15. ONLINE HELP 99

16. GENERAL WINDOW OPERATIONS 100

17. MENUS 102

18. TOOL BARS 104

The main differences compared to OLGA 5.3 are:

Possible to give a pvt-file as input in multiphase toolkit

Utility for running cases without opening the GUI

Graphical configuration and visualization of complex networks with

Design time verification of model and listing missing items

GEOMETRY Editor with spreadsheet type input

New Plotting Functions

Spreadsheet type input and visualization of input series

New Parametric study function

New RESTART function

Context sensitive help

2. STARTING THE PROGRAM

OLGA may be started in one of the following ways:

• Start menu Æ All Programs ÆSPT Group Æ OLGA 6.0

3. THE OLGA OVERALL STRUCTURE

3.1 GUI Object model

• Project-X Top level, a Project can hold several cases

 Case definition Case title, author, date etc.

 Network components Flowpaths with objects

 FA-models Inputs for flow assurance modules like

 Compositional Input for compositional models

o Case-XY2 Simulation information for Case-XY2 in

3.2 Pipe model

3.3 Files and file extensions

3.4 Organizing and working with Projects and Cases

You can have only one Project open at the time 2 .

3.5 Converting cases from previous OLGA versions

3.5.1 Converting OLGA 2000 cases

3.5.2 Converting OLGA 5 cases

4. SELECTING THE SIMULATION ENGINE AND OTHER SETTINGS

Settings under the General tab are:

- My Project Location: Location where file dialogs will open.

The Graphics tab is used to specify the pipeline layout view:

5.1 Start page

5.2 The Graphic editor

Click left button on canvas and

• Zooming in and out is done by the mouse wheel.

Click here to get back to

How to make a new Flowpath:

To make a new flowpath:

When the cursor looks like: +

A new Flowpath has been added:

An alternative method for adding a flowpath.

Select the Components window

Case definition Case title, author, date etc.

Network components Flowpaths with objects

FA-models Inputs for flow assurance modules like

Compositional Input for compositional models