OLGA 2015
Version 2015.1
OLGA GUI User manual
Table of Contents
OLGA GUI User manual ... 2
Copyright notice ... 3
Relationship between OLGA GUI and OLGA Simulation engine ... 5
Introduction to projects and cases ... 6
Dataflow in the OLGA GUI together with editors ... 7
Files and file extensions ... 10
Case toolbar ... 12
File menu ... 17
New ... 19
Recent ... 21
Tools ... 22
Help ... 23
Options ... 24
Moving windows ... 26
Diagram view ... 27
Editing a case using the Diagram view... 29
Context menus for the Diagram view ... 30
Network connection overview ... 34
Configuration of separator/phase split nodes ... 35
Configuration of controller connections ... 36
Shortcut keys ... 40
Model Browser ... 41
Adding variables ... 43
Time series editor ... 44
Centrifugal pump ... 47
Case overview ... 52
Flowpath geometry data view ... 53
Output view ... 57
Simulation ... 59
Reports ... 61
Plots ... 62
Common behaviour in trend, profile and fluid plots ... 63
3D Plots ... 68
Fluid plots ... 71
Interactive trend and profile plots ... 72
Profile plots ... 77
Trend plots ... 79
Tools available with OLGA ... 83
OLGA Command Prompt ... 85
OLGA Viewer ... 86
Risk management and optimisation (RMO) ... 87
Parametric study ... 94
Fluid Definition Tool/Fann table ... 99
Mud properties - model description ... 101
IO Configuration Tool ... 104
Add configurations ... 105
OLGA GUI User manual
The complete program documentation includes:
OLGA Release notes
OLGA user manual
OLGA GUI user manual (this document)
OLGA Sample cases
Well editor user manual
OLGA Viewer user manual
Pipeline editor user manual
Profile generator user manaul
FEMTherm editor user manual
OLGA OPC server guide
OLGA Submodelling guide
OLGA Namespace Explorer guide
Installation guide
Rocx User manual
All documents listed above are available from the Start menu (Start - All Programs - Schlumberger - OLGA x.x.- Documentation).
The OLGA User manual is also available from the Help menu in the GUI. User Manuals for other tools included with the installation (e.g. FEMTherm, Rocx, OLGA Namespace Explorer, etc.) are available from the Help menus in the tools.
Release information
Please refer to the Release notes for detailed release information.
Online help
OLGA is equipped with a context sensitive help document 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 from the File menu
Select the Help icon in the upper right corner of the OLGA main window.
Operating system
The program is available on PCs with Microsoft Windows operating systems (Windows Vista, Windows 7, Windows 8, Windows Server 2008 and 2012). Several versions of OLGA may be installed in parallel.
Support centre
The Support Portal provides useful information about frequently asked questions and known issues.
Please contact OLGA support if problems or missing functionality are encountered when using OLGA or any of the related tools included in the OLGA software package.
Copyright notice
Copyright notice
Copyright © 2015 Schlumberger. All rights reserved.
This work contains the confidential and proprietary trade secrets of Schlumberger and may not be copied or stored in an information retrieval system, transferred, used, distributed, translated or retransmitted in any form or by any means, electronic or mechanical, in whole or in part, without the express written permission of the copyright owner.
Trademarks & Service Marks
Schlumberger, the Schlumberger logotype, and other words or symbols used to identify the products and services described herein are either trademarks, trade names or service marks of Schlumberger and its licensors, or are the property of their respective owners. These marks may not be copied, imitated or used, in whole or in part, without the express prior written permission of Schlumberger. In addition, covers, page headers, custom graphics, icons, and other design elements may be service marks, trademarks, and/or trade dress of Schlumberger, and may not be copied, imitated, or used, in whole or in part, without the express prior written permission of Schlumberger. Other company, product, and service names are the properties of their respective owners.
An asterisk (*) is used throughout this document to designate a mark of Schlumberger.
Security Notice
The software described herein is configured to operate with at least the minimum specifications set out by Schlumberger. You are advised that such minimum specifications are merely recommendations and not intended to be limiting to configurations that may be used to operate the software. Similarly, you are advised that the software should be operated in a secure environment whether such software is operated across a network, on a single system and/or on a plurality of systems. It is up to you to configure and maintain your networks and/or system(s) in a secure manner. If you have further questions as to
recommendations regarding recommended specifications or security, please feel free to contact your local Schlumberger representative.
Relationship between OLGA GUI and OLGA Simulation engine
Relationship between OLGA GUI and OLGA Simulation engine
When starting OLGA there are two major components that come into play:OLGA GUI
The OLGA GUI (GUI) is the graphical user interface which allows for the creation of new OLGA cases, editing input, starting simulations, viewing results and much more. This is what is described in detail in this document.
OLGA Simulator
The OLGA simulator is the component that performs the simulation. The simulation is usually started from the GUI but it can also be started independently (using a command line interface). The results from the simulation are stored in plot-files which can be displayed in the GUI.
Introduction to projects and cases
An OLGA case (model) is the collection of all the input data that is sent to the simulator when clicking ‘run simulation’. It normally consists of pipelines, process equipment and more to simulate the real world objects. In addition it contains information about simulation options, boundary conditions, etc. that influence the simulation. A case may also consist of references to other files like tab-files for fluid definitions, files with compressor characteristics etc.
An OLGA project is a container for one or more OLGA cases and is a way of organizing relevant files. A project can contain other information like Word documents, reports, Excel calculations and more. The fluid files referred to in a case are automatically included in the project.
When working in the OLGA GUI, work is always performed within the context of a project and will create a project when one doesn’t exist. When a case is opened, the GUI will create a project for it and when closing the GUI it will prompt to save the project and the case(s).
Dataflow in the OLGA GUI together with editors
Dataflow in the OLGA GUI together with editors
Dataflow in the OLGA GUI
The OLGA GUI can be used to create and edit any OLGA model. The model that the GUI sends to the OLGA simulator is described in a keyword/key based structure. The keywords and their keys can be directly edited in the OLGA GUI. For users familiar with the keyword structure, the OLGA GUI offers a compact editing format using the Model browser and the multikeyword editor. The GUI also includes a set of editors that offer more support for creating new models. An editor in OLGA has the following
characteristics:
An editor contains one or more input pages customized for a specific domain
An editor may impose an internal workflow
An editor does not use the keywords and keys of OLGA but knows how to convert the input given in the input pages to the OLGA keywords and keys.
There are three editors in OLGA: the Pipeline editor, the Well editor and the Bundle editor. Details for working in these editors are given in specific user manuals. In the following topic, the overall workflow is described.
The model you build in an editor can be saved in a library. The library will contain a domain specific representation of the model, not using the OLGA keywords. This model can be reused in different simulation scenarios. Before you run a simulation, you will convert this model into a keyword/key based model which can then be further edited in the keyword based GUI or sent as is to the OLGA simulator. You control the discretization when converting the model to a keyword/key model. This is illustrated in the figure below.
The conversion from editor to keyword/key model is a one-way transition. The generated keyword/key model can be further edited in the keyword based GUI. Any changes made here will not be transferred back into the editor. If you return to the editor after making changes in the keyword based GUI, a warning is issued since when you regenerate the keyword based model, you will overwrite your changes.
Not all changes done in the keyword/key model is overwritten when you regenerate the model from the editor. The following principle is used:
Changes done to the keywords and keys generated by the editor will be overwritten when you regenerate. Changes done to keywords and keys which are NOT generated by the editor will not be overwritten. There are some exceptions to this principle:
Changes done to keys on equipment are not overwritten by the Pipeline editor, except for the keys that control the location of the equipment
Flow connections are not overwritten by either the Pipeline editor or the Well editor
Different strategies when working in editor and keyword based GUI
When you work in an editor, you do not use the OLGA PIPE and SECTION keywords to position objects. You typically give the position of e.g. equipment as a distance from the start of the pipeline or well. This is a fundamental difference between working in an editor compared to working in the keyword based GUI. The conversion from the model built in the editor to the keyword based model is done by the editor. The OLGA PIPEs and SECTIONs are created based on the model built in the editor. The editor will make sure that there is a SECTION or SECTIONBOUNDARY where you have positioned the object. The
discretization of the model adapts to the model, not vice versa. An example illustrates the difference:
Example
Modelling a pipeline with a pump with the following geometry:
Modelling this in the keyword based GUI, you will add PIPE keywords and divide it into a number of sections. In order to position the pump exactly where you want (780 meters into the pipe in this example) you must make sure there is a section boundary at 780 meters. Using the Pipeline editor to model this, you define that the pump is positioned at 780 meter. When you generate the OLGA keyword/key model, the editor ensures there is a section boundary at that position and inserts a pump there.
Since the discretization is vital to the results and the simulation speed , you should consider this when working in the editors. Both the Pipeline editor and Well editor have a Discretization page where you tune and preview the discretized model before creating it.
Workflow for building a pipeline in OLGA using the Pipeline editor and Profile generator
An overview of the basic workflow for building a pipeline in OLGA including the different tools that support this workflow is shown in the figure below.
Dataflow in the OLGA GUI together with editors
The Profile generator is a stand-alone tool which is used to simplify a detailed profile into a profile that is used in an OLGA simulation. Too many pipes and sections will reduce the performance of the OLGA simulator. The Profile generator offers a box filter to remove noise and an angle distribution algorithm to create simplified profiles without compromising the simulation results.
The pipeline profile created in the Profile generator can be imported into the Pipeline editor. In the Pipeline editor, you can add material to the pipeline, add equipment and specify ambient conditions. The model can then be converted into an OLGA keyword/key model. The model can then be further detailed in the keyword based GUI before running the simulation.
When you save the OLGA case into an *opi file, both the input to the editor and the generated model is saved.
Workflow for editing an existing OLGA model
If you have a case not created by using the Pipeline editor, you have two options: 1. You can continue to edit the case using the keyword based GUI.
2. You can connect the flowpaths to the Pipeline editor.
Double-click the flowpath to open it in the Flowpath geometry data view. This is a view of all PIPE keywords in the flowpath. In this view, you can edit all properties of the PIPES. You can also import a geometry to replace the one you already have.
To connect a flowpath to the Pipeline editor, click the Open in editor. Note that when you connect an existing flowpath to the editor, only the profile is transferred. The material given by the WALL keywords and other information is not transferred. You can edit the pipeline in the Pipeline editor and then
regenerate the model. The original flowpath is then replaced with the generated model. If you want to use the old WALLS, you must select them again using the Flowpath geometry data view. Also note that any signal connections to or from the model will be removed and must be reconnected. Connections to nodes and all equipment are kept.
Workflow for building a well in OLGA using the Well editor
The workflow for creating a well using the Well editor is similar to using the Pipeline editor. The Well editor contains some basic functionality for filtering the well trajectory.
You cannot transfer the geometry from an existing flowpath into the Well editor as you can with the Pipeline editor. There is a separate library for wells created by the Well editor.
Files and file extensions
When using the OLGA GUI understanding the different files used by the GUI and the simulator are not required. A basic understanding of the different file types is still useful when backing up files in Windows Explorer or running simulations from the command line. The figure below illustrates some of the files used by OLGA.
Project File (*.opp)
The project file is a file with references to other files (e.g. case files)
Case File (*.opi)
The case file contains all user input in addition to graphical layout of the model, parametric study input and more.
Generated input files (*.genkey)
Files and file extensions
Output files
During the simulation, the simulator will produce several types of output files. The most common are trend plots (*.tpl), profile plots (*.ppl), general output information (*.out) and restart files (*.rsw).
The files with a ~ prefix e.g. ~Case-0.opi is the case file from the last save. With auto-save turned on for all case files in a project, files are saved at user-specified intervals.
Case toolbar
Toolbar icon
Tool tip Shortcut key
Description
Duplicate case A new identical case is created and added to the project
Remove case Gives three options; remove from project delete or delete all output files as well
Save Ctrl+S Saves the case
Save as Opens a window with the option to save the case with a new name
Copy Ctrl+C Copies the selected components. The label consists of the original label and a suffix and is globally unique.
Paste Ctrl+V Pastes the copied components
Delete Delete button
Deletes the selection
Undo/Redo Ctrl+Z to undo Ctrl+Y to redo
You can undo and redo the following actions:
Move and re-size objects
Add objects and keywords
Delete objects and keywords
Change keywords
Change units
Auto-arrange items
Paste actions
Connections
Text changed in Comment field Show Grid Makes the grid on the Diagram view visible
Snap to Grid Snaps items to the grid when moving them; will work even when the grid is not visible
Straight lines Use straight line mode for flowpaths and signal lines. Select this command to
change all existing flowpaths and signal lines from right angled lines to straight lines.
set the default mode. Select Straight line to use this on all new flowpaths and signal lines.
Case toolbar
Toolbar icon
Tool tip Shortcut key
Description
flowpaths and signal lines as well, by using the context menu instead
Right angles Use right angles on flowpaths and signal lines. Select this command to
change all flowpaths and signal lines from straight lines to right angles.
set the default mode. Select Right angle to use this on all new flowpaths and signal lines.
Note that it is possible to apply Right angle mode to individual flowpaths and signal lines as well, by using the context menu instead
Auto route Use auto routing for flowpaths and signal lines.
By selecting this command, the diagram will avoid collisions between the objects on the canvas. Flowpaths and signal lines will automatically be routed around nodes and other objects. The auto routing takes place when you connect a signal or flowpath, as well as when you move the end-points of a flowpath or a signal. Note that only the object you are moving or connecting will be auto routed. After the line is auto routed, you can adjust it by moving the control poinmts (or inserting new ones). This will not trigger the auto routing. Arrange
Horizontally
Rearranges the graphical layout with mainly horizontal flow lines
Arrange Vertically
Rearrange the graphical layout with mainly vertical flow lines
Local instances Shows all local instances of the selected object in an editor table; all valves on one flowpath
Global instances Shows all instances in a case of the selected object in an editor table
Duplicate to all flowpaths
Duplicates the selected object to all flowpaths
Network connections
Opens the Network overview/connection window
Submodel connections
Opens the Submodel connections window.
Add to User’s Library
Adds selected object to the User's Library
Import from User’s Library
Opens the User's Library with a list of objects that can be imported
Toolbar icon
Tool tip Shortcut key
Description
Show user's library
Opens the User's Library with a list of objects.
Parametric Studies
Opens the parametric studies
Copy as image Copies the Diagram view or plot to the clipboard depending on what is in focus in the centre area
Well library location
Opens a window where you can browse for the well library
Pipeline library location
Opens a window where you can browse for the pipeline library
Profile generator Opens a separate tool for creating a pipeline profile to be used in OLGA
I/O
Configuration tool
Opens the I/O Configuration tool used to define plot variables and to populate variables on the OLGA OPC server.
Risk
Management and
Optimisation (RMO)
Opens the Risk management and optimisation tool used to perform sensitivity and uncertainty analysis, as well as tuning/optimisation on parameters defined in OLGA.
FEMTherm editor
Opens a window with easy configuration of bundles/annulus and burial of flowpaths
Pipeline editor Opens the pipeline editor which can be used to add a new pipeline to the case.Click the arrow to the right to view already open pipeline editor instances.
OLGA Well editor
Opens the Well editor which can be used to add a well to the case. Click the arrow to the right to view already open well cases.
Run Batch F4 Runs the simulation from a command shell window, independent of GUI
Run Interactive F5 Runs the simulation well integrated with GUI
Pause F9 Pauses the simulation if run interactively
Step Ctrl+F5 Runs one step (only interactively). Note that this setting does not override the OLGA time step setting.
Step length Option to configure the length of the step Stop Shift+F5 Stops the simulation
Case toolbar
Toolbar icon
Tool tip Shortcut key
Description
Verify F7 Checks input file and reports errors and missing information in the output view
Clear errors Clear all error messages in the Diagram view. You can also select Clear errors from the Context menu of the Output window.
Multiple Plots Adds a plot tab to the case with the option to select and configure multiple plots
Trend Plot Adds a trend plot to the case if trend variable(s) are selected
Profile Plot Adds a profile plot to the case if profile variables(s) are selected
3D Plot Adds a 3D holdup profile plot
Fluid Plot Gives the option to plot the fluid properties defined in a tab file
Report Opens an input report of the case
Save Restart F3 Saves a restart file (only available for interactive simulation and when the simulation is paused)
File menu
File menu
When starting OLGA the File menu will appear with New in focus. From the New page, a case can be created by selecting an empty case or selecting a sample. The samples are complete cases that are ready to simulate.
The File menu can be accessed by clicking on File at any point in time. To exit the File menu click either on the File tab again or on a case tab.
The File menu covers the following:
File menu item Shortcut key Description
Save Project Saves the project and all open cases
Save Project as… (Ctrl+Shift+S) Saves the project and all open cases with a new name Open Case (Ctrl+O) Opens a case of file type *.opi, *.inp or*.key
Open Project… (Ctrl+Shift+O) Opens a project of file type *.opp
Import… Opens a case of file type *.geninp or *.genkey Close Project Closes the project with option to save project New New case or project can be created in this page Recent Recent projects and cases are listed in this page Tools Internal and external tools can be accessed in this page
File menu item Shortcut key Description
Help Information about manuals, sample cases and support Options Opens the options window
New
New
New cases or projects are created from the New page.
A new project is created by clicking on the Empty project icon. This opens a file window to specify the location and name of the project.
A new case is created either by selecting Empty case or by choosing an appropriate sample. There are two ways to select a sample for a new case: From the carousel view or from the icon view. The Sample view is selected with the two toggle buttons in the top right.
In carousel view, the samples can be navigated sequentially and shows a preview of the network and a description of the sample. The selected sample is the front most sample highlighted in the orange selection colour. Navigation is done by clicking to the right or left of the selected sample which will scroll the new selected sample to the front. This can also be done using the left and right arrow keys on the keyboard.
In Categories view, the sample categories are shown on the left side of the window and the samples in each category are shown on the right.
The name and location of the new case can be set at the bottom of the window. Use the Browse button to bring up a file window to choose a different location of the case. The default location of new cases can be changed in the Option window. When selecting a sample, OLGA suggests a default case name based on the sample selected and a number if a case with that name already exists. The new case is created by clicking the Create button or double-clicking on the sample.
The new case will be added to the currently open project. If no project is open, a new project with the same name as the case is created.
Recent
Recent
Previously opened projects and cases can be accessed from the Recent page.
Selecting a recent project will open all cases from that project in separate tabs. Selecting a recent case will open it and add it to the currently open project or create a default project if no project is open.
Tools
The Tools page is accessed through the File menu.
This page gives access to useful utilities which are installed with OLGA. These tools are documented separately. Other external tools may be added to this page via the Options window.
Help
Help
The Help page is accessed through the File menu.
Help option Description
OLGA Help Opens the general user documentation. Wells Help Opens the well GUI documentation.
Getting started Opens a video showing some of the steps to build a case in OLGA
Support Centre Link to the support centre on the Internet. This option requires Internet access. Send to support Zips the projects with all cases and data files and attaches it to an e-mail template. About OLGA Lists the version information.
Options
The overall simulator settings are specified under Options. The Options window is located under the File menu
Settings on the General tab are:
My Project Location: Location where file windows will open.
Specify if the program shall execute auto-save at specified intervals.
Delete .bat file after batch simulation
Simulation threads – number of treads to run simultaneously. By default the number of treads available will be used in an optimal way.
Restore to Factory settings: The layout of the GUI windows, default unit set and similar will be restored.
External programs that should be available from the Tools page can be specified under the External
Tools tab. Some programs are set by default during installation and additional programs like Excel, a
text-editor etc. can be specified. Select Add… to browse for an external tool to include in this list.
The Default Units tab is used to select the preferred set of units. Units can select from three predefined sets (SI, Metric and Oilfield) or a customized set may be specified. The default units affect the none-given properties and the default values in the property editor and also which units the plotting variables are shown in.
Options
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.
You can drag and drop windows anywhere in the Diagram view. Click the mouse cursor in the top bar of a window and drag to relocate. If you drag the window to any border in the Diagram view, the window will snap to place by the border. Click the crosses located in the top bar to minimize and maximize the windows.
Diagram view
Diagram view
When a case is opened or created the central window of the GUI displays a graphical view of the case. Below is a snapshot from the GUI with the Basic sample case loaded. The Diagram view displays pipelines, nodes, process equipment and more. All visible objects are listed in the components view.
In the Diagram view, nodes and flow lines are drawn schematically, not reflecting the real geometry of the case. Sources, pressure boundaries and process equipment are also visible.
Rotate labels in the Diagram view
Description
You can rotate the labels you have used in the Diagram view. This is how you do it: 1. Mark the relevant label. A rotation wheel is displayed above the label:
2. Left- or right-click the mouse pointer and drag the wheel in the direction you want to set the label. Note that you can undo and redo the label editing.
3. Save the case.
Editing a case using the Diagram view
Editing a case using the Diagram view
Flowpaths
Nodes and flowpaths are drawn schematically. All objects shown in the component list can be dragged onto the Diagram view. The process equipment needs to be dropped on a flowpath to be added to the Diagram view. By default the position of the equipment will be where it is dropped on the flowpath . If the inline equipment is given a position (e.g. pipe and section) the position will be adjusted to reflect the real location along the flowpath.
Flowpaths can be created either by dragging the Flowpath component from the component list or by dragging from the middle of a node or from a separator’s inlet and outlets.
To disconnect a flowpath from a node, select the flowpath, left-click and hold one of the green ends while dragging it away from the node/separator.
Fixed points on a flowpath can be added by selecting the flowpath, click and hold the left mouse button and drag to where the fixed point should be added. A fixed point, indicated by a small square, will appear on the flowpath. Fixed points can be moved to shape the flowpath to improve the layout in the Diagram view. This does not change the actual geometry of the flowpath.
Fixed points can be removed from the flowpath by right-clicking on the point and selecting Delete segment.
Signal connections
Signal connections are also based on dragging from one object to the connecting object. To disconnect a signal from an object, select the signal line, left click and hold one of the green ends while dragging it away.
Fixed points on a signal line can be added by selecting the signal line, clicking and holding the left mouse button and drag to where the fixed point should be added. A fixed point, indicated by a small square, appears on the signal line. The fixed points can be moved to shape the signal line to improve the layout in the Diagram view.
Context menus for the Diagram view
Context menu in Diagram view
Icon Option Suboption Description
Arrange diagram horizontally
Rearrange the graphical layout with mainly horizontal flow lines.
Arrange diagram vertically
Rearrange the graphical layout with mainly vertical flow lines.
Fit to page (Ctrl+Q)
Zoom in or out to capture the whole graphical network in the visible part of the Diagram view.
Show grid Makes the grid on the Diagram view visible.
Snap to grid Snaps items to the grid when moving them; will work even when
the grid is not visible.
Network connections
Opens the network overview/connection window.
Submodel connections
Opens the Submodel Connections window.
Paste Pastes object that are copied.
Undo/Redo action
You can undo and redo the following actions:
Move and re-size objects - Add objects and keywords - Delete objects and keywords - Change keywords - Change units - Auto-arrange items - Paste actions - Connections - Text changes in Comment field
You can undo all actions until you start a new operation. E.g. Do 5 actions, undo 3 of these and then do a new action. The 2 remaining actions can now not be undone.
Filter layout Choose to show or hide visual objects.
Use filter (Ctrl+H)
Save user defined filters with this command or use this command to refresh settings.
User define filters
Create user defined filters.
Choose Add selected to filter (Ctrl+F7) to add all selected objects to the user defined layout filter.
Choose Add all of selected type to filter (Ctrl+F8)to add all objects that equals the selected objects type to the filter. Note that only on object can be selected to access this item.
Context menus for the Diagram view
Icon Option Suboption Description
Choose Clear filter to clear the user defined filter.
All objects are added to the same layout filer and the content of the user defined layout filter is case specific.
Show all Show/hide all filters simultaneously. Select: Signal lines to show/hide all signal lines.
Flow and Process to show/hide all flow components and
process equipment, apart from transmitters.
Instrumentation to show/hide all controllers, signal lines and
transmitters.
Heat transfer to show/hide all heat transfer conditions. Tuning and corrosion to show/hide all tuning and corrosion
objects.
Comments to show/hide all comments. Plots to show/hide all plots and values. Labels to show/hide all labels.
User defined to show/hide all objects added to a user defined
layout filter.
Copy as image Copies the Diagram view or plot to the clipboard depending on
what is in focus in the centre area. Select trend
variables
Add, edit or remove global output variables.
Select profile variables
Add, edit or remove global output variables.
Context menu on component in Diagram view Icon Option Sub-option Description
Copy Copies selected item. The label consists of the original label and a
suffix and is globally unique.
Paste Pastes the copied item onto the currently selected item.
Delete Deletes selected object.
Undo/Redo action
You can undo and redo the following actions:
Move and re-size objects - Add objects and keywords - Delete objects and keywords - Change keywords - Change units - Auto-arrange items - Paste actions - Connections - Text changed in Comment field
You can undo all actions until you start a new operation. E.g. Do 5 actions, undo 3 of these and then do a new action. The 2
remaining actions can now not be undone.
Icon Option Sub-option Description
Bring forward
Brings the selected object forward.
Bring to front
Brings the selected object to the front.
Send backward
Sends the selected object backward.
Send to back
Sends the selected object to the back.
Filter layout Choose to show or hide visual objects.
Use filter (Ctrl+H)
Save user defined filters with this command or use this command to refresh settings.
User define filters
Create user defined filters.
Choose Add selected to filter (Alt+S) to add all selected objects to the user defined layout filter.
Choose Add all of selected type to filter (Alt+A)to add all objects that equals the selected objects type to the filter. Note that only on object can be selected to access this item.
Choose Clear filter to clear the user defined filter.
All objects are added to the same layout filer and the content of the user defined layout filter is case specific.
Show all Show/hide all filters simultaneously. Select: Signal lines to show/hide all signal lines.
Flow and Process to show/hide all flow components and process
equipment, apart from transmitters.
Instrumentation to show/hide all controllers, signal lines and
transmitters.
Heat transfer to show/hide all heat transfer conditions. Tuning and corrosion to show/hide all tuning and corrosion
objects.
Comments to show/hide all comments. Plots to show/hide all plots and values. Labels to show/hide all labels.
User defined to show/hide all objects added to a user defined
layout filter. Select visible
signals... Opens a window for selection of which controller signals should be shown graphically.(only available for controllers)
Set colour This command is only available for flowpaths. You can use
different colours on flowpaths. This is useful if you want to visualise separate flowing streams. Select the colours you want to use and click the plus ( ) sign .You can also type in the RGB value instead of selecting a colour. Enter a unique name for the
Context menus for the Diagram view
Icon Option Sub-option Description
colour you selected.
Show legend
View the colours used on the flowpath canvas.
Note: The selected colours are saved in the case file and in the central settings file and can be used for other cases.
Select trend variables
Add, edit or remove output variables for the selected component and for profile variables for a flowpath which is a component in the Diagram view.
Select profile variables
Add, edit or remove output variables for the selected component and for profile variables for a flowpath which is a component in the Diagram view.
Right angled This command is only available for flowpaths. Select Right angles from the Tool bar to
change all flowpaths and signal lines from slanted lines to right angles.
set the default mode. Select Right angle to use this on all new flowpaths and signal lines.
Select Right angles from the Context menu to
change selected flowpaths and signal lines from slanted lines to right angles.
Straight line Use straight lines on flowpaths and signal lines.
Distribute Inline equipment evenly
This command is only available for flowpaths. Distributes the inline equipment equally on a flowpath. If you re-select this item, the equipment is moved back to its original position.
Local instances
Shows all local instances of the selected object in an editor table; e.g. all valves on one flowpath
Global instances
Shows all instances within the case of the selected object in an editor table.
Add to user’s library
Adds selected keyword(s) to the user’s library.
Import from user’s library
Imports from the available keywords/components from the user’s library.
Properties Starts the property editor for the selected object. For a flowpath
this would be the Flowpath geometry data view.
Open in editor Opens the Well editor if the flowpath is created via the Well editor. If the flowpath is created via the Diagram view, the Pipeline editor opens.
Network connection overview
Connection of flowlines and nodes can also be done through the Network Connection window. The
Network Connection window can be access through the Case toolbar or by right-clicking on the Diagram
view and selecting Network Connection. Select the "from-to" nodes for each Flowpath and click OK. The network should appear as specified.
Configuration of separator/phase split nodes
Configuration of separator/phase split nodes
The multi-phase coupling of a separator is performed in a similar manner as the coupling between a node and a flowpath. The coupling of a phase split node works again in a similar way as the separator.
First, add a node and a separator to the case from the component view.
Then connect the flowline from the node to the separator as follows: 1. Select the node and drag to the separator
2. Release on the separator’s inlet terminal
3. Click on the outlet terminals of the separator one at the time (gas, water and oil) and drag
Configuration of controller connections
All out-signals need to be transmitted through a transmitter in OLGA. This means that if for instance the liquid level from a separator is required as input to a controller, a transmitter needs to be added to the separator first. The only exception here is the controllers which also can operate as transmitters.
The variable required from the separator must be specified as a property (key) on the transmitter.
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 (see connection view)
Drag and drop coupling
The drag and drop coupling between two signal components is done in the same manner as between two multiphase network components:
1. Hover over the component which the output signal is taken from. Click one of the component's green circles (connection point(s)) and drag towards another component in the network. Green circles that appear when dragging over a component are available connection points for the other component.
Configuration of controller connections
2. Release on any of the second component’s connection points. Normally you would select the closest connection point to make the signal line as short as possible. A dialog appears with all available in and out signals. Select the signals you would like to connect and click Ok. A signal connection is made between the two components. In the figures shown the out signal (equal to the variable listed for the transmitter at its position) from a transmitter is connected to a PID controller's measured input signal.
By clicking on a signal line, you will see what signals are connected. By double clicking on a signal line, you will see the dialog for selecting terminals (signals). You can change the terminal using this dialog. You can also move the signal line from one connection point to another. This is only for tidying your case, the selected connection point does not decide what terminals are connected.
All valid output and input signals are by default displayed for all components. Several components have many input and output signals, which you can filter away, using the Edit visible signals option on the Context menu, see illustration below. In this window, you can configure which signal should be
accessible/visible in the Diagram view for each type of controller. The configuration will be saved with the case. Both the input signals and the output signals can be configured. By default, all signals are available. Select which signals to configure, in or out. Then, select the type of controller if the selected one is not the correct one. A selected check box indicate that the signal will be available when connecting in the
Diagram view. Note that all connected signals will be visible in the Diagram view independently of the
check marks.
Add connections to other controller tunable components
You can add connections to HEATTRANSFER, TUNING and CORROSION. This is how to edit the number of visible terminals you want to display in the Diagram view:
1. Right-click the relevant keyword. The Context menu is displayed. 2. Select Select visible signals.
3. Select the check boxes for the terminals you want to display in the Diagram view.
The terminals you select, apply to all HEATTRANSFER, TUNING or CORROSION nodes in your case and are stored when you save the case.
You can only have one CORROSION item per flowpath.
Illustration
This is an illustration of a user dragging a new connection from the manual controller to CORROSION. The connection points appear when the mouse is close to the component. The dialoig for selecting terminals is displayed when a connection point is selected.
Configuration of controller connections
Control the keys to HEATTRANSFER
You can use an OLGA controller for the following keys for the HEATTRANSFER keyword, unless set to Not used in the Model browser:
TAMBIENT, INTAMBIENT, OUTTAMBIENT, HMININNERWALL, INHAMBIENT, OUTHAMBIENT, HAMBIENT
See also
Shortcut keys
Given below is a list of some shortcut keys. For more information regarding shortcut keys, see Case
toolbar.
Shortcut Description
Mouse wheel Zoom in or out in Diagram view Ctrl+/Ctrl- Zoom in or out in Diagram view Ctrl+0 Return to un-zoomed view Ctrl+A Selects all items in Diagram view Delete Deletes selected objects
Shift+left drag Pans
Ctrl+left click/drag Multi- select items Click mouse wheel+drag Pans
Model Browser
Model Browser
The Model view, File view and Property editor windows appear when you double-click a component in the
Diagram view. The window is named Model Browser.
You can also open this window via the
View list in the upper right corner of the Diagram view. Select the File view or Model Browser.
Using the shortcut keys Ctrl+1, Ctrl+2, Ctrl+5, Ctrl +Enter or Ctrl+Space.
The Model Browser is used for navigating 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 and Network Components.
Note that the Model Browser lists all objects in the case whereas the Diagram view only shows the visual
objects. Non-visual objects (for instance case options) are not shown in the diagram view but are listed in
the Model Browser.
Case Definitions describe information common to the whole system being 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.
Thermal Components contains input to the FEMTherm and bundle models and input to annulus calculations.
When you select an object in the Model Browser, the object is made active and its properties may be edited in the Properties view.
The Model Browser contains input for all cases in the project. Switching between the different cases is done by clicking on the file name in Model Browser.
Right-click while pointing to an object in the Model Browser brings up various menus depending on the object:
Menu item Description
Add Add items to the network object.
Verify Checks input file and reports errors and missing input in the Output view. Copy Copies selected item.
Paste Pastes the copied item onto the currently selected item. Delete Deletes selected object.
Local instances Shows all local instances of the selected object in an editor table. E.g. all valves on one flowpath.
Global instances Shows all instances within the case of the selected object in an editor table. Add to user’s library Adds selected keywords to the user’s library.
Import from user’s library
Imports from the available keywords/components from the user’s library. Properties Starts the Property editor for the selected object. For a flowpath, this is the
Adding variables
Adding variables
This is how to add variables:1. Click in the VARIABLE field in the Properties window and then the - box. 2. Select variables from the window displayed. The variables may be sorted:
Alphabetically (by name or description)
Categorized (as seen below)
Those already selected (select the check box)
The units for plotting variables can be changed when actually plotting.
There is also an option to specify a label for the variable selection and save it. These variables can then easily be re-used at several positions.
By clicking OK in the relevant variable selection window, all selected variables will appear in the
Properties window:
By clicking OK, the window closes and focus is returned to the Properties window. Enter the pipe selection again and complete the specification by giving the sections.
Time series editor
Input keys with time series can be edited in a time series editor. The time series editor is accessed through the Property editor 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).
Time series editor
Custom windows
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 a heat transfer specification is also given.
Initial conditions
You can access the custom window for initial conditions through the property editor button on the INITIALCONDITION statement. Note that this custom window can only be accessed if only one initial conditions statement (keyword) exists.
This custom window can only be used when entering data section-wise. However, by selecting cells in a spread sheet 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.
To activate the custom window click the property button on top of the properties page, see below:
Heat transfer
You can access the custom window for heat transfer through the property editor button on the
HEATTRANSFER statement. Note that this custom window can only be accessed if only one heat transfer statement (keyword) exists.
This custom window can only be used when entering data section-wise. However, by selecting cells in the spread sheet 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.
Centrifugal pump
Centrifugal pump
Pump curves are required input for the centrifugal pump. To help the user with the input, the pump curves together with some key parameters can be specified in a custom window. This can be accessed in one of the following ways:
Double click on the centrifugal pump in the Diagram view
Select the centrifugal pump, right-click and select Properties from the Context menu
Select the centrifugal pump and press the property page button in the Properties editor The following window appears:
First, choose the centrifugal pump phase mode.
If phase mode = liquid (single phase), the option “One speed per curve” is given. This means that the only single phase curve will be used in the simulation. The multiplier for two-phase will be ignored. There are two scenarios for curve input:
Curve input Description
Single curve This scenario is straight forward. The best efficiency point is used as rated values for the centrifugal pump.
Multiple speeds and one speed per curve
This scenario is straight forward if the input data follow the pump laws. If the data deviate from the pump laws, the generated pump curves will become “bumpy”, and might be difficult to use in simulation. An option to generate multiple homologous curves, which will be interpolated in speed, will therefore be added
If phase mode = two (two phase), the input data will be one curve per GVF (gas volume fraction), the options to choose between are:
Calc multipliers - generates single phase curves from input with GVF=0.
Calc multipliers and degraded head - generates single phase curves from input with GVF=0. Generate degraded head curves from maximum GVF given in.
Interpolation in gas volume fraction - generates one “single phase” curve per GVF, and interpolate the curves using actual GVF
Secondly, decide to specify the rated values or chose the option to auto generate them. The auto generate option can be used if rated data is not available.
Next, click on Add in the Pump curve frame to enter the pump curve data. First, enter the gas volume fraction and density. Note that the gas volume fraction needs to be 0 if phase mode = liquid (single phase – no gas present).
Further, choose which type of input data the pump curves should be specified in (head/delta pressure, and efficiency/head/torque), and then enter the data. At least three data sets need to be entered. When this is done, more pump curves can be added. Note that only the pump curves with a check mark will be used for the selected centrifugal pump.
The centrifugal pump curve is a keyword named CENTPUMPCURVE, located on the library level. Several pump curves can exist. One pump curve can be used by several centrifugal pumps or not used at all.
The Update plots button in the Normalized pump curves frame to the right will be enabled when enough information is given. The conversion of centrifugal pump curves to homologous curves will be then be performed. These curves are only for information; this is the input that will be used for the OLGA simulation. Several plots are shown:
Single phase Head - two or more static curves
Single phase Torque - two or more static curves
Two Phase Head - two or more static curves
Two Phase Multipliers - two or more static curves
Head vs Volume flow - one static curve per centrifugal pump curve
Torque vs Volume flow - one static curve per centrifugal pump curve
Note that the pump curves data can contain large errors that may give the curves a strange form. I order to avoid bad data, plot the input curves and the generated homologous curves to adjust the input data.
Navigating in the pump curve grid
In the pump curve grid, use the tab button to move from left to right and use enter to move from top to bottom.
Centrifugal pump
File view
You open the File view by clicking the File view option in the View menu. The File view shows the files associated with the project. This will typically be the input file as well as PVT files and other files used in the case. However, any type of file can be added to the project (Word-files, Excel-files, etc.).
By right-clicking on a file, the file can be removed or the input file can be opened in a text editor. The text file may be edited and reloaded into the OLGA GUI by right-clicking the .opi file and selecting Reload from
text file. Note that the graphical layout will be recreated on reload from a text file as the text file does not
contain any information about the layout. This information is stored in the .opi file.
Components view
The Components view contains a library of objects that can be used to build the case. Simulation objects may be dragged from the Components window and dropped onto the Diagram view. You can hide the Components view with the cross located in the upper right corner of the window. You can hide the labels to make room for more components. This way you do not have to scroll to find the component you are looking for. Alternatively you can use the search box to filter the content of the Components view. Start typing the name of the component you are looking for and the Components view only shows components that matches your search criteria
Centrifugal pump
The view is divided into several groups:
Group Description
Nodes and node type equipment
covering boundary nodes and node type equipment like separator, phase split node, etc.
Flowpaths covering flowpaths of different shapes
Valves covering all types of valves supported by OLGA Compressors and pumps covering pigs, tuning and corrosion
Other equipment covering loss, pig and heat exchanger
Boundary conditions covering inflow and outflow components like different types of sources and leaks
Transmitter and controllers covering all types of controllers in addition to the transmitter Results and Comments covering interactive plots, values and comments
Case overview
The Case overview window is used for helping with orientation in the Diagram view for larger network cases. The white frame shows what is visible in the Diagram view; the size of the frame is dependent on the zoom level. The visible area can be moved by clicking and dragging (left mouse button) the white area.
You can zoom in and out of the Diagram via the Overview view: Draw a rectangle in the Overview to zoom to that area in the Diagram view. Also panning the same rectangle in the overview will pan the
Diagram view.
If the case overview window is not visible it can be opened from the View menu, in the upper right corner, or to the right of the zoom buttons in the lower right corner.
Flowpath geometry data view
Flowpath geometry data view
Use the Flowpath geometry data view to visualize, inspect and edit a flowpath.
To open the Flowpath geometry data view, double-click a flowpath in the Diagram view or select
Properties. You can also open this view via the Property page button in the Model Browser. The Flowpath geometry data is always updated with the data from the flowpath in OLGA.
Reverse geometry
Click this button to reverse the geometry. Note that the reverse functionality varies depending on how the geometry is given:
Length/Elevation
The Reverse geometry button reverses the pipes and flips the elevation. In the example below, you can see in the table that the sequence of the pipes is changed. You can reset the pipe labels. The elevation for each pipe is changed from positive to negative and vice versa.
XYZ
The Reverse geometry reverses the pipes and adjusts the XYZ coordinates. The start points become the end point. In an XY plot, this can be illustrated as follows:
The plot in the Flowpath geometry data view is a horizontal distance and elevation plot which always starts with zero. The XYZ geometry illustrated above is displays as follows in the Flowpath geometry
data view:
Flowpath geometry data view
Mixed geometry
If the geometry is specified with a mix of Length/Elevation and XYZ, then the reverse functionality first calculates the complete XYZ geometry. The length direction is x. Then the XYZ geometry is reversed. A Length/Elevation geometry with the geometry keys XStart, YStart and ZStart different from zero is treated as a mixed geometry.
Section lengths
If the section lengths are specified in a list, the list is reversed.
Reset pipe labels
Click this button to change all the labels of the pipes. The pipes will be labelled Pipe-1, Pipe-2, …, Pipe-n. This is useful if you have used the reverse geometry function.
Discretize geometry
Click this button to automatically fill in the section lengths of all pipes. Note that any existing sections will be overwritten. The discretization algorithm takes two parameters as input: Minimum number of sections
per pipe and Maximum section length. The algorithm gives all pipes the same selected number of sections.
The algorithm also tries to make sure that two adjacent sections does not have a length ratio higher than 1:2 (i.e: one section will be less than double the length of any adjacent sections).
Open in editor
Click the Open in editor button to open the Well editor if the flowpath is created via this editor. If the flowpath is created via the Diagram view, the Pipeline editor opens.
Import .geo file
Click this button to import data from a .geo file.
Plot tool bar
A tool bar is available on the right side of the Flowpath geometry data view plot. The following options are available:
Zoom - You can zoom in the plot by highlighting parts of the flowpath. To return to the initial view, click this
button.
Toggle pipe boundaries - Click this button to show/hide pipes in the Flowpath plot. Toggle section boundaries - Click this button to show/hide sections in the Flowpath plot.
Toggle section length ratios - Click this button to show/hide the section length ratio in the Flowpath plot.
The length ratios of each pipe section to its previous section is displayed. The recommended ratio range between 0.5 and 2 is highlighted in the plot.
Output view
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 is divided into three categories: Errors,
Warnings and Info.
Error messages (and task list)
The simulation can be performed. This symbol is displayed: Errors can be caused by:
Errors in input
Errors from initialization phase
Errors during simulation
List of incomplete keywords.
Click on the symbol to go to the incomplete keyword
Warnings
The simulation may still be performed This symbol is displayed: Information ( ) is given regarding:
Simulator state changes
Progress during simulation
Any messages during simulation (info previously directed to the DOS window) The windows can be cleared from the Context menu (right-click).
Copy text
To copy text, mark the text and then right click and select Copy.
Active Output categories, located in the top left of the Output view, are indicated by an orange background colour.. A left mouse click on the text will activate or deactivate the category.
By default the output from the active case is shown. Output from other cases can be selected from the drop-down menu at the top of the Output view.
Connections view
The connections view gives information about the signal connections between transmitters, controllers, process equipment and boundary conditions.
There are two modes: Display case and Display current object.
Display case will show all signal connections for the entire case. Display current object will only show the
signal connections for the selected object on the Diagram view.
The sample below shows that a PID controller’s output signal (CONTR) is connected to VALVE-1’s input signal (VALVESIG). The VALVESIG for a valve is the same as the valve opening. The transmitter’s (TM-1) output signal (which depends on the variable specified for the transmitter e.g. pressure) is connected to the PID controller’s measured input signal (MEASRD).
You can view the direction of the signal connection on the Display current object tab to get a quick overview of all signals and their impact on the model parts. Inbound signal connections are coloured orange while outbound signal connections are coloured blue.
See also
Simulation
Simulation
There are some alternative ways to run a simulation, Run interactive and Run batch case by case or the entire project.
Run interactive
Run interactive makes it possible to open and view output results while running. An interactive simulation may be paused and continued. If you use the Step functionality in interactive simulations, note that the OLGA time steps override the Step functionality settings.
Run in batch
Click Run Batch to start the simulation in the background. This will open a command prompt showing output and progress. A batch simulation is running in a separate process than the GUI which means that it is possible to close down the GUI without disrupting the simulation. All open cases are saved when you click this button.
Run Project and Run Project Batch
If the project contains more than one case there are two alternative options, Run Project and Run Project
Batch. These options are available in the project menu located in the upper right corner, and will run all
cases in the current project in sequence. The sequence can be specified by setting the project dependencies.
Project Dependencies… can be access either from the Project menu or
Reports
Reports
A case report is generated and viewed in the default web browser from Report on the case toolbar. The menu system in the report uses JavaScript which may trigger a security warning from the web browser. Allow the blocked content to activate the menus in the report.
Use the buttons on the top to jump to specific sections in the report or select Printer Friendly version to remove the menu system.
Plots
There are several types of plots that can be activated in OLGA. These are described below. Trend plots Profile plots Fluid plots 3D plots Interactive plots OLGA viewer
Common behaviour in trend, profile and fluid plots
Common behaviour in trend, profile and fluid plots
Adding notes on the plot
Add a descriptive note to the plot by selecting Edit - Add Note from the Context menu. The window allows text to be entered and attached to the case to one of the series in the graph.
Change or delete the note by right-clicking it and select Edit - Edit Note from the Context menu. The notes can be toggle on and off by the notes button on the toolbar.
Use of the plotting Context menu
The plotting tool is a sophisticated program and provides access to several functions for modifying graphs. Most functionality is accessed through the Context menu (right-click on the plot to bring up the Context menu)
File menu
Save As Image
