Instruction

Manual OmegaLand
Getting Started Guide

V3-ML-1001E

V3-ML-1001E
9th Edition
◆Introduction

 Manuals for this product

The following manuals exist for OmegaLand V3, but the actual provided manuals will
vary for each product.
 OmegaLand Software License Agreement
 OmegaLand 3 rd Party Software License Agreement

<User’s Guide/User’s Manual>

 OmegaLand Getting Started Guide
 OmegaLand User’s Guide
 EQUATRAN User’s Guide
 Visual Modeler Unit Model Creation Manual
 OmegaLand Instructor Function User’s Guide
 OmegaLand GRAPHIC Builder User's Manual
 OmegaLand GRAPHIC Runtime User's Manual

<Tutorial>
 VM-EQUATRAN Tutorial
 OmegaLand Tutorial
 Visual Modeler Tutorial
 Visual Modeler Steady-state Calculation Tutorial

<Reference>
 OmegaLand Unified Main UI Reference (*1)
 OmegaLand Main UI Reference (*1)
 Visual Modeler Reference (*1)
 Visual Modeler Unit Icon Editor Reference
 Visual Modeler Standard Unit Model (1) Reference
 Visual Modeler Standard Unit Model (2) Reference
 Visual Modeler IBD Unit Model Reference
 OmegaLand Physical Property Function Reference
 OmegaLand Monitor Function Reference
 OmegaLand Script Function Reference
 OmegaLand Database Function Reference
 OmegaLand Instructor Function Reference
 OmegaLand Connection Function Reference
 OmegaLand OPC Server Function Reference

(*1) “OmegaLand Unified Main UI Reference”, is a manual that explains the 64-bit
system product, and it is a combination of “OmegaLand Main UI Reference” and
“Visual Modeler Reference” of the 32-bit system.
One of the references can be referred to according to the type of the installed
product (64-bit / 32-bit).
 Targeted Readers
The use of this product requires knowledge of the following products:
 The Windows operating system
 The ANSI C-language
 Visual C++
◆Items requiring special attention

 Cautions to be observed:
 This document will be generally provided by the electronic file (PDF format.)
 Only operate the product after reading this document and having attained thorough
knowledge of its content.
 This document describes details of the functions contained in the product, and does
not guarantee that it is suitable for customers’ specific purposes.
 It is prohibited to reproduce or copy part or all of this document in another
document without the prior consent of Omega Simulation Co., Ltd.
 Contents of this document may be modified without any prior notification.
 If you notice any questionable items, errors, omitted descriptions, etc., please
inform the sales division of Omega Simulation Co., Ltd. or the agent who you
bought the product from.

 Exemption from responsibility for this product

 Omega Simulation Co., Ltd. does not provide any warranty on this product except
those specified in the warranty clauses.
 Omega Simulation Co., Ltd. is not responsible for damage that users or any third
party may suffer from the use of this product, or damage, either direct or indirect
that users or any third party may suffer due to any defect or other factor that Omega
Simulation Co., Ltd. cannot predict in advance.

 Software products
 Omega does not provide any warranty on the software except those specified in the
warranty clauses.
 Run the software on computers listed in the license agreement. Purchase other
software if the product is run on a computer not listed in the contract.
 Copying the software for any purpose other than for providing backup is prohibited.
 Keep the media containing the software secure. Without the media, Omega may
refuse to provide the Omega-predetermined quality guarantee and maintenance
services.
 Conducting reverse engineering such as decompiling and disassembling is
prohibited.
 Letting any third party use the software by transferring, exchanging or lending it
without Omega’s prior written approval is prohibited.
 Trademarks
 OmegaLand, Visual Modeler, and EQUATRAN are trademarks of Omega
Simulation Co., Ltd.
 CENTUM and Exaopc are registered trademarks of Yokogawa Electric Corp.
 Microsoft, Windows, and Visual C++ are registered trademarks of Microsoft
Corporation.
 Other company and product names described in this document are trademarks or
registered trademarks of each respective company.

 Copyright
Copyright (C) 2000-2023 Omega Simulation Co., Ltd.
Copyright (C) 2005-2023 Yokogawa Electric Corporation
 Toc-1
Instruction Manual

OmegaLand
Getting Started Guide V3-ML-1001E 9th Edition

CONTENTS
1. What is OmegaLand? ...................................................................................1-1

1.1. Simulation Project ....................................................................................1-2

1.2. Application Functions ...............................................................................1-2

1.3. Main UI ....................................................................................................1-3

1.4. VMSpace.................................................................................................1-3

2. Installation ....................................................................................................2-1

2.1. Package Content......................................................................................2-2

2.2. Required Hardware/Software....................................................................2-6

2.2.1. Hardware Environment............................................................... 2-6
2.2.2. Software Environment ................................................................ 2-7
2.2.3. Virtualization System Environment.............................................. 2-7
2.2.4. Example of System Configuration............................................... 2-8

2.3. Setup of the Hardware and OS.................................................................2-9

2.3.1. Creation of an OmegaLand User Account ................................... 2-9
2.3.2. Checking the Free Hard Disk Space and Memory Size ............. 2-10
2.3.3. Disabling Standby and Hibernate.............................................. 2-10

2.4. Installation of Related Software ..............................................................2-12

2.4.1. Installation of Microsoft Visual C++ ........................................... 2-12
2.4.2. Installation of Microsoft Excel ................................................... 2-13
2.4.3. Installation of Adobe Acrobat Reader ........................................ 2-14

2.5. Installation of OmegaLand......................................................................2-15

2.5.1. Workflow of Installation............................................................. 2-15
2.5.2. Starting the Installation Program............................................... 2-16
2.5.3. Installing the Prerequisite Software........................................... 2-17
2.5.4. Installation of the OmegaLand software .................................... 2-20
2.5.5. Processes in “Installation and OmegaLand Environment Settings”2-26
V3-ML-1001E 9th Edition : Jul. 2023
Toc-2
2.5.6. Installing the Service Packages and Patches ............................ 2-26
2.5.7. Installing the License Key......................................................... 2-26

2.6. Tasks to Be Performed after Installing OmegaLand.................................2-27

2.6.1. Steps to Connect to the External System.................................. 2-27
2.6.2. Steps to Activate the Network License ...................................... 2-27

2.7. Testing of Installed OmegaLand..............................................................2-29

2.7.1. If VM-EQUATRAN was Installed ............................................... 2-29
2.7.2. If Visual Modeler was Installed.................................................. 2-31
2.7.3. If OmegaLand Was Installed..................................................... 2-34
2.7.4. Now, Let’s Start the Operation! ................................................. 2-38

3. Functions of OmegaLand .............................................................................3-1

3.1. Functional Structure of OmegaLand .........................................................3-2

3.2. Main UI ....................................................................................................3-3

3.3. Model Function (Visual Modeler) ..............................................................3-4

3.4. Unified Main UI ........................................................................................3-6

3.5. Monitor Function ......................................................................................3-7

3.5.1. Trend ......................................................................................... 3-7
3.5.2. Stream Table.............................................................................. 3-8
3.5.3. Monitor Panel............................................................................. 3-8

3.6. Script Function.........................................................................................3-9

3.7. Graphic Function....................................................................................3-10

3.8. Instructor Function .................................................................................3-13

3.9. Database Function .................................................................................3-14

3.10. Connection Function ..............................................................................3-15

3.11. OPC Server Function .............................................................................3-16

4. Operator Training Simulator.........................................................................4-1

4.1. Functions Required for the Operator Training System ...............................4-2

4.2. Realization Configuration .........................................................................4-3

4.2.1. Actual DCS Connection Type ..................................................... 4-3
4.2.2. DCS Emulation Type .................................................................. 4-4

4.3. Distributed Environment ...........................................................................4-5

V3-ML-1001E 9th Edition : Jul. 2023

 Toc-3
4.3.1. Shared Distributed Setup Procedure........................................... 4-5
4.3.2. Non-Shared Distribution Setup Procedure .................................. 4-9

5. Tools and Utilities Outline ............................................................................5-1

5.1. Project Converter .....................................................................................5-1

5.1.1. Conversion Workflow ................................................................. 5-1
5.1.2. Start........................................................................................... 5-3
5.1.3. Project Conversion Procedure .................................................... 5-4
5.1.4. Conversion Log Display.............................................................. 5-6
5.1.5. Items Requiring Special Attention ............................................... 5-6

5.2. OmegaLand Utility....................................................................................5-7

5.2.1. Start........................................................................................... 5-7
5.2.2. Basic Setting.............................................................................. 5-9
5.2.3. Advanced Setting..................................................................... 5-10
5.2.4. License Change ....................................................................... 5-11
5.2.5. Maintenance ............................................................................ 5-12
5.2.6. Version Information .................................................................. 5-19

5.3. Manual Reference Tool...........................................................................5-20

5.4. Other Tools ............................................................................................5-22

6. Help and Support..........................................................................................6-1

6.1. OmegaLand Help.....................................................................................6-1

6.2. Log Information........................................................................................6-2

6.3. Troubleshooting .......................................................................................6-3

6.4. Anti-virus Software ...................................................................................6-4

6.5. Support for Users.....................................................................................6-5

V3-ML-1001E 9th Edition : Jul. 2023

Toc-4

V3-ML-1001E 9th Edition : Jul. 2023

 1. What is OmegaLand? 1-1

1. What is OmegaLand?

OmegaLand is a product that provides an Integrated Environment for Dynamic

Simulation.
OmegaLand consists of the following: the Visual Modeler plant simulator that offers an
excellent real-time performance and allows large-scale, high-precision virtual plants to
be built, peripheral functions that supplement the Visual Modeler and enhance its
usability, optional functions that can be added and used according to purpose, and the
main UI for processing all of these functions comprehensively.

The operator training simulator (OTS) is the most popular application of OmegaLand.
With the Visual Modeler function at its core, it offers a rich variety of functions that are
required for an OTS, including the graphic function that provides the operation window
and the instructor function that integrates all instructor operations into a single panel. In
addition to the operator training, it comprehensively covers each phase of the plant life
cycle including process analysis and design, assessment of control systems, and
operation assistance, making it suitable for a wide range of applications.

V3-ML-1001E 9th Edition : Jul. 2023

1-2

1.1. Simulation Project

The definition information and execution data comprising a simulator that is

executed/managed in OmegaLand is referred to as a “simulation project.”
The processes created using the application functions described below can be combined
to suit the user’s purpose, started in sequence, and then operated as a single simulation
system.

1.2. Application Functions

The OmegaLand product incorporates a range of “application functions” that provide all
the functions required for the simulator.
A typical application is the model function (Visual Modeler), which is one of the core
features of OmegaLand; and peripheral functions for using the plant model built with
the model function in a wide range of applications are available by default.

Table 1.2-1 Standard application functions of OmegaLand

Model function It is a dynamic simulator representing the core technology of OmegaLand. It
(Visual Modeler) employs a complete modular approach so that dynamic models of a
large-scale complex plant can be developed in a steady and efficient manner.
Monitor function It displays a trend/stream table/monitor panel that visually supports the
variables in each OmegaLand application, including the model function.
Script function It provides the function for automating the execution of the simulation. The
same operations can be repeated accurately, which is useful when verifying
the performed operations. It can be integrated into the operator training
system to execute a training scenario automatically, including occurrence of
malfunctions.
Graphic function It provides a GUI (graphic user interface) to enhance usability for the end
users. A seamless relationship with the graphics on DCS can be achieved as it
uses the same components as the graphic environment of the CENTUM VP
manufactured by Yokogawa Electric Corporation.
Database function It provides the tag database function that is available in real-time. It can
accumulate the history data of process models and process the data using the
calculation function, as well as register/edit tags in a spreadsheet-like format.
External connection It provides the function for connecting to external systems such as DCS. This
function enables a realistic operator training simulator using an actual machine. This
function can also be used for verifying the control logic of an external system
for the actual operation.
Instructor function It provides a graphical user interface for controlling the instructor's
operations and monitoring tasks in the operator training system.

When building a simulation project, a simulation for each different purpose can be
achieved by combining and executing the definition information using these applications
as necessary.
Refer to the corresponding sections of “Chapter 3 Functions of OmegaLand” for the
overview of each application function.

V3-ML-1001E 9th Edition : Jul. 2023

 1. What is OmegaLand? 1-3

1.3. Main UI
Main UI is a user interface function that is used to start the above-described application
functions as required, centrally manage the applications that have been created, and
execute the applications as a single simulation project.
A comprehensive management per simulation is possible using Main UI to achieve a
wide range of simulations while maintaining the independence of each application
function.
Refer to “3.2 Main UI” for the functional overview of Main UI.

Information

From OmegaLand V3.3, the new Main UI provided as a 64-bit product, has been
integrated with Visual Modeler (Model Function). By displaying the PFD (Process Flow
Diagram) of the model in the window frame, it is possible to perform editing operations
and simulator operations with one frame.

1.4. VMSpace
All OmegaLand simulation projects operate in a single virtual space called VMSpace.
OmegaLand is a program that runs on the Microsoft Windows OS. However, VMSpace
can treat an Ethernet-connected, multi-PC environment as a single space, allowing the
user to perform operations without being aware of which PC they are working on.

V3-ML-1001E 9th Edition : Jul. 2023

1-4

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-1

2. Installation
OmegaLand is a software program package that runs on the Microsoft Windows OS.
To be able to use OmegaLand without any issues, it is necessary to configure the PC
environment and install the related software prior to installing this package.
The following shows the overall installation workflow:

(1) Setup of the hardware and OS

Carry out the basic PC setup to prepare the environment to run various types of software,
including OmegaLand.

(2) Installation of the related software

Install the software that are necessary for running OmegaLand and model development.

(3) Installation of OmegaLand

Install OmegaLand and attach the hardware key.

(4) Tasks to be performed after installation

Configure the settings required for using the external connection server or license server.
This task is not necessary for independent operation using the master PC.

(5) Operation check

Use the installed samples to verify that OmegaLand operates normally.

V3-ML-1001E 9th Edition : Jul. 2023

2-2

2.1. Package Content

 Setup disc
Check that the setup disc (DVD-ROM) is included in the package.

 License key
This USB key is required in order to use OmegaLand.
The license key is normally attached to the USB port of the master PC. However, a
network license, which allows multiple main PCs to be configured in a network in
which a license server has been set up, is also available.

 License information sheet

This sheet contains the license information corresponding to the purchased product
license based on the serial number of the license key. It is required when entering the
license code during installation.

 Manuals
The OmegaLand manuals, the types of which are separated into User’s guide, Tutorial,
and Reference, are available in electronic version with the PDF format that is installed
with the product software.
The manuals are categorized into standard manuals that are supplied with the product
package and option manuals that are provided with the purchase of optional functions.

The manuals supplied with each product package are as listed below.

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-3

- Visual Modeler package

* 10 volumes in total
(1) V3-ML-1001E: OmegaLand Getting Started Guide
(2) V3-ML-1014E: Visual Modeler Unit Model Creation Manual
(3) V3-ML-2003E: Visual Modeler Tutorial
(4) V3-ML-3011E: Visual Modeler Reference
(5) V3-ML-3012E: Visual Modeler Unit Icon Editor Reference
(6) V3-ML-3014E: Visual Modeler Standard Unit Model Reference (1)
(7) V3-ML-3015E: Visual Modeler Standard Unit Model Reference (2)
(8) V3-ML-3021E: OmegaLand Physical Property Function Reference
(9) V3-ML-3022E: OmegaLand Monitor Function Reference
(10) V3-ML-3023E: OmegaLand Script Function Reference

V3-ML-1001E 9th Edition : Jul. 2023

2-4

- OmegaLand Basic package

* 19 volumes in total
(1) V3-ML-1001E: OmegaLand Getting Started Guide
(2) V3-ML-1011E: OmegaLand User’s Guide
(3) V3-ML-1014E: Visual Modeler Unit Model Creation Manual
(4) V3-ML-1021E: OmegaLand Instructor Function User’s Guide
(5) V3-ML-1022E: OmegaLand GRAPHIC Builder User’s Manual
(6) V3-ML-1023E: OmegaLand GRAPHIC Runtime User’s Manual
(7) V3-ML-2002E: OmegaLand Tutorial
(8) V3-ML-2003E: Visual Modeler Tutorial
(9) V3-ML-3001E: OmegaLand Main UI Reference (*1)
(10) V3-ML-3001E: OmegaLand Unified Main UI Reference (*1)
(11) V3-ML-3011E: Visual Modeler Reference (*1)
(12) V3-ML-3012E: Visual Modeler Unit Icon Editor Reference
(13) V3-ML-3014E: Visual Modeler Standard Unit Model Reference (1)
(14) V3-ML-3015E: Visual Modeler Standard Unit Model Reference (2)
(15) V3-ML-3021E: OmegaLand Physical Property Function Reference
(16) V3-ML-3022E: OmegaLand Monitor Function Reference
(17) V3-ML-3023E: OmegaLand Script Function Reference
(18) V3-ML-3024E: OmegaLand Database Function Reference
(19) V3-ML-3025E: OmegaLand Instructor Function Reference

(*1) “(10) OmegaLand Unified Main UI Reference”, is a manual that explains the 64-bit
system product, and it is a combination of “(9) OmegaLand Main UI Reference”
and “(11) Visual Modeler Reference” of the 32-bit system.
One of the references can be referred to according to the type of the installed
product (64-bit / 32-bit).

The following manuals are provided with the purchase of each of the optional functions:

V3-ML-2004E: Visual Modeler Steady-state Calculation Tutorial

V3-ML-3016E: Visual Modeler IBD Unit Model Reference
V3-ML-3026E: OmegaLand Self-training Function Reference
V3-ML-3027E: OmegaLand Connection Function Reference
V3-ML-3028E: OmegaLand OPC Server Function Reference

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-5

 Document reference software

The electronic manuals of OmegaLand are provided in PDF format and require the
“Adobe Acrobat Reader” software for viewing. “Adobe Acrobat Reader DC” is
available for free download on the Adobe website:

http://get.adobe.com/reader/

If you have difficulty downloading “Adobe Acrobat Reader” due to your network
environment, please contact the “Support contact point” in “6.5 Support for Users.”

V3-ML-1001E 9th Edition : Jul. 2023

2-6

2.2. Required Hardware/Software

This section describes the hardware and software that are required for OmegaLand.
Please make sure that the system that you are using complies with these requirements.

2.2.1. Hardware Environment

OmegaLand can be executed on a single or multiple PCs running the Windows

operation system (OS).

Table 2.2-1 Hardware Environment

RAM 4GB or more
Monitor Resolution 1280 x 1024 or higher
Hard disk More than 2GB of free space
DVD-ROM drive Required for installation
Keyboard, mouse, Must be usable on the selected OS:
printer
Graphics card DirectX 9-capable GPU with support for:
- WDDM (Windows Driver Display Model) driver
- Pixel shader 2.0
- 32 bit/pixel
- 128MB graphics memory
* Required for PCs running the GRAPHIC Runtime.
Sound output Sound board and speaker
equipment * Required for the use of sound functions in the GRAPHIC
Runtime.
Network environment LAN board, Ethernet
* Required for operation using multiple PCs.

Note

A customized size is recommended for setting the virtual memory.

The size of the virtual memory should be set to a value 1.5 times the main memory
capacity.
For example, set the custom size to 9216 MB if the main memory capacity is 6 GB, or
12288 MB if 8 GB.

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-7

2.2.2. Software Environment

Table 2.2-2 Software Environment
OS Microsoft Windows 11 Pro
Microsoft Windows 10 Pro (64bit)
Microsoft Windows 10 Enterprise 2019 LTSC (64bit)
Microsoft Windows 10 Enterprise 2016 LTSB (64bit)
Microsoft Windows Server 2019 Standard
Microsoft Windows Server 2016 Standard
Microsoft VC++ Visual Studio Professional 2022 Visual C++
Visual Studio Professional 2019 Visual C++
Visual Studio Professional 2017 Visual C++
Visual Studio Professional 2015 Visual C++
Microsoft Excel Excel 2021 / Excel 2019 / Excel 2016
* Required for the use of the instructor function or
GRAPHIC Builder.
Adobe Acrobat Reader DC * Required as the product manual viewer.

Note

It is advisable to connect the USB hardware key directly to the USB port of the PC as it
offers more stable power supply. Also, make sure to connect the hardware key after
installing OmegaLand.

2.2.3. Virtualization System Environment

OmegaLand also supports virtualization system using with Microsoft “Hyper-V”.
The OS environment for building a virtualization system is shown in the table below.

Table 2.2-3 Virtualization System Environment

Guest OS
Host OS Windows Server 2019 Windows Server 2016
Standard Standard
Windows Server 2019
✓ －
Datacenter
Windows Server 2016
－ ✓
Datacenter

Information

A virtual system has many more factors than a real PC system that need to be carefully
evaluated for normal operation, such as model scale, computational complexity, and the
structure of netowrk. When building a virtualization system, contact the “Support
contact point” in section “6.5. Support for Users”.

V3-ML-1001E 9th Edition : Jul. 2023

2-8

2.2.4. Example of System Configuration

Printer
プリンタ
マスターPC
Master PC Sub PCサブPC

HU
モデル計算
Model calculation 分散モデル
Distributed mode

B
License management
ライセンス管理
Ethernet

SubサブPC
PC サブPC
Sub PC Sub PC サブPC
現場操作画面
Field operation 制御系操作画面
Control system インストラクター画面
Instructor window
window operation window

Figure 2.2-1 System Configuration Sample

- Master PC
The license management service is run on the PC to which the license key has been
attached. All licensed functions will become operational.
- Sub PC
A master PC that will serve as the query destination where the licensing information
is registered; and whether each software of OmegaLand can be started on the sub PC
or not will be checked via the applicable master PC. The operation of the OmegaLand
software on the sub PC will be equivalent to that on the master PC.

 When using a network license

When using a network license, it is necessary to define a network license server PC. Of
all the PCs in the same network, the licensed number of PCs will be started as master
PCs.
- License server
Connect the hardware key for the network license to the license server. Also, it is
necessary to install the driver of the hardware key on the license server. Follow the
procedure described in “2.6.2 Steps to Activate the Network License” in this
document.

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-9

2.3. Setup of the Hardware and OS

2.3.1. Creation of an OmegaLand User Account

Create a user account for OmegaLand on the master PC and all sub PCs (hereafter called
“All PCs”) using the same user name and password for all PCs.
Grant administrator rights to the OmegaLand user account and carry out the required
tasks for installation. These tasks include installing OmegaLand and various software, as
well as configuring the security settings. Note that the installation cannot be performed
properly without administrator rights.

Note

Administrator rights are required for the OmegaLand user only during the installation
process. Administrator rights are not required for operations after the installation and
can therefore be removed from the OmegaLand user.

Note

User account creation is extremely important for the PC management. Make sure to
contact the PC administrator or the department responsible for PC administration and
follow their instructions.

Note

Make sure to assign a password to the OmegaLand user account.

Note

In the case of a standard installation of OmegaLand, the creation of user groups and
security settings for each type of group will be performed automatically. Refer to “5.7
User Security Settings” in the OmegaLand User's Guide for details.

Note

If the domains are being managed by the server, logging on as the same domain user on
all PCs will fulfill the conditions required for the OmegaLand user account. In such case,
it is not necessary to create a new user on each machine. Contact the PC administrator or
the department responsible for PC administration and take the necessary steps to make it
possible to log on as the same domain user from all PCs.
Note that a domain user is completely different from a local user created on each PC. It
is not possible to configure a master PC or sub PC with mixture of domain users and
local users.

V3-ML-1001E 9th Edition : Jul. 2023

2-10

2.3.2. Checking the Free Hard Disk Space and Memory Size
For the installation, approximately 1GB of free space is required in the hard disk.
Moreover, when actually using OmegaLand, an additional working area will be needed
on the hard disk.
2GB or more memory is required to start OmegaLand.

2.3.3. Disabling Standby and Hibernate

OmegaLand does not support the standby and hibernate function of the Windows OS. If
a standby or hibernate occurs while OmegaLand is running, an error may occur when
the operation is resumed, preventing the continued use of OmegaLand. To avoid such a
situation, make sure to disable the standby and hibernate functions.
The following procedure applies for the setting window in Windows 7. Menus or items
may differ for other Windows OS.

(1) In the Control Panel, select [Power Options].

Figure 2.3-1 Power Options

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-11
(2) Select [Change when the computer sleeps] from the left side menu. The [Edit Plan
Settings] window will appear.

Figure 2.3-2 Edit Plan Settings

(3) Select the [Change advanced power settings] menu to open the [Power Options]
window.

Figure 2.3-3 Advances Power Settings

(4) Select [Never] for both [Sleep]-[Sleep after] and [Sleep]-[Hibernate after] options,
and click on [Apply].

V3-ML-1001E 9th Edition : Jul. 2023

2-12

2.4. Installation of Related Software

2.4.1. Installation of Microsoft Visual C++

Visual C++ 2022, Visual C++ 2019, Visual C++ 2017, or Visual C++ 2015 needs to be
installed in order to use Visual Modeler. The following product should be used:
- Visual Studio 2022 Professional
- Visual Studio 2019 Professional
- Visual Studio 2017 Professional
- Visual Studio 2015 Professional

Note

When installing the Visual Studio on a machine that is not connected to the Internet,
some components may not be installed, as digital signature verification cannot be
performed. Since the workaround is different depending on the version
(2022/2019/2017/2015), check the Microsoft information beforehand when installing on
a PC with no Internet connection.

Note

When installing Visual C++ 2015 Professional, select Custom installation and add
Visual C++ installation.

Figure 2.4-1 Custom Installation of VC++ 2015

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-13
Note

Even when installing Visual C++ 2022 Professional, Visual C++ 2019 Professional, or
Visual C++ 2017 Professional, it is necessary to select the option item. Since the
following option selection screen will be displayed, select the "Desktop development
with C++" option and start the installation.
At this time, the number of detailed installation options (the options displayed on the
right side of the window) associated with the "Desktop development with C++"
selection may vary according on the release date of Visual Studio 2022/2019/2017, but
there is no problem with leaving the default specifications selected as they are.

Figure 2.4-2 Option Selecting of VC++ 2022

2.4.2. Installation of Microsoft Excel

Microsoft Excel must be installed in order to use the GRAPHIC Builder or the instructor
function. Excel 2021, Excel 2019, and Excel 2016 are supported.
Both editions 64-bit/32-bit of Microsoft Excel are available.

V3-ML-1001E 9th Edition : Jul. 2023

2-14

2.4.3. Installation of Adobe Acrobat Reader

The electronic manuals of OmegaLand are in PDF format and require the “Adobe
Acrobat Reader” software for viewing. “Adobe Acrobat Reader DC” is available for free
download on the Adobe website:
http://get.adobe.com/reader/

Information

If you have difficulty downloading “Adobe Acrobat Reader” due to the network
environment, please contact our “Support contact point” in “6.5 Support for Users.”

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-15

2.5. Installation of OmegaLand

2.5.1. Workflow of Installation

The following introduces the installation workflow for the OmegaLand software.

(1) Uninstall the old version of OmegaLand

This step is only necessary when an old version of OmegaLand is installed.

Information

The OmegaLand V3.* (version 3.1 or later) software package can co-exist with V2.*
(version 2.*) for the operation comparison of simulation models. V3.1 can be installed
without uninstalling the V2.* software from the PC. However, it is not possible to run
both versions simultaneously.

Note

Different versions of software V3.* cannot coexist on the same PC. Install the new
version after uninstalling any preexisting older version.

(2) Assign OmegaLand User Group

To install the OmegaLand software, assign the OmegaLand user group
(OML_MAINTENANCE) with installation processing authority to the currently logged user
account.

(3) Install the software required to run OmegaLand

The installer automatically checks the PC environment and installs the following
software as necessary.
- Microsoft .NET Framework 4.7.2
- Microsoft Visual C++ 2013 Redistributable (x86)
- Microsoft Visual C++ 2013 Redistributable (x64)
- Microsoft Visual C++ 2017 Redistributable (x86)
- Microsoft Visual C++ 2017 Redistributable (x64)

(4) Restart PC
Restart the PC to prepare the PC environment. The installer restarts automatically, so
after restarting the PC, be sure to log in with the same user account. The installer will
start automatically after restarting the PC and continue processing.

V3-ML-1001E 9th Edition : Jul. 2023

2-16

(5) Install the OmegaLand software

The installation program is used to install the OmegaLand software. The installation will
take about five to ten minutes depending on CPU speed and memory capacity.

(6) OmegaLand Environment Settings

The OmegaLand environment setting tool is automatically started, and communication
setting processing and security setting processing are performed.

(7) Install patches for OmegaLand

If patch package(s) for OmegaLand are included, they should be installed after installing
the main software.

(8) Set the license key

Attach the license key that is supplied with the product.

Note

Attach the USB hardware key after OmegaLand has been installed. If it is attached
before the installation of OmegaLand, the driver will be requested and the system may
become unstable as a result.

2.5.2. Starting the Installation Program

Insert the setup DVD-ROM (CD-ROM) into the drive. The installation program will
start automatically. If the installation program does not start automatically, start it
manually by double-clicking on the setup.exe icon on the DVD-ROM (CD-ROM).

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-17

2.5.3. Installing the Prerequisite Software

First, the prerequisite software installation dialog box is launched.

The installer version (V350) is displayed as “Requirement” in the dialog.

Figure 2.5-1 Install Prerequisite Software

Clicking the [Install] button displays a dialog box for selecting the platform (32-bit /
64-bit) of the product to be installed.

Figure 2.5-2 Platform of Install Product

Select the platform of the product to be installed and click the [Next] button.

V3-ML-1001E 9th Edition : Jul. 2023

2-18

Next, a dialog box for selecting the type of setup PC is displayed.

Figure 2.5-3 Select Setup Type

- Setup of the OmegaLand PC

Select “OmegaLand PC” if the PC will be used for starting the standard OmegaLand.
Select this option for any PC on which the OmegaLand software will be started,
including main PC or sub PC.
- Setup of the external connection server PC
When connecting a third-party system to OmegaLand via the external connection
function, in the standard communication specification, the external connection
function is installed on the destination third-party system PC. In this case, selecting
“External Connection Server PC” will only install the functions required to connect
with the third-party system.

Select the setup type and click the [Finish] button.

Note

It is not mandatory to install the external connection server function on the third-party
system PC. It will depend on the relationship between the third-party communication
specification and OmegaLand, so refer to the connection specification for each system
in the appendix of the “Connection Function Reference Manual”.

Information

It may be possible to configure the external connection server PC as the OmegaLand PC,
depending on the connection configuration with the third-party system. All the contents
to be set up on the external connection server PC are included in the contents to be set
up on the OmegaLand PC. Therefore, in this case, there is no need to install a separate
package for the external connection server.

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-19
The required software is selected and installed from the following prerequisite software
according to the setup type and the PC environment.
・Microsoft .NET Framework 4.7.2
・Microsoft Visual C++ 2013 Redistributable (x86)
・Microsoft Visual C++ 2013 Redistributable (x64)
・Microsoft Visual C++ 2017 Redistributable (x86)
・Microsoft Visual C++ 2017 Redistributable (x64)

The following dialog box is displayed during the installation of the prerequisite
software.

Figure 2.5-4 Installation of the prerequisite software

A message prompting a restart may appear after the installation of the prerequisite
software have completed.

Figure 2.5-5 PC Restart

In this case, select [OK], restart the PC, log on with the same user account, and proceed
with the installation process of the OmegaLand software. After you log on, the
installation program will start automatically.

V3-ML-1001E 9th Edition : Jul. 2023

2-20

2.5.4. Installation of the OmegaLand software

(1) Welcome window
When the installation program is started, the “Welcome to OmegaLand setup program”
window will appear.

Figure 2.5-6 Welcome Window

Click the [Next] button.

(2) Installation information

Important information related to the installation of OmegaLand will be displayed.

Figure 2.5-7 Installation Information

Read them carefully, and then click on the [Next] button.

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-21
(3) License agreement
The license agreement for OmegaLand will be displayed.

Figure 2.5-8 License Agreement

Using the scroll bar on the right side, carefully read and confirm the content of the
license agreement. If you agree with the content of the license agreement, tick the [I
accept the terms of the license agreement] check box and click on the [Next] button. A
written copy of the license agreement will also be required.
(4) Enter the license code
The window for entering the license code will be displayed.

Figure 2.5-9 Enter License Code

Enter the license code described on the license information sheet issued by Omega
Simulation Co., Ltd.

V3-ML-1001E 9th Edition : Jul. 2023

2-22
(5) Enter the license code 2
If a package including the optional calculation function was purchased, the window for
entering the license code 2 will appear.

Figure 2.5-10 Enter License Code 2

Enter the license code 2 described on the license information sheet and click the [Next]
button.

(6) Enter the network server PC name

In the case of a network license, a window for entering the license server PC name will
be displayed.

Figure 2.5-11 Enter Network License Server PC Name

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-23

Enter the computer name or IP address of the PC to be used as the license server PC, and
click the [Next] button.

Note

In the case of a network license, a hardware key must be connected the license server. It
is necessary to install a hardware key driver on the PC to be used as a license server.

(7) Select the installation path

The window for selecting the installing destination will be displayed.

Figure 2.5-12 Choose Destination Location

Specify the folder to install the OmegaLand software.

By default, each the following folder will be used in accordance with the installation
condition.
- for 64-bit product
C:\Program Files\Omega Simulation\OmegaLand
- for 32-bit product
C:\Program Files (x86)\Omega Simulation\OmegaLand

To change this folder, click on the [Browse…] button and specify an appropriate drive
or folder. Then click on the [Next>] button.

V3-ML-1001E 9th Edition : Jul. 2023

2-24
(8) Start the file copy
The installation confirmation window will be displayed.

Figure 2.5-13 Start Copying Files

Check the displayed information and, if everything is correct, click on the [Next] button
to begin the installation. The setup status dialog will open.

Figure 2.5-14 Setup Status

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-25

(9) OmegaLand Environment Settings

When installation is complete, the OmegaLand environment setting tool is automatically
started, and communication setting processing and security setting processing are
performed.

Figure 2.5-15 OmegaLand Environment Setting

(10) Complete the OmegaLand installation

A window indicating that the installation is completed will then be displayed.

Figure 2.5-16 Complete Installation

V3-ML-1001E 9th Edition : Jul. 2023

2-26

2.5.5. Processes in “Installation and OmegaLand

Environment Settings”
The following processes were executed during this installation:
- Transfer of the OmegaLand software package files
- Registration to the Start menu or registry
- Association of files
- User security settings
- DCOM settings
- File access settings

The required files for running OmegaLand are stored in the selected installation
destination folder on the hard disk. This folder is called the OmegaLand installation
folder and is referred to as the <<installation folder>> in this document.

Note

Depending on the system, the antivirus software installed on your PC may block the
operation of OmegaLand or block normal operation such as denying file access. In this
case, refer to "6.4. Anti-virus Software".

Information

When using Windows Defender which is included with Windows 10, the exclusion
setting from real-time scanning against the OmegaLand software will be done
automatically when installing OmegaLand.

2.5.6. Installing the Service Packages and Patches

All included service packs and/or patch packages should be installed. Refer to the
document supplied with each package for details on the installation and the installation
method.

2.5.7. Installing the License Key

To start OmegaLand, it is necessary to attach the license key.

Note

It is advisable to connect the hardware key directly to the USB port of the PC as it offers
more stable power supply.

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-27

2.6. Tasks to Be Performed after Installing

OmegaLand

2.6.1. Steps to Connect to the External System

In order to connect OmegaLand with an external system for data exchange, it is
necessary to install the external connection server as well as to configure the external
connection setting dialog on the OmegaLand PC. Refer to the “OmegaLand External
Connection Function Reference” for details.

2.6.2. Steps to Activate the Network License

To use a network license, it is necessary to set up a license server PC in the network. Of
all the PCs in the same network, the licensed number of PCs will be started as master
PCs.

 Hardware key
The network version of the key should be used. Two USB dongle versions (new/old)
exist for the hardware key; the new version (red) can be identified by the “NET 10 DL”
inscription and the old version (black) can be identified by the “NET0556” inscription.

Information

The new local hardware key (blue) has the inscription “PRO DL” and the old version
(black) has the inscription “SGS00556.”

 Network License server PC

The network license server software is required for the PC on which the network license
server will be run.
Install it by following the procedure described below.

 Installation of the software for the network license server

Follow the procedure below to install the software on the network license server PC.
(1) Log on using an account with administrator rights.
(2) Double-click “InstallNetDLdriver.bat” on the “Attachment\driver\NetDL”
folder included in the OmegaLand product media. Follow the instructions displayed
in the window to install the program.

The installation of software for the network license server is now complete.

V3-ML-1001E 9th Edition : Jul. 2023

2-28

Note

Communications between the network license server PC and the OmegaLand PC have
different security settings for Windows Firewall depending on the configured network
profile.
- When set to domain network and private network:
The security settings are released at the same time as the above-mentioned software
is installed for the network license server, so it can be used it as it is.
- When set to public network:
Since the security settings are not released, it is necessary to switch to a private
network or take other measures to release the security settings.
For information on actions to unlock security settings, use the contact information
provided in "6.5. User Support" in this manual.

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-29

2.7. Testing of Installed OmegaLand

After installing OmegaLand, make sure that it operates normally.

When OmegaLand is installed, a folder called “OmegaLandV3Sample” is created
directly under the installation drive. If the C drive (default) was selected as the
installation drive, the folder path is C:\OmegaLandV3Sample. In the following
sections, refer to the descriptions that correspond to your installation.

2.7.1. If VM-EQUATRAN was Installed

Check the operation by following the procedures below.

(1) Open the Windows [Start] menu and select [Visual Modeler] under [OmegaLand
V3]. Visual Modeler starts as the VM-EQUATRAN system.
(2) The “project.vms” file is located in the following sample folder.
C:\OmegaLandV3Sample\eq_tutorial\STEADY
Click [File] - [Open] in the menu bar to load “project.vms”.
(3) A process flow diagram (PFD) appears when [model] - [PROCESS1] in the
simulation view is right-clicked and [Open] is selected.

Figure 2.7-1 Process Flow Diagram (PFD)

(4) The simulation is executed (Flozen) when [model] - [PROCESS1] in the

simulation view is right-clicked and [Start] is selected.

V3-ML-1001E 9th Edition : Jul. 2023

2-30
(5) Select [Steady] - [Calculate Steady State] in the menu bar to start the steady
state calculation.
(6) The operation check is complete when the same calculation results as the
following view of PFD can be obtained.

Figure 2.7-2 The results of the steady state calculation

(7) End VM-EQUATRAN by selecting [File] - [Exit Visual Modeler] in the menu bar.

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-31

2.7.2. If Visual Modeler was Installed

Check the operation by following the procedures below.

(1) Open the Windows [Start] menu and select [Visual Modeler] under [OmegaLand
V3]. Visual Modeler starts.
(2) The “project.vms” file is located in the following sample folder.
C:\OmegaLandV3Sample\Transport\Transport
Click [File] - [Open] in the menu bar to load “project.vms”.
(3) A process flow diagram (PFD) appears when [model] - [PROCESS1] in the
simulation view is right-clicked and [Open] is selected.

Figure 2.7-3 Process Flow Diagram (PFD)

(4) Select [PFD] - [Maintenance] - [Remake All] - [All Processes] in the menu bar.
Click on the [OK] button in the “The current unit object file may be deleted.”
confirmation dialog box.

Figure 2.7-4 Deletion Confirmation Dialog Box

V3-ML-1001E 9th Edition : Jul. 2023

2-32
(5) Click on the [Start] button in the [Remake All] dialog box, and click on the [Close]
button when “END ALL” is displayed in the progress status field.

Figure 2.7-5 Remake All Unit Objects

(6) The simulation is executed (Flozen) when [model] - [PROCESS1] in the

simulation view is right-clicked and [Start] is selected.
(7) Select [Dynamic] - [Run] in the menu bar to start running the simulation.
(8) Right-click the icon of the control valve LCV01 and select [Variables].
Enter 0.5 in the text box for “mv” in the displayed dialog. This will start the
flow from the outside of the plant to the pump.

Figure 2.7-6 Control Valve LCV01 Settings

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-33
(9) Change the values of the “on” parameter of the pump GA01 to 1 (:Run) and “mv” of
the regulation valve FCV01 to 0.5 in the same manner.
(10) Check how L value of the level gage LI01 and F value of the flowmeter
FI01 change.

Figure 2.7-7 Operation Check

(11) The operation check is now complete.

Freeze the operation selecting [Dynamic] - [Freeze] in the menu bar, and select
[File] - [Exit Visual Modeler].

V3-ML-1001E 9th Edition : Jul. 2023

2-34

2.7.3. If OmegaLand Was Installed

Test the operation by following the procedures below.

(1) Open the Windows [Start] menu and select [OmegaLand Main] under [OmegaLand
V3]. The main UI of OmegaLand starts.
(2) The “project.sim” file is located in the following sample folder.
C:\OmegaLandV3Sample\Transport\Transport2
Click [File] - [Open] in the menu bar to load “project.sim”.
(3) A process flow diagram (PFD) appears when [model] > PROCESS1 in the
simulation view is right-clicked and [Open] is selected.

Figure 2.7-8 Process Flow Diagram (PFD)

(4) Select [PFD] - [Maintenance] - [Remake All] - [All Processes]in the menu bar.
Click on the [OK] button in the “The current unit object file may be deleted.”
confirmation dialog box.

Figure 2.7-9 Deletion Confirmation Dialog Box

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-35

(5) Click on the [Start] button in the [Remake All] dialog box, and click on the [Close]
button when “END ALL” is displayed in the progress status field.

Figure 2.7-10 Create Unit Object Files

(6) In the simulation view, select:

- [Model] - [PROCESS1]
- [Monitor] - [Trend] – [TrendGroup01]
- [Database] - [DB1]
and right-click and select [Start]. All states will change to “Frozen”.

Figure 2.7-11 Start the Model/Trend/Database Functions

V3-ML-1001E 9th Edition : Jul. 2023

2-36
Information

The above is a screenshot image of Main UI when the 64-bit product is installed. In the
32-bit product, “Process List” is displayed on the center of the Main UI window, and the
PFD is displayed as a separate window.

(7) In the simulation view, select [Operation] - [Graphic] - [_GR1], right-click, and
select [Start].

Figure 2.7-12 Start the Graphic Function

(8) Click the [Run] button on the banner in the graphic window to start running
the simulation.
(9) The alarm will sound and the “Alarm Lamp” icon in the upper left will start
flashing. Click on the flashing icon and then click on the [Acknowledge all] button
in the displayed “Alarm” dialog.
(10) Click on the pump to activate it.

Figure 2.7-13 Activate the Pump

V3-ML-1001E 9th Edition : Jul. 2023

 2. Installation 2-37

(11) The color of the pump unit in the graphic window changes, indicating that it has
switched to the “ON” state.

Figure 2.7-14 Pump Unit ON State

(12) Click LC01 and FC01 of the PID controller to display a simplified faceplate, and
enter MV values randomly to see how the display will change. Also, display the
faceplate of the flow meter FI01 and check for changes in the flow rate. The
operation check is now complete.

Figure 2.7-15 Display the Faceplates

(13) Freeze the simulation by clicking the [Freeze] button on the banner in the
graphic window.
(14) End the simulation by selecting [File] - [Exit Simulation] in the menu bar of the
main UI.

V3-ML-1001E 9th Edition : Jul. 2023

2-38

2.7.4. Now, Let’s Start the Operation!

The installation and operation check have now been completed. Begin by using the
following manuals.

 If Visual Modeler was installed

First, refer to the “V3-ML-2001E: VM-EQUATRAN Tutorial”.
The basic concept and operation method of VM-EQUATRAN can be learned through
actual operation.
Refer to the “V3-ML-1013E: EQUATRAN User’s Guide” for getting the syntax of
EQUATRAN.

 If Visual Modeler was installed

First, refer to the “V3-ML-3011E: Visual Modeler Reference” for the 32-bit product, or
the “V3-ML-3002E: Unified Main UI Reference” for the 64-bit product.
The “V3-ML-2003E: Visual Modeler Tutorial” will also be provided. The basic concept
and operation method of Visual Modeler can be learned through actual operation.

 If OmegaLand was installed

First, refer to the “V3-ML-1013E: OmegaLand User's Guide”.
The “V3-ML-2002E: OmegaLand Tutorial” will also be provided. The basic concept
and operation method of OmegaLand can be learned through actual operation.

V3-ML-1001E 9th Edition : Jul. 2023

 3. Functions of OmegaLand 3-1

3. Functions of OmegaLand
OmegaLand is a software package for designating an Integrated Environment for
Dynamic Simulation. OmegaLand allows constructing systems supporting a variety of
purposes required in various industrial sectors by combining functions such as database
functions, graphic functions, rich instructor functions and as its core application, Visual
Modeler: a dynamic simulator, that offers superior real-time performances and that
enables building large-scale virtual plants.
This chapter introduces the overview of the application functions of OmegaLand in
sequence.

V3-ML-1001E 9th Edition : Jul. 2023

3-2

3.1. Functional Structure of OmegaLand

This chapter introduces a typical configuration of OmegaLand when using it as an
operator training simulator (OTS).

Figure 3.1-1 OmegaLand Functional Configuration Example

All application functions including the model and instructor functions can be opened
and edited in Main UI. Moreover, the function operations such as run/pause, save/load
initial condition, time-scale change, can also be performed from Main UI.
All application functions of OmegaLand operate in a virtual space called VMSpace. The
communications between the functions, such as execution control/state notification/data
exchange, are possible among multiple PCs connected in the Ethernet in the same
manner as on a single PC.
A dedicated communication system interface is available for connection with other
systems such as DCS and PLC; and a communication package is provided for each
system.

V3-ML-1001E 9th Edition : Jul. 2023

 3. Functions of OmegaLand 3-3

3.2. Main UI

Main UI is the central user interface (UI) used for centralizing and operating the
application functions of OmegaLand. The following figure shows the window image of
Main UI.

Figure 3.2-1 Main UI Window Image

Main UI is used to build simulation projects and use them in operations; and it also
provides the necessary functions for managing and maintaining the built projects.
Main UI supports the following functions.

- Building a simulation
- Registering the processes
- Executing the simulation
- Operating and managing of snapshot/initial condition files
- Displaying the log information
- Merging projects

V3-ML-1001E 9th Edition : Jul. 2023

3-4

3.3. Model Function (Visual Modeler)

The model function of OmegaLand is used to reproduce the behavior of plants operated
in the process industries, in particular chemical, petrochemical, and refining plants. It
features models detailed on the plant level to produce high-fidelity and
high-performance simulations for achieving various objectives. Dynamic simulation is
of course supported, and it is also possible to perform steady-state simulations using the
same detailed models.
Visual Modeler is intended to provide a virtual plant as a replica of a real plant for
various purposes such as operator training, analysis and examination of processes,
design and verification of control system, education on chemical processes, operation
assistance, and operation optimization.
A virtual plant model can be created on a Process Flow Diagram (PFD) by placing
“units” corresponding to actual equipment arranged on the drawing area, connecting
these units with “streams” which are equivalent to real piping, and defining the physical
property data and calculation methods that are handled by these units and streams. The
plant model is complete when all unit sizing and property parameters have been
properly assigned.

The following figure is an image of the PFD display of the model function.

Figure 3.3-1 Model Function Window Image

Depending on the purpose, the model function can have the following three types of
usages:
- Standard model function
- Operation oriented model function
- Standalone start of Visual Modeler

V3-ML-1001E 9th Edition : Jul. 2023

 3. Functions of OmegaLand 3-5
 Standard Model Functions
It is a standard function activated from Main UI. It has functions necessary for building
and executing models, and this function is used for normal work.

 Operation oriented model function

The model parameters can be changed, but the model configuration cannot be changed
nor the model itself be edited.
An already built model function can be started, and used as a sub window for operation
verifications and tuning, or remote start up, so that it can be used as a window operated
by an operator.

 Standalone startup of Visual Modeler

If the model function is started standalone as Visual Modeler, the model application of
multiple processes will be started within the frame of the model function. Moreover, the
processing menu for functions that are available in Main UI, such as saving an initial
condition and loading, time-scale change, will be added.
The following figure shows the window image when Visual Modeler is started
standalone.

Figure 3.3-2 Window Image of Standalone Startup of VM

V3-ML-1001E 9th Edition : Jul. 2023

3-6

3.4. Unified Main UI

The 64-bit product version of OmegaLand integrates the “Main UI” functions and the
“Model Function (Visual Modeler)” described above into a single frame, and provides
them as the “Unified Main UI”.
The individual functional specifications are the same as the conventional 32-bit product
version, but the operability is markedly improved because model execution and
operation management of the entire simulation can be performed in a single frame.
The figure below shows a screenshot of the Unified Main UI.

Figure 3.4-1 Window Image of Unified Main UI

In Unified Main UI, the process flow diagram (PFD) of the model is displayed in the
center frame, and the process list is displayed in the lower log information display
frame.
For more details, refer to “V3-ML-3002E: OmegaLand Unified Main UI Reference”.

V3-ML-1001E 9th Edition : Jul. 2023

 3. Functions of OmegaLand 3-7

3.5. Monitor Function

This function monitors for fluctuations or changes in the process variables, while the
simulation is running. The desired variable value can be displayed directly in the process
flow diagram (PFD) of the model function. Also, three monitor functions are provided to
visually check for the time-series changes of variable values and compare them to other
variables.

3.5.1. Trend
This function displays the history of the time-series changes of variables. The display
variables can be grouped, and the collection cycle, collection timing and start/stop of the
trend function are executed in groups.
Variables of different processes can be displayed in the same trend window.

Figure 3.5-1 Trend Window

The panel display function, which integrates multiple trends into a single panel and
offers functions such as resize and show/hide, is also supported.

V3-ML-1001E 9th Edition : Jul. 2023

3-8

3.5.2. Stream Table

This function updates and displays the variables in multiple streams in the form of a
table.
Variables for different processes can be displayed in the same stream table window.

Figure 3.5-2 Stream Table

3.5.3. Monitor Panel

This function displays and automatically updates the variables selected from multiple
units or streams. It is also possible to change the variable value by entering data for the
variable in the panel.
Variables for different processes can be displayed in the same monitor panel.

Figure 3.5-3 Monitor Panel

V3-ML-1001E 9th Edition : Jul. 2023

 3. Functions of OmegaLand 3-9

3.6. Script Function

The script function conducts a simulation automatically by following a predefined
procedure. Data changes in the variables of application functions, such as the model
function, database function and connection function, are described to be executed as
conditions of an automatic operation.
The following figure shows the image of the script definition window.

Figure 3.6-1 Script Definition Window Image

The script texts for the script function are programmed in a simplified hierarchical
language.
In general, there are various usages for this function, to automatically perform unsteady
state operations such as for plant startup or brand switching, or to cause abnormal
conditions (malfunctions) in the plant such as equipment and instrument failures in an
operator training simulator (OTS).

V3-ML-1001E 9th Edition : Jul. 2023

3-10

3.7. Graphic Function

The graphic function provides a graphical user interface (GUI) capability. This GUI is
aimed for the plant operators and instructors using the operator training simulator, as
well as the trainees using the plant training system. A user-friendly and realistic interface
allows easy-to-use, effective systems to be built.

 Graphic applications
The following figure shows an example of the graphic application.

Figure 3.7-1 Graphic Application Window

Graphic applications are made up of window units. Multiple graphic applications can be
displayed simultaneously on a single PC and moved to desired locations. Also, it is
possible to specify the graphic application to be displayed by default on each PC.

V3-ML-1001E 9th Edition : Jul. 2023

 3. Functions of OmegaLand 3-11
 Graphic components
Graphic applications are created by pasting figure parts called “components.” There are
the so-called “basic shapes” such as rectangle and line components, “windows controls”
such as the text boxes and buttons, and “OmegaLand controls” such as heat exchangers,
valves, and pumps.
The following figure shows an example of OmegaLand controls components.

Figure 3.7-2 OmegaLand Controls Components

 Edit function
Graphic Builder is used for editing the graphic applications.

Figure 3.7-3 Graphic Builder Edit Window

V3-ML-1001E 9th Edition : Jul. 2023

3-12
 Execution function
The Graphic Runtime is used to display the graphic applications that have been built.
The graphic applications can not only be displayed on the master PC but also on
multiple sub PCs that are connected in the network.
The following figure shows the execution window of the graphic function.

Figure 3.7-4 Graphic Application Execution Window

V3-ML-1001E 9th Edition : Jul. 2023

 3. Functions of OmegaLand 3-13

3.8. Instructor Function

The instructor function provides the set of functions required for the instructor
operations when using OmegaLand as an operator training system (OTS).
The instructor function provides panels for the following seven functions used by the
instructor and a summary panel, which offers a panoramic view of the entire functions.
- Monitor panel
- Malfunction panel
- Instructor variable panel
- Evaluation panel
- Scenario
- Event log panel
- Report panel

The following shows the default display panel of the instructor function. The important
parts of other function panels are summarized and displayed in this panel. Normally, the
instructor only needs to monitor and operate the summary panel. When an event of
interest occurs, the instructor can switch to the applicable function panel to check the
details.
The following figure shows the image of the summary panel.

Figure 3.8-1 Summary Panel

V3-ML-1001E 9th Edition : Jul. 2023

3-14

3.9. Database Function

The database function provides a mechanism for creating data areas anywhere within a
simulator. Furthermore, database applications play active roles such as collecting data
from other applications in the simulation and updating the variable data in the database,
providing simple processing capabilities including filtering and basic arithmetic
operations using its calculation functions, and periodically saving the collected data as
history data.
The following figure shows the image of the edit window of the database function.

Figure 3.9-1 Database Function Edit Window

V3-ML-1001E 9th Edition : Jul. 2023

 3. Functions of OmegaLand 3-15

3.10. Connection Function

The connection function provides the functions for connecting OmegaLand with other
external systems. In this function, a dedicated connection software cassette is provided
for each connection target external system to build an interface with the external system.
The connection function connects the parameters of OmegaLand to the ones of the
external systems, and performs data exchange on a periodic basis. This data exchange is
called marshalling and is responsible for the software connection between OmegaLand
and the external system.
The following figure shows the image of marshalling with an external system.

Model Function DCS Control Logic

(Visual Modeler)

Software Cassette
for DCS Connection

Connection Function
FI3101.F FC3101.RAW

FCV3101.mv FC3101.MV

Figure 3.10-1 Marshalling Image

The connection function can start multiple applications in a simulation project. Different
systems can be selected as the external connection targets.
The data types supported for marshalling items are integer, real number and string types.
The data of arrays up to two-dimensional arrays can be read/written as individual items
by specifying the array position.

V3-ML-1001E 9th Edition : Jul. 2023

3-16

3.11. OPC Server Function

OPC (OLE for Process Control) is a standard interface specification that has been
designated to allow hardware and software in the process control to operate
cooperatively with each other.
The OPC server function complies with the OPC DA interface specification and
provides up to four server functions to communicate data with various OPC clients.

V3-ML-1001E 9th Edition : Jul. 2023

 4. Operator Training Simulator 4-1

4. Operator Training Simulator

OmegaLand is designed to allow systems for a variety of purposes to be built by
combining its application functions. However, the most frequently used feature of
OmegaLand is the operator training simulator.
It is an environment for building a plant operation training system in which most of
OmegaLand’s application functions are used, including the instructor function.
A training system is realized with an actual DCS machine or with the emulation of DCS
with graphics. The former, a system using an actual DCS, provides features that control
system parameter values set on site can be used as they are. In addition, with the actual
DCS used as the operation console, operations equivalent to actual operation systems
are achieved. However, the scale of the system becomes larger. On the other hand, a
DCS emulation type system simulates DCS interface in the graphic window and creates
the logic of actual control equipment as control models of Visual Modeler. This allows a
more compact system to be built.
This chapter introduces the functional configuration of OmegaLand when using it as an
operator training simulator.

V3-ML-1001E 9th Edition : Jul. 2023

4-2

4.1. Functions Required for the Operator Training

System
The following functions are available for the operator training system:
 Execution control function
This function controls the execution of run/pause, save/load snapshot, time-scale change,
etc.
It can be operated in parallel from the main UI and the instructor function.

 Saving/loading initial condition functions

These functions save and manage the current state of the plant or DCS in a file. A
training ready state can be created at any time by reloading a saved file.
 Field operation emulation function
In actual plant operations, field operations are required in addition to the DCS operations.
DCS operations are performed in the control system window using the HMI of an actual
DCS machine, but the field operation window is built using the graphic function and
emulates the field operations.

 Malfunction function
This function can deliberately cause abnormal equipment states and failures
(malfunctions) and is used for incident response trainings. A malfunction can be defined
either in the malfunction definition window of the instructor function or by describing a
condition/statement in the scenario definition in the instructor function. In one of the
methods, a command is issued by selecting from a list on the execution control panel. In
the other, a command is given by pressing a button on the dedicated-for-malfunction
panel provided on the graphic window.

 Automatic operation function

A scenario panel is available for the scenario and instructor functions as a means to
achieve a training based on a series of procedures following a scenario or a training
(karaoke execution) with procedures created by omitting the operations of a specific
operator. Even in the execution of a malfunction, this automatic operation function can
be used if multiple operations are required, if variables are controlled over a certain
period of time, or if processing is selected depending on the conditions.
 Replay evaluation function
This function is used to reproduce the operations of a completed operator training. It is
used by the instructor to review the training with trainees, by double-checking the
operations performed by the trainees and giving them guidance as necessary. The
operation record and process data (events) are logged and can be output to a file.
 Connection function
Actual DCS connection type systems require the connection function in order to connect
with DCS. Variable names to be accessed from DCS are acquired and linked with
variables in OmegaLand (marshalling); and they can be used to exchange data or send
execution control commands to the DCS side on a periodic or one-time basis. Systems
other than DCS can also exchange data with OmegaLand, as long as they have an
interface that can be identified with a variable name.

V3-ML-1001E 9th Edition : Jul. 2023

 4. Operator Training Simulator 4-3

4.2. Realization Configuration

4.2.1. Actual DCS Connection Type

The following figure shows the hardware configuration of an actual DCS connection
type.

Figure 4.2-1 Actual DCS Connection Type Hardware Configuration

This example shows the connection with a third-party system (DCS). For example, if the
CENTUM VP manufactured by Yokogawa Electric Corporation is used as the DCS, the
HIS simulator, FCS simulator and Exatif will be used as the operator console, controller
and communication function interface, respectively.
The following figure shows the software configuration of an actual DCS connection
type.

Figure 4.2-2 Actual DCS Connection Type Software Configuration

V3-ML-1001E 9th Edition : Jul. 2023

4-4
In the case of an actual DCS connection type, it is necessary to install the external
connection server and communication function interface on the PC on the DCS side.
Refer to the “External Connection Function Reference” for details on setting the
external connection function.
Each application function of OmegaLand instructs RUN/STOP and performs data
exchange using the VMSpace communication function. The VMSpace communication
function enables data to be exchanged between two different PCs (hardware) in the same
manner as between applications running on the same PC.

4.2.2. DCS Emulation Type

The following figure shows the hardware configuration of a DCS emulation type.

Figure 4.2-3 DCS Emulation Type Hardware Configuration

It emulates the DCS functions with the application functions of OmegaLand; and this
type of configuration achieves all functions using the OmegaLand functions.
The following figure shows the software configuration of the DCS emulation type.

Figure 4.2-4 DCS Emulation Type Software Configuration

A “control system model” is built in the control system logic part using the model
function, and the DCS operation window is built using the graphic function. All
applications run on the VMSpace, enabling a compact system to be built.

V3-ML-1001E 9th Edition : Jul. 2023

 4. Operator Training Simulator 4-5

4.3. Distributed Environment

The OTS is usually configured by distributing multiple PCs according to their function
as follows:
- Model PC: Realizes the main functions OmegaLand including the model.
- Instructor PC: The instructor proceeds with and monitors the training procedure.
- Control System Operation: the DCS operator performs operation training
- Field operation PC: the field operator performs operation training
For each of these uses, OmegaLand provides an environment for exchanging data and
exchanging information with each other so that functions distributed among multiple
PCs can be operated within a single PC.
There are two distributed environments in OmegaLand, the “shared distributed” method
that consolidates a project database using Windows folder sharing, and the “non-shared
distributed” method where project folders are copied to each PC and referred to
individually.
In the case of the “shared distribution” method, it is necessary to set the folder sharing
by taking security into consideration, but since the database can be unified, it is possible
to edit the project in a distributed environment.
In the case of the “non-shared distribution” method, since the same project database is
required on each distributed PC, it is in principle not possible to edit the project in the
distributed environment.

4.3.1. Shared Distributed Setup Procedure

Set shared distribution by the following procedure.

(1) Place the project database

Share the top folder of the distributed project database and make it visible from other
PCs.

Note

The shared folder does not necessarily have to be the top folder of the project. Since it is
intended for reference from other PCs, it is OK if any of the upper folders that include
the top folder of the project is set to be shared.

V3-ML-1001E 9th Edition : Jul. 2023

4-6

Set the shared settings in the “Properties” “Sharing” tab sheet by right clicking on the
folder and opening the “Properties” dialog.

Figure 4.3-1 “Folder Sharing Properties” Setting Dialog

Select the [Advanced Sharing] button to open the “Advanced Sharing” dialog.

Figure 4.3-2 “Advanced Sharing” Setting Dialog

Add a ✔ to “□Share this folder”, and select the [Permissions] button of the
[Settings] category to open the “Share Permissions” dialog.

V3-ML-1001E 9th Edition : Jul. 2023

 4. Operator Training Simulator 4-7

Figure 4.3-3 “Share Permissions” Setting Dialog

Add “Everyone” to the “Group or user names” of the “Share Permissions”, and
add a ✔ in the “Full Control” box of the “Permissions for Everyone”.
Select [Apply] and then the [OK] button.

(2) Setup the Master PC.

Run the OmegaLand Utility as “administrator”.
Select the [Basic Setting] menu and set the computer name or IP address of the PC on
which the license key is installed in the [Common] - [Master PC] input window.

Figure 4.3-4 OmegaLand Utility Basic Setting Menu

It is necessary for every sub-PC to set the “Master PC” item. There is no need to set this
item on master-PC itself.

V3-ML-1001E 9th Edition : Jul. 2023

4-8
(3) Define the system configuration of the simulation
Start the simulation, right-click the simulation TOP of the simulation view, and select
[System Configuration].

Figure 4.3-5 Start “System Configuration” Definition Dialog

The “Simulation Configuration” definition dialog opens.

Figure 4.3-6 “System Configuration” Definition Dialog

Use the [Add] button to define the computer names and IP addresses of all the PCs that
make up the system.

V3-ML-1001E 9th Edition : Jul. 2023

 4. Operator Training Simulator 4-9

(4) Define the application start PC

Select the application you want to activate on the sub PC side in the simulation view and
right-click to open “Properties”.

Figure 4.3-7 “Application Properties” Setting Dialog

Select and enter the PC you want to activate in the input window of the window start PC.

This completes the setup of the shared distribution.

4.3.2. Non-Shared Distribution Setup Procedure

Set non-shared distribution by the following procedure.

(1) Place the project database.

(2) Set the master PC in all sub PCs

For the master PC setup procedure refer to step 2 of “4.3.1. Shared Distributed Setup
Procedure”.

V3-ML-1001E 9th Edition : Jul. 2023

4-10
(3) Set distribution information on all PCs.
Run the OmegaLand Utility as “administrator”.
Select the [Basic Setting] menu.
Add ✔ to the “Do not share project folder in distributed environment” item of the
[VMSpace] category.
Set the [Distributed Project ID] and [Project Path] of the [VMSpace] category.

Figure 4.3-8 OmegaLand Utility Basic Setting Menu

(4) Define the system configuration of the simulation.

For the system configuration definition procedure refer to step 3 of “4.3.1. Shared
Distributed Setup Procedure”.

(5) Define the application start PC.

For the application start PC definition procedure refer to step 4 of “4.3.1. Shared
Distributed Setup Procedure”.

This completes the setup of the non-shared distribution.

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-1

5. Tools and Utilities Outline

5.1. Project Converter

A project built in OmegaLand V2.7 is converted into a format that can be used in
OmegaLand V3.

5.1.1. Conversion Workflow

Following figure shows the conversion workflow.

Figure 5.1-1 Conversion Workflow

V3-ML-1001E 9th Edition : Jul. 2023

5-2

First of all, prepare the conversion source project.

If the project was built in a distributed environment, the files are aggregated to create a
single-PC project configuration (Refer to the following figure).

PC-1

Aggregating files

PC-2 on a single PC

Figure 5.1-2 File Aggregation Example

The project converter is then started to perform the conversion. The EXEC definition
file for the V2.7 project (.vex) and the destination folder should be specified for the
project converter.

After the conversion has finished, check the V3 project that has been output.
First, double-click the simulation definition (project.sim) in the destination folder
to open the simulation. After opening the simulation, open the model to check the
conversion result.
Adjust the PFD including the unit placement, stream, signal line, etc., and then, perform
[Remake All]. All models must be checked and performed “Remake All.”
Then check the settings of functions other than the model function and configure a
distributed environment as necessary.

Once all the verification processes are complete, perform an overwrite save in the main
UI.

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-3

5.1.2. Start
The project converter is started from the Start menu.

Figure 5.1-3 Start Menu

Windows Explorer can be started by selecting [Start] - [OmegaLand V3] - [Tools].

Start the project converter by double-clicking on its shortcut in the opened folder.

Figure 5.1-4 Project Converter Shortcut

V3-ML-1001E 9th Edition : Jul. 2023

5-4

5.1.3. Project Conversion Procedure

The following figure shows the project converter window. The project converter screen
consists of the text box for entering the V2.7 project definition (EXEC definition file),
text box for specifying the V3 project output destination folder, “Convert” button for
executing the conversion, and the log display area for the conversion result.

Figure 5.1-5 Project Converter Window

After preparing the conversion source project created in V2.7 on an appropriate folder,
specify the V2.7 EXEC definition file (*.vex) or the Visual Modeler definition file
(*.vmp) as the “V2.7 Project”. When “*.vex” is specified, all function modules
registered in the corresponding EXEC are targeted for conversion and reconfigured as a
project of V3. On the other hand, when “*.vmp” is specified, only the functional scope
of Visual Modeler will be covered and will be reconfigured as a V3 project.
For the “V3 Project”, specify the output destination of the converted V3 project as an
absolute path.
Clicking the [Browse] button next to the text box opens the file (folder) selection dialog
for selecting a file (folder).
Click the [Convert] button to start the conversion process.

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-5

If files and/or folders exist in the destination folder, the window shown in Figure 5.1-6
will be displayed. Click [Yes] to delete the existing file and proceed with the conversion,
or click [No] to cancel the conversion.

Figure 5.1-6 Conversion Continuation Check

When the conversion finishes, a conversion log is output as shown in the following
figure. An error log will be output when an error occurs during the conversion process.

Figure 5.1-7 Conversion Log Display

V3-ML-1001E 9th Edition : Jul. 2023

5-6

5.1.4. Conversion Log Display

The conversion log is saved in the following folder:

(Program Data)\Omega Simulation\OmegaLand\Logs\Convert\Convertlog.txt

Also, the above file can be opened by clicking [File] > [Open Log] in the menu in the
project converter window shown in the following figure.

Figure 5.1-8 Conversion Log Display Menu

5.1.5. Items Requiring Special Attention

- The VIEW (RSView32) module application defined in a V2.7 project will not be
converted.
- After converting the project, perform [Remake All] for all the model applications.
- User modules are not converted. Moreover, a program change may be necessary in
order to use a V2.7 user module program on V3.*.

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-7

5.2. OmegaLand Utility

The OmegaLand Utility is used for checking the installation information and basic
settings of the OmegaLand software as well as for changing the settings.
Some functions may be unavailable depending on the user.

5.2.1. Start

The OmegaLand Utility is started from the Start menu.

Windows Explorer can be started by selecting [Start] - [OmegaLand V3] - [Tools].
Right-click on the “OmegaLand Utility” shortcut in the started folder, select “Run as
administrator” from the displayed menu and start it.

Figure 5.2-1 Utility shortcuts

Information

When you right-click on the OmegaLand Utility and start with the “Open” menu (or
starting by double click), it will be started in the reference mode. In this case you can
check the settings, but you cannot modify them.

V3-ML-1001E 9th Edition : Jul. 2023

5-8

The following five types of tab sheets are available; and the desired function can be
selected from the menu on the left side of the tool.
- Basic Setting
- Advanced Setting
- License Change
- Maintenance
- Version Information

The figure below is the window image of the “Basic Setting” tab sheet displayed when
starting.

Figure 5.2-2 OmegaLand Utility Window (Start Image)

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-9

5.2.2. Basic Setting

Displays the basic setting items for OmegaLand software operation.

After updating the item, click the [Apply] button to apply the update contents.

Figure 5.2-3 “Basic Setting” Window

The following items are displayed.
Table 5.2-1 "Basic Setting" Items
Categories Items: Descriptions
Common Master PC:
Specify the computer name or IP address of the Master PC (the PC on which the
license key is installed). The setting is not required if the PC is the Master PC.
VMSpace Base Communication Port:
Specify the start number of the port used for VMSpace communication.
Up to 100 ports can be used depending on the system size.
Do not share project folder in distributed environment:
When the Windows shared folder cannot be used in the network environment, insert
a  and specify the distributed project and its path.
In this case, there will be restrictions such as the inability to edit after distribution
specifications.
Execution Restrain Auto Execution of Application:
Options By inserting a , projects with “Auto Start” will not start automatically. This is
effective for starting a simulation when there is no other company’s system in the
debug environment or the like, and when the connection function cannot be started.
Execute Simulator in Standalone:
Insert a  to start up without connecting to distributed PCs. This is effective for
starting a simulation when there are no distributed destination PCs in the debugging
environment and the like.

V3-ML-1001E 9th Edition : Jul. 2023

5-10

5.2.3. Advanced Setting

Displays setting items that do not need to be changed in normal use.

After updating the item, click the [Apply] button to apply the update contents.

Figure 5.2-4 "Advanced Setting" Window

The following items are displayed.

Table 5.2-2 "Advanced Setting" Items
Categories Items: Descriptions
Log Information Log File Max Size:
Specify the upper limit of the log file size in MB.
Log files that exceed the upper limit are automatically saved as old files with a
different name, and new log files are created.
Keeping Log File Count:
Specify the maximum number of log files to be stored, including the above old
files.
Number of Digits Displayed after the Decimal Point of the Simulation Time:
Specify the number of digits of the simulation time in seconds to record after
the decimal point.
VMSpace Maximum Number of Registered Unit Names:
Specify the maximum number of units that can be registered in VMSpace.
Maximum Number of Registered Variable Names:
Specify the maximum number of variables that can be registered in VMSpace.

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-11

5.2.4. License Change

Displays the currently set OmegaLand license information.

After updating the item, click the [Apply] button to apply the update contents.

Figure 5.2-5 “License Change” Window

The following items are displayed.

Table 5.2-3 "License Change" Items
Items Descriptions
License Code: For changing the license code, such as when adding functions or extending the
expiration date.
License Code2: For changing the license code 2, such as when adding functions or extending the
expiration date.
Network License For changing the server PC of the network license.
Server PC:

V3-ML-1001E 9th Edition : Jul. 2023

5-12

5.2.5. Maintenance

Displays the execution buttons for the OmegaLand maintenance tools.

Figure 5.2-6 “Maintenance” Window

The following maintenance tools can be used.

・Information Collection
This function collects the common system information such as the operating
environment and network settings of the PC on which OmegaLand is running. It
also collects the execution logs of a specific simulation project as needed.
・Log Viewer
OmegaLand collects the following three types of logs recorded during execution.
“Simulation log” “Operation log” and “Graphic log”
・Cleaning
This function resets and cleans up the OmegaLand executing environment.
When the OmegaLand software cannot operate for some reason, it is used for the
purpose of to forcibly stopping all OmegaLand programs and to clear the startup
environment so that OmegaLand can be restarted.

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-13
 Information Collection
Selecting the [Information Collection] button opens the startup confirmation dialog.
Press the [Yes] button to start the information collection tool.

Figure 5.2-7 Information Collection Tool Startup Confirmation

First, specify whether to collect log information of the simulation project at the same
time.

Figure 5.2-8 Simulation Log Collection Setting

If the [Yes] button is selected, a dialog for selecting a project for log collection will be
displayed.
If the [No] button is selected, the information collection process will start immediately.

Figure 5.2-9 Simulation Project Selecting

V3-ML-1001E 9th Edition : Jul. 2023

5-14
The “Project.sim” file is located at the top of the applicable project folder. Select
this file and click the [Open] button.
The information collection process will begin immediately. When the process is
completed, the following dialog will appear and the file “OmlInfo_****.cab”
containing the collected information will be notified.

Figure 5.2-10 Information Collection Complete

Information

In the event when an abnormal condition occurs while using OmegaLand, this function
is used to obtain the information needed to analyze the cause and take necessary
countermeasures.
Please send the two types of cabinet files (***.cab) obtained using this function to our
user support (Refer to “6.5. Support for Users”) along with the problem occurrence
information.

Note

As mentioned above, the collected information is created on the desktop with the file
name “OmlInfo_{creation date}.cab. If the information collection operation is
executed multiple times on the same day, the previously created file will be overwritten.
Therefore execute this after changing the file name as required.

 Log Viewer

 Simulation Log／ Operation Log

Since the log reference method is the same, only the reference example of the simulation
log is explained here.
Click the [Simulation log] button to display the execution confirmation dialog.

Figure 5.2-11 Log Viewer Execution Confirmation

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-15
By clicking the [Yes] button, the dialog for selecting the simulation project to be
referenced is launched.

Figure 5.2-12 Simulation Project Selecting

When selecting the target simulation project, select the reference date, since the
simulation logs saved in the project will be listed.

Figure 5.2-13 Log Selecting

Select the simulation log you want to refer to and click the [OK] button and the log
viewer window will be displayed.

V3-ML-1001E 9th Edition : Jul. 2023

5-16

Figure 5.2-14 Log Viewer Window

Refer to the operation log information in the same procedure.

 Graphic Log
Click the [Graphic log] button to display the execution confirmation dialog. By clicking
the [Yes] button, the tool is launched.

Figure 5.2-15 Log Viewer Execution Confirmation

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-17

The log viewer window will be displayed as follows.

Figure 5.2-16 Graphic Log Viewer Window

For details about the operation method refer to the “V3-ML-1023E: OmegaLand
GRAPHIC Runtime User’s Manual” “1.4 Accessing GRAPHIC Runtime” - “Accessing
log files” item.

 Cleaning

Click the [Cleaning] button to display the execution confirmation dialog.

Figure 5.2-17 Execution Confirmation Dialog

Select “Yes” and a command prompt screen will be displayed and the cleaning process
will start.

V3-ML-1001E 9th Edition : Jul. 2023

5-18

Figure 5.2-18 Display on Cleaning

When the cleaning process is completed, “Press enter key ...” is displayed.
Pressing the “enter” key deletes the command prompt screen and ends the process.

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-19

5.2.6. Version Information

The version information of the currently installed OmegaLand software and the
information of the patched programs are displayed.

Figure 5.2-19 Version Information Window

The following items will be displayed.

Item Description
Product Product name (always OmegaLand)
Version Version number
Platform Product platform (64-bit / 32-bit)
Language Language used
Copyright Copyright notice
Installation Date Installation date and time
Patch Patch information (updated each time a product patch is applied)
Patch (Number) Patch number
Installation date Installation date and time
Function name Patch target function name

V3-ML-1001E 9th Edition : Jul. 2023

5-20

5.3. Manual Reference Tool

All OmegaLand manuals can be referred to using the manual reference tool.
Start from the start menu.

Figure 5.3-1 Start Menu

Select [START] - [OmegaLand V3] - [Manuals], and the following window will be
displayed.

Figure 5.3-2 Manual Reference Tool

V3-ML-1001E 9th Edition : Jul. 2023

 5. Tools and Utilities Outline 5-21

Manuals are classified and displayed into the following four categories.
- User’s Guide
- Tutorial
- Reference
- License Agreement

Select the manual to be referred to, and the corresponding manual will be displayed

Note

All OmegaLand manuals are in PDF format. Even when launched from this tool, they
will be opened with the application linked to the pdf extension on your PC.

Information

The manuals displayed by the tool will change depending on the installed product
platform (32bit / 64bit).
Also, manuals for features that are not licensed for use are grayed out and cannot be
displayed.

V3-ML-1001E 9th Edition : Jul. 2023

5-22

5.4. Other Tools

For other tools displayed in the Windows Explorer started from [OmegaLand V3] >
[Tools], refer to each individual manual.

 GRAPHIC Builder
Starting from here, and not from the main UI, you can create graphic applications that
do not belong to individual simulation projects. The created applications can be
incorporated into any of the simulation projects later.
For details on how to use GRAPHIC Builder refer to “V3-ML-1022E: OmegaLand
GRAPHIC Builder User’s Manual”.

 GRAPHIC Utility
For details on how to use GRAPHIC Utility refer to “V3-ML-1022E: OmegaLand
GRAPHIC Builder User’s Manual” “3.13 Graphic Utility Tool Operation”.

 ITF Namelist Engineering Tool

The parameter list for narrowing down the operation target parameters of the instructor
function is called Namelist, and the tool that creates this list is “ITF Namelist
Engineering Tool”.
For usage details, refer to the “ITF Namelist Engineering Tool Reference” that is
launched from the button at the bottom left of the tool start window.

 OmegaLand Launcher
This is a tool to register OmegaLand applications and start them as training sets.
For usage details, refer to “OmegaLand Instructor Function User’s Guide” “6.
OmegaLand Launcher”.

V3-ML-1001E 9th Edition : Jul. 2023

 6. Help and Support 6-1

6. Help and Support

6.1. OmegaLand Help

Each application function of OmegaLand provides a set of manuals to serve as the help
function; and these manuals can be referenced at any time on PCs on which OmegaLand
is installed.

Note

All OmegaLand manuals are in PDF format. Adobe Acrobat Reader is required in order
to view the manuals. Refer to “2.4.3 Installation of Adobe Acrobat Reader” in this
document for details.

The OmegaLand manuals can be accessed in the following three ways:

 Start menu
All the manuals related to the OmegaLand product can be accessed.
The manual reference tool is executed when [OmegaLand V3] > [Manuals] is
selected in the Start menu. Open the target document by selecting the desired
manual.

 Simulation view in the main UI

The references materials for referencing the functional specifications of individual
products can be accessed.
The manual can be accessed by right-clicking the application function name in the
simulation view and selecting [Reference]. If the function supports multiple
manuals, select the applicable manual from the submenu that expands from
[Reference].

 [Help] menu in each application function

The reference materials for referencing the functional specifications of individual
products can be accessed.
The manual can be accessed by selecting [Help] > [Reference] in the menu bar of
each application function. Since the model function (standalone Visual Modeler)
supports multiple manuals, another dialog for selecting from the applicable
manuals will appear.

V3-ML-1001E 9th Edition : Jul. 2023

6-2

6.2. Log Information

Each application function of OmegaLand successively records the user operations and
events that occurred during the operation as log information. The types of supported log
information vary depending on the function, and the support information is displayed for
each type in the log information output window of each function. The log information
output window of the main UI collects and displays the log information that have been
output for each function.
The log information is categorized into the following types.
 Summary
It outputs the normal operation log including the current running and operating
conditions in a user-friendly manner.
 Operation log
It outputs the history of operations performed by the operator or instructor. It only
records variable operations. Operations such as opening and closing of windows
are not recorded.
 Process alarm
It displays and records the alarms output by an external system via the external
connection function.
 System log
It displays and logs the system errors and events that have occurred while
executing an application.
 Error log
It contains editing errors and syntax errors that occurred while building the
application and is used for verification purposes during the engineering work. It is
processed for each application function and is therefore not transferred to the main
UI.
 Execution log
It is used as a reference when debugging a calculation error that occurred while
executing a built application. It is processed for each application function and is
therefore not transferred to the main UI.

V3-ML-1001E 9th Edition : Jul. 2023

 6. Help and Support 6-3

6.3. Troubleshooting
The following introduces the methods for recovery and collecting information for
analysis in the event when an abnormal condition occurs while using OmegaLand.

 Recovery method
[Maintenance] > [Cleaning] can be started from the OmegaLand Utility.
This function can be used to initialize the startup environment of OmegaLand.
Refer to the “Cleaning” page of “5.2.5. Maintenance” for details on how to start the
function.

Note

Since all running programs related to OmegaLand will be reset, the ongoing data will
not be saved. Therefore, exercise due caution when starting [Cleaning].

 Information collection
Information regarding the software operating environment and the projects used can be
collected using a function of the OmegaLand Utility.
Refer to the “Cleaning” page of “5.2.5. Maintenance” for details on how to start the
function.
The collected information is compressed in the cabinet file (***.cab) format. Please
inform our user support (See the chapter “6.5. Support for Users”) of the problem
occurrence in as much detail as possible and send in the relevant cabinet files.

V3-ML-1001E 9th Edition : Jul. 2023

6-4

6.4. Anti-virus Software

In order to use OmegaLand, it is necessary to set an exception so that communication to

the following modules is not restricted by the firewall function. Below is a list of
modules that are registered as exceptions to Windows Security when installing the
OmegaLand software.

{install_top_folder}\vmspace\connect\bin\{x64|x86}\OmlVmsCon.exe
{install_top_folder}\cnn\bin\{x64|x86}\OmlConSvr.exe
{install_top_folder}\itf\bin\{x64|x86}\OmlItf.exe
{install_top_folder}\itf\bin\{x64|x86}\OmlItfGraphicReplayRuntime.exe
{install_top_folder}\itf\bin\{x64|x86}\OmlItfLauncher.exe
{install_top_folder}\itf\bin\{x64|x86}\OmlItfRunTime.exe
{install_top_folder}\itf\bin\{x64|x86}\OmlLauncher.exe
{install_top_folder}\itf\bin\{x64|x86}\OmlV3StConf.exe
{install_top_folder}\itf\bin\{x64|x86}\OmlV3StExec.exe
{install_top_folder}\graphic\bin\{x64|x86}\GFSWindowsService.exe
{install_top_folder}\graphic\bin\{x64|x86}\OTSGraphicAPIService.exe

If the use of antivirus software cannot be avoided on your system, make exception
settings for these modules. For specific setting methods, refer to the manual of your
anti-virus software.

Note

Note that depending on the system, the performance of some OmegaLand functions may
be affected if the real-time scanning function of the antivirus software installed on the
PC is enabled.

V3-ML-1001E 9th Edition : Jul. 2023

 6. Help and Support 6-5

6.5. Support for Users

 Inquiry by E-mail
E-mail inquiries are welcome. If required, attach any files that can be helpful for us to
support you.
We will reply by E-mail in most cases. But please send us your telephone and fax
numbers also, for cases when contact by E-mail is difficult.

 Inquiry by telephone
We can also provide our support by telephone in case of emergency or serious problems
while you are installing or using the machine. It would be advisable that you make a
brief note of your problems before calling us.

 Support contact point

2-20-9 Nishi-Waseda, Shinjuku-ku, Tokyo 169-0051 Japan
Sales Department, Omega Simulation Co., Ltd
TEL: 81-3-3208-4921
FAX: 81-3-3208-4911
E-mail: [email protected]

 Support service hours

From Monday through Friday, 10:00 a.m. to 5:30 p.m.
(Closed on national, end of year, and New Year holidays)

V3-ML-1001E 9th Edition : Jul. 2023

6-6

V3-ML-1001E 9th Edition : Jul. 2023

◆Revision Record
● Manual No. : V3-ML-1001E
● Title : OmegaLand Getting Started Guide

Dec. 2016/1st Edition/V3.1

New Version

Aug. 2017/2nd Edition/V3.1SP2

Correction of errors
Revised edition based on the version upgrade

Nov. 2017/3rd Edition

Descriptions of the additional support software
Correction of errors

Jan. 2018/4th Edition/V3.2

Correction of errors
Revised edition based on the version upgrade

Jun. 2019/5th Edition/V3.3

Introduction: Revision of the manual list
P.2-7: Revision of the software environment
P.2-18: Selection page of the platform of the install production is added.
P.3-6: Introduction of Unified Main UI is added.
P.5-7 – P.5-19: The specifications of OmegaLand Utility are modified.
P.5-20, P.5-21: The description of the manual reference tool is added.
Correction of errors
Revised edition based on the version upgrade

Feb. 2020/6th Edition/V3.3.0.1

P.2-7: Revision of the software environment
(Support termination of Windows 7 / Windows Server 2008)
P.2-12, P.2-13: Newly supporting of Visual C++ 2019
P2-15 – P2-23: Revision of the installation procedure
Addition of the prerequisite software
Correction of errors
Revised edition based on the version upgrade

Sep. 2020/7th Edition/V3.4

P.2-7: Revision of the software environment
Support addition of Windows 10 Enterprise 2019 LTSC,
and Windows Server 2019 Standard
P.2-32: Addition of [Remake All] processing in the procedure of the testing of
OmegaLand
 P.5-19: The product platform information is added in the version information
tab sheet of OmegaLand Utility.
P.6-4: Addition of “Chapter 6.4 Anti-virus Software”

Jul. 2021/8th Edition/V3.5

P.2-6: Revision of the RAM size (2GB to 4GB), and free space size of the hard disk
(1GB to 2GB)
P.2-6: Addition of the note about the virtual memory size
P.2-7: Revision of the software environment
(Support termination of Microsoft VC++ 2013, Microsoft Excel 2010/2013)
P.2-17, P2-19, P.2-20: Revision of the description of the installation dialog on the
prerequisite software
P.2-28: Addition of the notes in case of using the network license
P.2-29 – P.2-34: Addition of the descriptions in the “Testing of Installed OmegaLand”
section
Correction of errors
Revised edition based on the version upgrade

Jul. 2023/9th Edition/V3.6

P.2-4: Addition of “V3-ML-3016E: Visual Modeler IBD Unit Model Reference” into
the manual list
P.2-7: Addition of description for “Virtualization System Environment”
P.2-7, P.2-12, P.2-13: Revision of the software environment
Newly support of Microsoft Windows 11 Pro (64bit)
Newly support of Microsoft Visual Studio Professional 2022 Visual C++
Newly support of Microsoft Excel 2021
P.2-13: Addition of support of the Excel 64-bit version
P.2-17: Addition of description for the installer version
P.2-29 – P.2-30: Addition of the testing for the case of “VM-EQUATRAN” the newly
supported functions.
P.4-9: Change mnemonic character (u to A) for selecting “Auto” start type in the
Application properties dialog

2-20-9 Nishi-waseda
Shinjuku-ku, Tokyo 169-0051 Japan
Tel: 81-3-3208-4921 Fax: 81-3-3208-4911
http://www.omegasim.co.jp

V3-ML-1001E (09)