You are on page 1of 146

Copyright © 2006 Engineous Software, Inc. All rights reserved.

Engineous Software, Inc. retains all ownership rights to the iSIGHT-FD computer program and its
documentation. Use of iSIGHT-FD software is governed by the license agreement accompanying your
original media. The iSIGHT-FD source code is a confidential trade secret of Engineous Software, Inc. You
many not attempt to decipher, decompile, develop, or otherwise reverse engineer iSIGHT-FD software, or
knowingly allow others to do so.

No part of this document may be reproduced or transmitted in any form or by any means, electronic or
mechanical, for any purpose, without the express written permission of Engineous Software, Inc.

Engineous Software, Inc. provides this publication “as is” without warranty of any kind, either expressed
or implied, including but not limited to the implied warranties or conditions of merchantability or fitness
for a particular purpose. In no event shall Engineous Software, Inc. be liable for any loss of profits, loss of
business, loss of use or data, interruption of business, or for indirect, special, incidental, or consequential
damages of any kind, even if Engineous Software has been advised of the possibility of such damages
arising from any defect or error in this publication or in the iSIGHT-FD software.

Engineous Software, Inc. may revise this publication at any time without notice. Some states or
jurisdictions do not allow disclaimer of express or implied warranties in certain transactions; therefore,
this statement may not apply to you.

Printed in the United States of America.

Document Version 2.5, December 2006

FIPER is a registered trademark of Engineous Software, Inc.

iSIGHT is a trademark of Engineous Software, Inc.


Additional Trademarks:

Windows is either a registered trademark or trademark of Microsoft Corporation in the United States and/
or other countries.

AIX is a registered trademark of IBM Corporation.

HP and Hewlett-Packard are registered trademarks of Hewlett-Packard Company.

Red Hat and RPM are either a registered trademark or trademark of Red Hat, Inc.

Sun and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc.

UNIX is a trademark of UNIX Systems Labs.


FLEXlm is a registered trademark of Macrovision.
Mozilla is a trademark of The Mozilla Organization.

Netscape is a trademark of Netscape Communications Corporation.

Adobe Reader is a registered trademark of Adobe Systems Incorporated.

All other product names mentioned herein are the trademarks of their respective owners.
3

Table of Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
What is iSIGHT-FD?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
The iSIGHT-FD Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Design Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Runtime Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Command Line Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Using This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9


Other Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Conventions Used in This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Mouse Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Keyboard Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Contacting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
United States and North America . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Japan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Korea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Germany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
United Kingdom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
France . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Send Us Your Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

iSIGHT-FD Runtime Gateway Guide


4 Table of Contents

1 Using the Runtime Gateway Interface . . . . . . . . . . . . . . . . . . . . . . 15


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Using the Runtime Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Accessing the Runtime Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Understanding Connection Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Loading a Model From the Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Loading a Model From the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Understanding the Runtime Gateway Layout. . . . . . . . . . . . . . . . . . . . . . . . . . 22
Controlling Execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Overview of the Available Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Setting Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Working With Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36


Opening a Job From a Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Stopping Running Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Re-executing Failed Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Creating Custom Job Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Selecting Loaded Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Removing Jobs From Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Setting Job Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Deleting Jobs from the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Setting Workflow Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49


Viewing/Hiding Annotations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Saving the Workflow Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Using the Component Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Understanding Graph and Table (Visuals) Options. . . . . . . . . . . . . . . . . . . . . . . . . 51


Viewing Parameter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Understanding the Parameters Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Setting Viewed Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Viewing Optimization Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Viewing DOE Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Viewing Monte Carlo Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Using the History Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Viewing the Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

iSIGHT-FD Runtime Gateway Guide


Table of Contents 5

Using the Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64


Viewing the Log Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Accessing the Log File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Viewing the Dataflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68


Executing a Model or Component from the Runtime Gateway . . . . . . . . . . . . . . . . 69
Saving Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Creating an ACS Connection Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

2 Using Graphs, Tables, and Visualization Tools . . . . . . . . . . . . . . . 75


Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Using Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Creating a Graph for a Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Using Specialized Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Updating an Existing Graph. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Changing Graph Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Viewing Graph Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Exporting Graph Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Copying a Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Normalizing a Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Deleting Graphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Using Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Creating a Table for a Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Updating an Existing Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
Viewing Table Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
Customizing a Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
Exporting Table Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Copying Table Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
Deleting Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

Using the Correlation Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107


Accessing the Correlation Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Viewing the Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
Working with the Filter Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111

iSIGHT-FD Runtime Gateway Guide


6 Table of Contents

Using the Engineering Data Mining Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113


Accessing EDM from the Runtime Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Starting EDM in Standalone Mode and Selecting Data . . . . . . . . . . . . . . . . . . 117
Viewing the Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Changing the Selected Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Viewing and Manipulating Scatter Plots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124

3 Runtime Gateway Reference Information . . . . . . . . . . . . . . . . . . . 129


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Run Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Window Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Help Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

Toolbar Buttons and Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135


Setting Options in the Runtime Gateway File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Keyboard Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Runtime Gateway Keyboard Shortcuts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Using Keyboard Shortcuts on HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

iSIGHT-FD Runtime Gateway Guide


7

Preface

This book is your guide to using the iSIGHT-FD Runtime Gateway for viewing and
interpreting results. Read on to find out more about iSIGHT-FD and how to use this
book.

What is iSIGHT-FD?
iSIGHT-FD is a a service-oriented product development environment, which provides
an open, flexible means to incorporate existing analysis and design tools/methods and
make them available to others. It also provides a common, standard way to model your
analysis and design process in conjunction with your product data.

The iSIGHT-FD Interfaces


iSIGHT-FD has several main interfaces, which help facilitate collaboration and
product development.

iSIGHT-FD Runtime Gateway Guide


8 Preface

Design Gateway
This interface is the main iSIGHT-FD interface. It allows you to create models,
manipulate components, and perform other functions associated with model design and
development. For more information on this interface, refer to the iSIGHT-FD User’s
Guide.

Runtime Gateway
This interface allows you to control execution and view results. It lets you create
graphs and tables, view parameter information, and resubmit models for execution. For
more information on the Runtime Gateway, continue reading this book.

Components
Components are used as building block for models. Excel, Data Exchanger, and
Optimization are examples of some of the components that Engineous Software has
developed and can be included with iSIGHT-FD. You can also develop your own
components to use within the iSIGHT-FD environment. For more information on using
Engineous-provided components, refer to the iSIGHT-FD User’s Guide. For more
information on creating custom components, refer to the iSIGHT-FD Development
Guide.

Command Line Client


The Command Line Client is a console (character mode) program that provides simple
text-based access to iSIGHT-FD. For more information on this interface, refer to the
iSIGHT-FD User’s Guide.

iSIGHT-FD Runtime Gateway Guide


Using This Book 9

Using This Book


This book assumes you are familiar with your operating system and its commands; the
definition of directories; the management of user accounts and security access; and
your network protocol and its configuration.

This book contains the following information:

„ Chapter 1 “Using the Runtime Gateway Interface”

„ Chapter 2 “Using Graphs, Tables, and Visualization Tools”

„ Chapter 3 “Runtime Gateway Reference Information”

Other Documentation
„ iSIGHT-FD Development Guide

„ iSIGHT-FD Getting Started Guide

„ iSIGHT-FD User's Guide

iSIGHT-FD Runtime Gateway Guide


10 Preface

Conventions Used in This Book


The following sections describe the typographic terminology and other conventions
used in this book.

Typographical Conventions
This book uses the following typographical conventions:

Convention Explanation
italics Introduces new terms with which you may not be familiar,
and is used occasionally for emphasis.
bold Emphasizes important information. Also indicates button,
menu, and icon names on which you can act. For example,
click Next.
UPPERCASE Indicates the name of a file. For operating environments
that use case-sensitive filenames (such as UNIX), the
correct capitalization is used in information specific to
those environments.
Also indicates keys or key combinations that you can use.
For example, press the ENTER key.
monospace Indicates syntax examples, values that you specify, or
results that you receive.
monospaced Indicates names that are placeholders for values that you
italics specify. For example, filename.
forward slash / Separates menus and their associated commands. For
example, Select File / Copy means that you should select
Copy from the File menu.
The slash also separates directory levels when specifying
locations under UNIX.
vertical rule | Indicates an “OR” separator used to delineate items.

iSIGHT-FD Runtime Gateway Guide


Conventions Used in This Book 11

Convention Explanation
brackets [ ] Indicates optional items. For example, in the following
statement: SELECT [DISTINCT], DISTINCT is an
optional keyword.
Also indicates sections of the Windows Registry.
braces { } Indicates that you must select one item. For example, {yes |
no} means that you must specify either yes or no.
ellipsis . . . Indicates that the immediately preceding item can be
repeated any number of times in succession. An ellipsis
following a closing bracket indicates that all information in
that unit can be repeated.

Mouse Conventions
This action... Means to...
Click Point to an object with the mouse pointer and momentarily
press the left mouse button.
Double-click Press the left mouse button twice.
Right-click Momentarily press the right mouse button.
Drag Press and hold the left mouse button while dragging item(s)
to another part of the screen.
SHIFT+Click Click an object to select it; then, press and hold the SHIFT
key. Click another object to select the intervening series of
objects.
CTRL+Click Press and hold the CTRL key; then, click a selection. This
lets you select or deselect any combination of objects.

Keyboard Conventions
Select menu items by using the mouse or pressing ALT+ the key letter of the menu
name or item.

iSIGHT-FD Runtime Gateway Guide


12 Preface

Supported Platforms
For complete details on the supported platforms for iSIGHT-FD v2.5, refer to the
following website:

http://www.engineous.com/iSIGHT-FDv2.5platforms.pdf

Contacting Technical Support


iSIGHT-FD technical support is available to answer your technical questions. Contact
the appropriate office listed below, based on your region. When contacting technical
support regarding a problem, please provide the following information:
„ Detailed explanation of the problem

„ Screen captures

„ Copies of logs

United States and North America


Telephone
Calling from within the United States 800-374-9235
Calling from outside the United States 919-677-6700
E-mail support@engineous.com

Japan
Telephone
Calling from within Japan 045.477.3300
Calling from outside Japan 81.45.477.3300
E-mail tech@engineous.co.jp

iSIGHT-FD Runtime Gateway Guide


Send Us Your Comments 13

Korea
Telephone 82.2.3473.5784/5785

Germany
Telephone 49.(0)89.580.088.60

United Kingdom
Telephone 44.115.8759301

France
Telephone 33.0.1.46.91.83.56

Send Us Your Comments


Engineous Software welcomes your comments regarding the iSIGHT-FD
documentation, including hardcopy documentation, PDFs, and online help. Your input
is very valuable in the revision and enhancement process.

If you have suggestions for improvement, or wish to point out specific errors, please
send your comments to:

documentation@engineous.com

You may also send your comments to our mailing address:

Documentation Suggestions
Engineous Software

iSIGHT-FD Runtime Gateway Guide


14 Preface

2000 CentreGreen Way, Suite 100


Cary, NC 27513

If you would like a response, please provide the following information:

„ Name
„ Title
„ Company
„ Address
„ Telephone number
„ Email address

iSIGHT-FD Runtime Gateway Guide


15

1 Using the Runtime Gateway


Interface

This chapter discusses using the different options available in the Runtime Gateway,
including the interface layout and non-visual options. Information on graphs and tables
is provided in a separate chapter. This chapter is divided into the following sections:

„ “Introduction,” on page 16
„ “Using the Runtime Gateway,” on page 16

„ “Working With Jobs,” on page 36

„ “Setting Workflow Options,” on page 49

„ “Understanding Graph and Table (Visuals) Options,” on page 51

„ “Viewing Parameter Information,” on page 51

„ “Viewing the Summary,” on page 63


„ “Using the Logs,” on page 64

„ “Viewing the Dataflow,” on page 68

„ “Executing a Model or Component from the Runtime Gateway,” on page 69

„ “Saving Results,” on page 69

„ “Creating an ACS Connection Profile,” on page 72

iSIGHT-FD Runtime Gateway Guide


16 Chapter 1 Using the Runtime Gateway Interface

Introduction
In general, the Runtime Gateway provides execution control and monitoring options
for a model, and displays execution related information. Components are selected from
the list on the left side of the interface, and their corresponding information is
displayed on several tabs provided on the right side of the interface. You can use this
list of components to change between components at any time, for both information
viewing and execution purposes. You can also use the Runtime Gateway to control
execution in various ways.

The Runtime Gateway is typically used in the following two configurations:

„ It automatically appears when a model is executed from the Design Gateway.

„ It can be opened as a separate interface, and it can execute models that already
exist (meaning they have already been created using the Design Gateway) and are
saved to disk or have been published.

Each of these configurations provides access to the same options. The main difference
is the way that the interface is initially accessed.

Note: Altering the graphs and tables on the Runtime Gateway changes the composition
of the model. Changes made to parameters using the Parameters tab on the Runtime
Gateway affect the model. All other changes are specific to the Runtime Gateway and
do not affect the model.

Using the Runtime Gateway


As stated, the Runtime Gateway is an interface that helps you control execution and
view results of that execution. The interface can be accessed at any time in order to run
existing models, and automatically appears when an execution is started from the
Design Gateway.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 17

This section is divided into the following parts:

„ “Accessing the Runtime Gateway” on this page

„ “Understanding Connection Profiles,” on page 18

„ “Loading a Model From the Interface,” on page 19

„ “Loading a Model From the Command Line,” on page 21


„ “Understanding the Runtime Gateway Layout,” on page 22

„ “Controlling Execution,” on page 24

„ “Overview of the Available Tabs,” on page 27


„ “Setting Preferences,” on page 29

Accessing the Runtime Gateway


There are three methods for accessing the Runtime Gateway:

„ Executing a model from the Design Gateway. For more information, refer to the
iSIGHT-FD User’s Guide. This option opens the Runtime Gateway, loads the
model currently open in the Design Gateway, and executes the model.
„ Accessing the Runtime Gateway option from the Design Gateway View menu.
This option opens the Runtime Gateway with the current model loaded, but does
not execute the model. For more information on loading a model, see “Loading a
Model From the Interface,” on page 19.

„ Opening the model as a separate interface. You have two options for opening the
interface separate from the Design Gateway:

„ Windows only: Click the Start button; then, point to Programs / iSIGHT-FD
2.5 and click Runtime Gateway.

„ Execute the rt_gateway.exe file (or rt_gateway file on UNIX/Linux


systems) located in the <isight-fd_install_directory>\bin\win32 directory (or
the <isight-fd_install_directory>/bin directory on UNIX/Linux). When using
this option, you also have access to several command line options that can
control the start of the program. For more information, see “Loading a Model
From the Command Line,” on page 21.

iSIGHT-FD Runtime Gateway Guide


18 Chapter 1 Using the Runtime Gateway Interface

Understanding Connection Profiles


Connection profiles allow you to determine the type of environment you will use for
your iSIGHT-FD session. By default, iSIGHT-FD is run in the Standalone connection
profile. However, if you have access to an ACS in the FIPER environment, you can use
connection profiles to connect to a specific ACS. Numerous ACS machines can be
defined, but you can only connect to one ACS at a time.

When you start an iSIGHT-FD interface, the Logon dialog box appears, allowing you
to determine your session environment.

The following two types of connections are available:

„ Standalone. This option, available at any time whether you have access to an ACS
in the FIPER environment or not, connects you to the local Library on your current
machine, and does not establish a connection with an ACS. This connection profile
is provided, by default, with iSIGHT-FD and does not need to be created.

„ FIPER ACS Connection. This option connects you to an ACS in the FIPER
environment, and provides access to a remote Library. It also requires you to enter
your user name (user ID) and password, if security is enabled on the ACS.

If you do not see a connection profile that corresponds to the correct ACS machine,
you can create the necessary connection profile as described in “Creating an ACS
Connection Profile,” on page 72.

Note: Although you may have multiple connection profiles defining connections to
multiple systems acting as an ACS, you can only actually connect to one ACS at a
time.

For more information on configuring an ACS, refer to the FIPER Installation and
Configuration Guide that matches your ACS combination.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 19

Loading a Model From the Interface


If you execute a model from the Design Gateway, it is automatically loaded into the
Runtime Gateway and executed. However, if you launch the Runtime Gateway either
from the Design Gateway View menu, or as a standalone interface, you need to specify
the model you want to use.

When loading a model into the Runtime Gateway, only the model information itself is
loaded. No job information (such as parameter values or results) is loaded. However,
you can load a model and job information if you have a connection to a job database.
When you select a specific job, the associated model is automatically opened in the
Runtime Gateway. For more information, see “Opening a Job From a Database,” on
page 37.

Note: If you use the rt_gateway.exe file (rt_gateway file on UNIX) to start the Runtime
Gateway, you can specify a model at the command prompt. For more information, see
“Loading a Model From the Command Line,” on page 21.

The following options are available from the Runtime Gateway File menu:

„ “Opening a Model From the Disk” on this page


„ “Opening a Model From a Library,” on page 20

Opening a Model From the Disk


To open a model from the local hard drive:

1. Select Open from Disk... from the Runtime Gateway File menu. The Open dialog
box appears.
2. Navigate to the model; then, click it to select it.

3. Click Open. The model is loaded into the Runtime Gateway.

iSIGHT-FD Runtime Gateway Guide


20 Chapter 1 Using the Runtime Gateway Interface

Opening a Model From a Library


Models opened from a Library must first be published to the Library. For more
information on publishing models, refer to the iSIGHT-FD User’s Guide.

To open a model from the current Library:

1. Select Open from Library... from the Runtime Gateway File menu.
The Library dialog box appears.

2. Navigate to the model you want to use; then, click it to select it. If you cannot
locate the correct model, verify that you are connected to the proper Library, or
contact the individual who published the model for more information.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 21

In the following example, the I-beam example model has been selected.

3. Click Open. The model is loaded into the Runtime Gateway.

Loading a Model From the Command Line


If you launch the Runtime Gateway from a Command Prompt dialog box (Windows)
or a terminal window (UNIX), you can specify the model to be loaded at the time of
the file execution.

Note: The rt_gateway.exe file is located in the <isight-fd_install_directory>\bin\


win32 directory on Windows-based systems. The rt_gateway file is located in the
<isight-fd_install_directory>/bin directory on UNIX-based systems.

For example, the following command opens the Runtime Gateway as a standalone
interface on Windows, and loads the isight-fd_sample model from the local hard drive:
rt_gateway.exe \isight-fd_models\isight-fd_sample

iSIGHT-FD Runtime Gateway Guide


22 Chapter 1 Using the Runtime Gateway Interface

At the same time, the following command opens the Runtime Gateway as a standalone
interface on Windows, and loads the isight-fd_sample model from a machine called
fd_server:
rt_gateway.exe \\fd_server\isight-fd_models\isight-fd_sample

Note: You must have the proper permissions to access machines across a network. For
more information, contact your local system administrator.

For information on additional command line options available with the Runtime
Gateway, see “Setting Options in the Runtime Gateway File,” on page 136.

Understanding the Runtime Gateway Layout


The Runtime Gateway’s layout is shown in Figure 1-1 (with areas labeled).

Figure 1-1. Basic Layout of the Runtime Gateway

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 23

In many respects, the Runtime Gateway very closely resembles the Design Gateway.
However, there are numerous differences. These differences include:

„ Menu Bar. The Runtime Gateway’s menu options are described in “Menu
Options,” on page 130.

„ Tool Bar. The Runtime Gateway has an abbreviated toolbar, as well as numerous
other features related to execution, including the Job Name drop-down list, Run
Counter, and Stop and Pause buttons. For more information on using these options,
see “Using the Runtime Gateway Toolbar Buttons,” on page 26.

„ Job Name Drop-down List. This drop-down list allows you to easily switch
between jobs that have been executed during the current session or loaded from the
Jobs Database. For more information, see “Selecting Loaded Jobs,” on page 42.

„ Tabs. The Runtime Gateway has a different arrangement of tabs compared to the
Design Gateway. For more information on using the tabs, see “Overview of the
Available Tabs,” on page 27.

„ Model Explorer. This feature allows you to navigate between the components that
make up the model. The component selected in this area has its information
displayed in the tabs on the right side of the interface.

„ Graph/Table Explorer. This feature (not shown in the previous figure) is only
available on the Graph tab. It allows you to easily navigate between graphs and
tables on different pages, as well as those tied to different components. It appears
at the bottom of the Model Explorer.

„ Log Button. This button opens the Log Viewer dialog box, which allows you to
view the Design Gateway log file. For more information, see “Accessing the Log
File,” on page 66.

„ Server Information Button. This button provides access ACS connection


information if you are connected to an ACS in the FIPER environment. If you are
using iSIGHT-FD in desktop mode (Standalone connection profile), this button is
disabled. For more information, refer to the iSIGHT-FD User's Guide.

iSIGHT-FD Runtime Gateway Guide


24 Chapter 1 Using the Runtime Gateway Interface

Controlling Execution
There are several ways to control the execution of a model. You can set certain options
immediately prior to execution, you can select which jobs will be executed, and you
can pause or stop execution after it has started.

Model execution is submitted as a job. A job in iSIGHT-FD is the highest unit level of
work. A job consists of a model, optionally some initial data or values, and job control
information, such as logging level. Jobs are identified by a unique ID (generated by the
system when the job is submitted) and a readable job name provided by the user or
generated by the Runtime Gateway. The readable job name does not have to be unique.
A job is created when a model and job control information is submitted to the ACS for
execution, or run locally in the Runtime Gateway. Jobs progress through a series of
states as they execute, until they reach the “Done” state. A job that is done is persisted,
or saved, by the ACS for later analysis. Jobs run locally in the Runtime Gateway may
or may not be saved depending on how the Runtime Gateway is configured.

Note: Jobs are saved into and can be accessed from the ACS. For more information,
see “Opening a Job From a Database,” on page 37.

For more information on these execution controls, see either of the following topics:
„ “Using the Configure and Run Options” on this page. These options allow you to
specify execution information, such as the job name and the logging level, before
execution begins.

„ “Using the Runtime Gateway Toolbar Buttons,” on page 26. These buttons allow
you to pause or stop execution once it has started.

Using the Configure and Run Options


The configure and run options are accessed using the Run button. You can also access
these options using the Run button or Run menu on the Design Gateway. These options
allow you to specify information for the following settings, rather than using the
system defaults:

„ Job name. By default, the job name consists of the file name, the current date, and
the current time.
„ Logging level for the iSIGHT-FD execution log file.
„ Set initial values for parameters on the root component.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 25

To use the configure and run options:

1. Perform one of the following actions:

„ Click the arrow next to the Run button on the Runtime Gateway toolbar;
then, select Configure and Run Model from the menu that appears.
„ Select Configure and Run Model from the Runtime Gateway Run menu.

Note: You can choose to configure and run either the entire model or the selected
component.

The Run Info dialog box appears.

2. Set any of the following options, as desired:

„ Create a custom name for the job using the Job Name text box. Naming the
job may make it easier for you to locate it later for post-processing or
re-execution.
„ Set the log level for the execution using the Logging Level button. For more
information on the definition of the different log levels, refer to the
iSIGHT-FD User’s Guide.

„ Use a Fixed Seed. The seed can be fixed by clicking this check box and
specifying the seed manually in the corresponding text box. If this check box is
not activated, the seed is determined randomly.

iSIGHT-FD Runtime Gateway Guide


26 Chapter 1 Using the Runtime Gateway Interface

„ View component information in the Component Info area. Use the list on the
left side of this area to switch between components. The component
information is displayed on the right side of this area.

„ Change the starting values for unmapped parameters or the configuration for
unmapped file parameters in the Unmapped Input and Local Parameters area
on the right side of the dialog box. New parameter values can be typed directly
in the Value column. File parameter configuration settings can be accessed by
clicking the button in the Value column, which opens the Configure File
Parameter dialog box. For more information on the settings displayed on this
dialog box, refer to the iSIGHT-FD User’s Guide.

„ Use the Write results to database button to turn on/off storing run data to the
database, if you are running iSIGHT-FD locally and the database is configured.

„ Click the Configure From Name-Value File button to set the values of
parameters to an existing Name-Value file.

3. Click OK to execute. The Run Info dialog box is closed, and you are returned to
the Runtime Gateway.

Using the Runtime Gateway Toolbar Buttons


Once you execute a job using the Design Gateway, the Runtime Gateway automatically
appears, showing you the status of the execution. You can control a job’s execution
using the following buttons on the Runtime Gateway toolbar:

„ . Stops the current job. If you stop the run, the icon appears in the Runtime
Gateway toolbar. Components that were already submitted to the FIPER Station
will be executed. The also appears above components that were not executed.

„ . Pauses the current job. Work items that have already been dispatched will
execute, but additional work items will not be dispatched.

„ . Allows you to re-execute a job that stopped or failed during a prior execution,
allowing you to restart the job and resume execution where it left off. This feature
is designed for use when a job was running correctly and was terminated for some
(known or unknown) reason, such as a power failure or something else unexpected.
It is not designed for use with jobs that fail due to configuration problems. For
more information, see “Re-executing Failed Jobs,” on page 40.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 27

After the initial execution, you can select a job to execute again using the Job Name
drop-down list. Simply select the desired job, then click the Run button. For
information on the other toolbar buttons and options, see “Toolbar Buttons and
Options,” on page 135.

Overview of the Available Tabs


This section provides a brief overview of the tabs available on the Runtime Gateway,
and each tab’s usage.

Using the Parameters Tab


The Parameters tab allows you to evaluate the results of parameters in your model’s
components. It displays the input and output parameter values for the most recent
execution. You can select to view information from different runs using the View Run
button at the bottom of the tab. However, you can only view one set of values at a time.
For more information on using this tab, see “Viewing Parameter Information,” on
page 51.

Using the History Tab


The History tab shows parameter values from the execution of a model. It differs from
the Parameters tab in that it shows the values for numerous runs. The number of rows
displayed is based on the number of times the specified component was executed (one
row means a single execution, twenty rows means twenty executions). For more
information on using this tab, see “Viewing Parameter Information,” on page 51.

Using the Graphs Tab


The Graphs tab allows you to use graphs and tables to view execution data. For more
information, see Chapter 2 “Using Graphs, Tables, and Visualization Tools”.

iSIGHT-FD Runtime Gateway Guide


28 Chapter 1 Using the Runtime Gateway Interface

Using the Workflow Tab


The Workflow tab is the initial tab that appears during execution from the Design
Gateway. It shows a copy of the workflow as it appears on the Design Gateway. This
tab also displays the execution progress of each component in the workflow. A flag
appears above each component when it has been successfully executed.

This tab provides you with some options for the individual components. For more
information, see “Setting Workflow Options,” on page 49.

This tab also has the same zoom and pan features as the Design Gateway workflow tab.
For more information on using these options, refer to the iSIGHT-FD User’s Guide.

Using the Dataflow Tab


The Dataflow tab graphically displays how information moves from one component to
the another. By default, this tab is hidden on the Runtime Gateway. You can display it
by selecting Dataflow from the View menu. For more information, see “Viewing the
Dataflow,” on page 68.

Using the Summary Tab


The Summary tab displays a summary containing post-execution information. All
components display basic information, such as execution start time and duration.
However, some components, such as DOE, display more detailed information. For
more information, see “Viewing the Summary,” on page 63.

Using the Logs Tab


The Logs tab displays log information that may be helpful during execution, especially
if an error occurs. For more information, see “Using the Logs,” on page 64.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 29

Setting Preferences
The preferences allow you to set certain default behaviors in the Runtime Gateway and
for select components.

Note: The same preferences are also available from the Design Gateway. Any change
to the preferences accessed from either the Runtime Gateway or the Design Gateway
impacts the other interface. For more information on the Design Gateway, refer to the
iSIGHT-FD User’s Guide.

To access the interface that allows you to set iSIGHT-FD preferences:

1. Select Preferences from the Edit menu. The iSIGHT-FD Preferences dialog box
appears.

2. Proceed to one of the following sections for more information:

„ “Setting Gateway Preferences,” on page 30. This section describes the options
that effect the Gateway (Design and Runtime) including the working directory,
parameter settings, and execution options.

„ “Setting Additional Preferences,” on page 34. This section describes options


such as default Approximation technique, local database settings, and mail
server information.

„ “Setting Component Preferences,” on page 36. This section describes available


component-based preferences.

iSIGHT-FD Runtime Gateway Guide


30 Chapter 1 Using the Runtime Gateway Interface

Setting Gateway Preferences


The Gateway preferences allow you to specify preferences for numerous aspects of the
iSIGHT-FD Gateway (Design and Runtime) including the following:

„ General preferences
„ Parameter options
„ Execution
„ Sounds

To set gateway preferences:

1. Access the iSIGHT-FD Preferences dialog box as described in “Setting


Preferences,” on page 29.

2. Verify that FIPER Gateway is selected on the left side of the dialog box; then, set
the following options as desired:

„ Working Directory. You can specify your default directory, which will be the
default directory when you save or open a component.You can type the full
path directly into the corresponding text box, or you can navigate to the
directory using the Browse... button.
„ Load last open model on start-up. When activated, iSIGHT-FD will
automatically take you to the last model you had open on the Design Gateway.
If this option is not selected, iSIGHT-FD, on start-up, will take you to the
Design Gateway with the default model loaded. The default model is an empty
Task component. For more information on using the Design Gateway, refer to
the iSIGHT-FD User’s Guide.

„ Show dialog when components are added to the palette. When this option is
selected, a verification dialog box appears every time a component is added to
the Design Gateway from the Library. For more information, refer to the
iSIGHT-FD User’s Guide.
„ Default Browser. This option allows you to set the location for your system’s
default web browser. The browser is used for viewing iSIGHT-FD’s online
help. You can type the full path to the browser directly into the corresponding
text box, or you can navigate to the directory using the Browse... button.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 31

„ Create sub directories under model execution directory. When this option
is selected, sub directories are created under the model execution directory
specified in Model Properties. The default is true. For more information on
setting the model execution directory, refer to the iSIGHT-FD User’s Guide.

„ Use default locale as the decimal separator. To support full


internationalization, iSIGHT-FD allows you to control how you want the
decimal to appear throughout the interface. iSIGHT-FD uses the decimal
setting from the locale in which the operating system is currently running by
default. However, if you are running in a locale that uses a “,” for the decimal,
but you still want the decimal to appear as a “.” (or vice-versa), you can
explicitly set the decimal separator to be used with this option. This setting is
useful for globalized organizations who run their computers on different
locales (in different countries), yet want everyone to use a consistent decimal
separator.

3. Click Parameters on the left side of the dialog box; then, set the following options
as desired:

„ Auto copy child parameters to parent. When activated, any parameter added
to a child component (a component within a process component) is
automatically added to the parent component. For example, if a Calculator
component is added within a Monte Carlo component, and a parameter is
added to the Calculator component, the parameter is automatically added to the
Monte Carlo component as well.

„ Auto map matching parameters. This option creates an automatic mapping


between two components that have the same name and comparable properties.
This automatic mapping only occurs if the components are siblings (share the
same parent component) or have a parent-child relationship.

„ Adjust parameter modes for invalid mappings. If this option is selected,


when you manually create a mapping from one parameter to another, if the
parameters have modes that are invalid for mapping, one of the parameters is
automatically adjusted to be an “inout” parameter, making the mapping valid.
For example, if you map from an input parameter of one component to another
input parameter of a component within that workflow, it will change the mode
of the first parameter to be “inout”. In doing so, the first parameter’s value can
be properly mapped to the second component.

„ Type, Value, and Mode drop-down lists. When changes are made to a
parameter that is mapped to/from other parameters, iSIGHT-FD can

iSIGHT-FD Runtime Gateway Guide


32 Chapter 1 Using the Runtime Gateway Interface

automatically adjust the corresponding attributes of the mapped parameters to


maintain consistency. For example, if you change a parameter's datatype from
Real to String, any mappings to/from other Real parameters would be invalid
until those parameters were also changed to Strings. You may also want
corresponding changes made when a value is changed or the mode is changed.
Preferences are available for whether you want iSIGHT-FD to always
automatically make the changes to mapped parameters, never automatically
make the changes (forcing a manual change), or to prompt you before
automatically making changes to allow you to abort the changes.
„ Array Resizability. This drop-down list allows you to determine what
happens to the “Dimensions are resizable” option (available when creating or
editing an array parameter) when you map an array parameter to another array
parameter and the setting of this option doesn't match (i.e., one is a fixed size
and one is resizable). You can decide to always make the two settings match, to
never make them match (essentially leaving them unchanged), or to prompt
you to make a decision on a case-by-case basis.
„ Array Dimensions. This drop-down list allows you to determine array
parameter behavior between two mapped array parameters when an array size
is altered. You can choose to have the array size always updated in the other
parameter, never updated, or you can be prompted to update the array size on a
case-by-case basis.
„ Show File type encoding on the Files tab. This option allows you to display
the type of encoding used when reading/writing a file parameter. The
information appears on the Design Gateway Files tab. You specify the type of
coding when you create a file parameter. For more information, refer to the
iSIGHT-FD User’s Guide.

„ How many digits ... Specify how many digits will appear after the decimal
point in real numbers. Changing the setting alters the example that appears
immediately below the option, showing you exactly how the numbers will
appear.

4. Expand the Execution folder on the left side of the dialog box; then, click the
General option.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 33

5. Set the following options as desired:

„ Minimize the Design Gateway on job submission. When you execute your
model, the Design Gateway is minimized on your screen, leaving only the
Runtime Gateway visible.

„ Show dialog when model execution produces errors. When selected,


iSIGHT-FD will display a dialog box containing error information if an error
occurs during model execution.

„ Default Runtime Logging Level. This setting allows you to determine what
information is sent to your iSIGHT-FD log file. Components create different
levels of log messages. You can define the minimum log information setting
(Debug), and you will receive information on that particular level, and all other
levels above it.

The following options are available:


• Debug. These messages are intended for debugging system or component
code. These messages are generally meaningful only to the program
developers, not to end users. This level can produce a large quantity of
messages which can affect system performance. This is the lowest level.
Using this setting will send all five types of messages to your log file.
• Info. These messages contain routine status or other informational items
that are not generally significant.
• Warning. These messages indicate a condition of which the end user
should be aware, but does not generally indicate a failure.
• Error. These messages indicate an error condition that was caused by the
end user, operational data, or some other condition that can be corrected.
• SysError. These messages indicate a software system failure. It may
indicate that some part of the infrastructure has become unusable (for
example, a database has gone down), or it may indicate a programming
error. These errors should be reported to system administrators for analysis.
This is the highest level. Using this setting will send only SysError
messages to your log file.
„ Local execution multitasking level. This setting controls the maximum
number of work items (component executions) that will be executed
simultaneously (i.e., in parallel) at a given level of a multi-level model when
running in desktop (Standalone) mode. This limit is provided and enforced so
that the local machine CPU is not overwhelmed by more work than it can

iSIGHT-FD Runtime Gateway Guide


34 Chapter 1 Using the Runtime Gateway Interface

handle at any given time. If the local machine is a multi-processor machine, it


is very possible that you will want to increase this value to allow more work to
be done in parallel, resulting in the job being completed more quickly.

6. Click Parameter Selection on the left side of the dialog box; then, set the largest
number of parameters that will appear on the Runtime Gateway History and
Parameter tabs using the Max# of parameters text box. Be aware that increasing
this number may slow down system performance. You can also specify whether or
not file parameters will appear on these two tabs using the Show File Parameter
option.

Note: You can add any parameters to those tabs at a later time using the Configure
button, which is located on both tabs. For more information, see “Viewing
Parameter Information,” on page 51.

7. Click Sounds on the left side of the dialog box; then, set the actions that you want
to play a sound.
8. Click OK to close the dialog box.

Setting Additional Preferences


The other available preferences allow you to specify preferences for numerous items
within iSIGHT-FD including the following:

„ Approximations
„ File Directories
„ Mail Server
„ Local Results Database (MySQL)
„ Permissions (default settings)

To set gateway preferences:


1. Access the iSIGHT-FD Preferences dialog box as described in “Setting
Preferences,” on page 29.
2. Click Approximations; then, specify the default technique that will always be
selected when using the Approximation Wizard. This option does not set the
default technique for the Approximation component.

3. Click File Directories on the left side of the dialog box; then, define the symbolic
names and actual local directory names for the Design Gateway.

iSIGHT-FD Runtime Gateway Guide


Using the Runtime Gateway 35

The “Shared File System” feature of iSIGHT-FD allows iSIGHT-FD to adjust how
it references a shared file. This adjustment is necessary due to the fact that Shared
or Network file systems are often named differently on different machines. Instead
of using an absolute path, which will be incorrect on some machines, this option
allows the file to be referenced as a path relative to a “Symbolic Root Directory”.

On each machine, the symbolic root directory is set to the location where that
machine mounts the shared file system. Each time the file is referenced by the
Design Gateway, the local symbolic root value is used to build the absolute path to
the file that is appropriate for that machine.

For more information on this option, refer to the iSIGHT-FD User’s Guide.
4. Click Mail Server on the left side of the dialog box; then, set the following options
as desired. These options are related to the Mail component and to the e-mail
button on the iSIGHT-FD error dialog, allowing you to e-mail error information to
Engineous technical support. If you specify this information here, it will
automatically be added to any Mail component that you use (so you don’t have to
manually enter it each time you use the component). The following options can be
specified:
„ Email Server. The name of your e-mail server.

„ Email User Name. Your user name in your e-mail system.

„ Email Address. Your full e-mail address.

Note: For more information on these settings, contact your local system
administrator.

5. Click Local Results Database on the left side of the dialog box; then, set your
database preferences. These preferences allow you to set database information for
storing execution results. When this option is deactivated, execution results are
stored in the local file.

You can clear the contents of your database at any time by clicking the Clear all
data... button.

Important: This button deletes all tables from the current database and should be
used with caution.

For more information on the other database settings that are available, refer to the
iSIGHT-FD Getting Started Guide.

iSIGHT-FD Runtime Gateway Guide


36 Chapter 1 Using the Runtime Gateway Interface

6. Click Default Permissions on the left side of the dialog box. The Default
Permissions options appear. These permissions are specifically for use with the
FIPER environment. For more information, see “Setting Job Permissions,” on
page 43.

7. Click OK to close the dialog box.

Setting Component Preferences


Some components give you the ability to set custom default options for specific
settings. For more information, refer to the iSIGHT-FD User’s Guide.

Working With Jobs


A job consists of a model, optionally some initial data or values, and job control
information, such as logging level. Model execution is submitted as a job. Jobs are
identified by a unique ID (generated by the system when the job is submitted) and a
readable job name provided by the user or generated by the Runtime Gateway.

Jobs can be automatically saved to a local database, if configured (or to an ACS


database if you are accessing the FIPER environment), and the job information,
including parameter values, can be reloaded at any time.

Proceed to one of the following sections for more information:


„ “Opening a Job From a Database,” on page 37

„ “Stopping Running Jobs,” on page 39

„ “Re-executing Failed Jobs,” on page 40


„ “Creating Custom Job Names,” on page 41

„ “Selecting Loaded Jobs,” on page 42

„ “Removing Jobs From Memory,” on page 42

„ “Setting Job Permissions,” on page 43

„ “Deleting Jobs from the Database,” on page 48

iSIGHT-FD Runtime Gateway Guide


Working With Jobs 37

Opening a Job From a Database


This option allows you to open jobs stored in a database (local or ACS). Selecting a job
automatically opens the associated model, so you don’t need to first load a model and
then load a job. You can perform both actions in a single step.

To open a job and its model from a job database:

1. Select Load Job from Database... from the Runtime Gateway File menu, or click
the button on the Runtime Gateway toolbar. The Select Job dialog box appears.
Your screen may differ from the one below depending on whether you have a local
or ACS connection.

2. Enter the search criteria at the top of the dialog box. You can search on any of the
following job information:

„ (FIPER ACS connections only) The name of the user who submitted the job.
By default, the name of the current user is added to this text box.

„ Text string in the model’s name or description

iSIGHT-FD Runtime Gateway Guide


38 Chapter 1 Using the Runtime Gateway Interface

„ Jobs that started on or after a specific date

„ Whether or not you want approximation initialization jobs included in your


search

3. Click Search.

Note: You can also just click the Search button, without specifying any search
criteria, to view a list of all of the jobs in the database.

All jobs that match the specified search criteria are listed.

4. Select the job you want to use. When you select a job, the job details appear in the
lower portion of the dialog box. The details include the name of the model, the
model version, the job ID (which is defined by iSIGHT-FD), the model
description, the name of the user that saved the job, the start and end date or the
job, and job’s execution status.

5. Click the Load Job button. The job is loaded into the Runtime Gateway.

iSIGHT-FD Runtime Gateway Guide


Working With Jobs 39

Stopping Running Jobs


Typically, running jobs are stopped by using the button on the Runtime Gateway
toolbar. However, you can also stop jobs using the Select Job dialog box, if you are
connected to a local database. For more information on the toolbar button, see “Using
the Runtime Gateway Toolbar Buttons,” on page 26.

You can stop jobs that are currently running using the Select Jobs dialog box (the Jobs
Database), if you have the proper permissions. Jobs that are currently running are
designated by a icon in the Status column.

To stop a running job using the Jobs Database:

1. Select Load Job from Database... from the Runtime Gateway File menu.

Note: You can access the same interface from the Design Gateway by selecting
Job Database from the View menu.
The Select Job dialog box appears.

2. Locate the job you want to stop. The job must have a icon in the Status column.
For more information on searching for a job, see “Opening a Job From a
Database,” on page 37.

iSIGHT-FD Runtime Gateway Guide


40 Chapter 1 Using the Runtime Gateway Interface

3. Click the job to select it; then, click the Cancel Job button at the bottom of the
Select Job dialog box. The job is stopped, and the icon in the Status column is
replaced with a icon.

4. (optional) Click the Delete Job(s) button to remove the job from the database. For
more information, see “Deleting Jobs from the Database,” on page 48.

Re-executing Failed Jobs


The Select Job dialog box now provides you with a simple method for re-executing
jobs that failed during execution.

Important: This feature is designed for use when a job was running correctly and was
terminated for some (known or unknown) reason, such as a power failure or something
else unexpected. It is not designed for use with jobs that fail due to configuration
problems.

This feature allows the job to resume execution as quickly as possibly by restoring the
data from all of the prior runs in the database. It does not attempt to re-execute failed
runs. Therefore, if the prior job ran for quite some time and then started failing many
components, re-executing the job will also lead to failed runs. However, many jobs
resume after the failed runs and begin executing after the last run of the prior job.

To re-execute a failed job:


1. Select Load Job from Database... from the Runtime Gateway File menu.

Note: You can access the same interface from the Design Gateway by selecting
Job Database from the View menu.

iSIGHT-FD Runtime Gateway Guide


Working With Jobs 41

The Select Job dialog box appears.

2. Locate the job you want to re-execute. Failed jobs are labeled with the icon in
the Status column. For more information on searching for a job, see “Opening a
Job From a Database,” on page 37.
3. Click the job to select it; then, click the Rerun Job button at the bottom of the
Select Job dialog box. The job is re-executed in the Runtime Gateway.
Note: You can also re-execute a failed job directory from the Runtime Gateway
using the button in the upper left corner of the interface.

Creating Custom Job Names


By default, the job name consists of the file name, the current date, and the current
time. If you simply click the Run button when executing, this default job name is
used and saved to the database (local or ACS). However, you can specify a name for
each job immediately prior to execution. This action may make the task of finding the
job at a later time easier.

To specify a job name, simply follow the procedure described in “Using the Configure
and Run Options,” on page 24; then, type the job name in the Job Name text box.

iSIGHT-FD Runtime Gateway Guide


42 Chapter 1 Using the Runtime Gateway Interface

Once you click OK, the job is executed in the Runtime Gateway, and the job name you
entered appears on the Job Name drop-down list.

Selecting Loaded Jobs


If you have executed multiple jobs for a single model in your current iSIGHT-FD
session, you can easily switch from job to job using the Job Name drop-down list at the
top of the Runtime Gateway interface. Simply click the drop-down list and select the
job you wish to view. The job’s information is then loaded into the Runtime Gateway.
You can also remove jobs from this drop-down list. For more information, see
“Removing Jobs From Memory,” on page 42.

To switch between models, use the Runtime Gateway Window menu.

For more information on opening jobs from the database, see “Opening a Job From a
Database,” on page 37.

Removing Jobs From Memory


There may be occasions when you want to remove old jobs from your system’s
memory. If you are using a database (local or ACS), the job remains stored in the
database, it is simply not available from the Job Name drop-down list. You can reload
the job from the database at any time as described in “Opening a Job From a
Database,” on page 37.

iSIGHT-FD Runtime Gateway Guide


Working With Jobs 43

To unload jobs from the Runtime Gateway memory:

1. Select Unload Jobs from the Runtime Gateway Windows menu. The Unload Jobs
dialog box appears.

2. Select the jobs that you want to unload individually (to select specific jobs), or
click the Select All button to select every job in the list.

3. Click the Unload button. You are returned to the Runtime Gateway. The jobs you
removed are no longer accessible from the Job Name drop-down list at the top of
the Runtime Gateway.

Setting Job Permissions


If you are connected to an ACS in the FIPER environment, you can set access
permissions to the jobs that are stored in the ACS database. You can set default
permissions, which are applied to each run. You can also set permissions on a
job-by-job basis.

For more information, see one of the following sections:

„ “Setting Default Job Permissions,” on page 44

„ “Setting Permission for a Specific Job,” on page 46

iSIGHT-FD Runtime Gateway Guide


44 Chapter 1 Using the Runtime Gateway Interface

Setting Default Job Permissions


You can set default job permissions, which are used whenever a job is executed and
stored in an ACS database. This option helps eliminate the need to manually set
permissions for each job. The interface described in the following procedure can be
used to set default permission for both objects (models and components) and jobs. For
more information on published objects, refer to the iSIGHT-FD User’s Guide.

Note: You can set default options for most jobs, but then set different options for
specific jobs. For more information, see “Setting Permission for a Specific Job,” on
page 46.

To set default job permissions:

1. Access the iSIGHT-FD Preferences dialog box as described in “Setting


Preferences,” on page 29.

2. Click the Default Permissions option on the left side of the dialog box. The
permissions options appear.

The default permissions for jobs are specified using the bottom half of the right
side of the dialog box. Now you need to add users to the list and set their
permissions.

3. Click the Add button. A cursor appears in the Managed Name field.

iSIGHT-FD Runtime Gateway Guide


Working With Jobs 45

4. Enter the user name or group name whose permissions you are setting in the
Managed Name column. You’ll specify whether the name represents a user or a
group in step 6.

5. Click the Permission field; then, select the type of permission from the drop-down
list that appears. The following options are available:

„ ALTER. The user or group has full access to the job, including the ability to
edit the job’s permissions. The user or group can view the details of the job,
load the job into the Runtime Gateway and watch it run, and view any results
generated by the job. The user or group may also pause, resume, and stop the
job while it is running, and may delete the job and all its results at any time.

„ MODIFY. The user or group has all of the accessibility granted with the
ALTER option, with the exception of editing the job’s permissions.

„ READ. The user or group can only view the job’s workflow and execute it. No
parameter access is allowed.

„ NONE. The user or group will have no access to the published job.
6. Click the Represents field; then, select if the name specified in the Managed
Name column represents an individual user or a predefined group. The following
options are available:

„ USER. This option allows you to specify a particular user name for the
permission you are defining. The user name should be specified in the
Managed Name column as described in step 4.

„ FIPER GROUP. This option allows you to specify a group of users to share
the permission you are defining, instead of creating a permission for each user.
The group name should be specified in the Managed Name column as
described in step 4.

7. Set job permissions for all other users (except for those explicitly defined) by
clicking the All other users button. The options available are the same as those
described in step 5 above. You can also specify that there is no default option for
other users.

8. Repeat step 3 through step 7 for any additional user permissions you want to
define.

iSIGHT-FD Runtime Gateway Guide


46 Chapter 1 Using the Runtime Gateway Interface

9. (optional) Arrange the listed users, as desired. You can use the Up or Down
buttons to move a user up or down in the list. The selected user’s settings move up
or down one line. The order of your list is important since a user name may appear
in one or more groups (the FIPER GROUP option) as well as by itself. Therefore,
it is possible for a user to be assigned more than one permission for the same job.
When this multiple permission issue occurs, iSIGHT-FD uses the permission
closest to the top of the list to determine the user’s actual permission for the job.

You can also use the Delete button to remove a user from the list.

10. Click OK to save your changes.

Setting Permission for a Specific Job


You can set access permission for particular jobs stored in an ACS database using the
Select Job (Job Database) dialog box.

Note: If all of your job permissions will be the same for every job, you can set the job
permission defaults prior to execution. Using this method, all of your jobs will have the
correct permissions as soon as they are created. For more information, see “Setting
Default Job Permissions,” on page 44.

To set permissions for a job:

1. Select Load Job from Database from the Runtime Gateway File menu.

Note: You can access the same interface from the Design Gateway by selecting
Job Database from the View menu.

iSIGHT-FD Runtime Gateway Guide


Working With Jobs 47

The Select Job dialog box appears.

2. Locate the job for which you want to set permissions. For more information on
searching for a job, see “Opening a Job From a Database,” on page 37.

3. Verify that the job is selected from the list; then, click the Job Permissions...
button at the bottom of the dialog box.
Note: If you do not see this button, then you are not connected to a FIPER ACS,
and job permission options are not available.
The Edit Job Permissions dialog box appears.

This dialog box is a copy of the one accessed using the Preferences dialog box,
except that the options for setting permissions for published objects have been
removed.

iSIGHT-FD Runtime Gateway Guide


48 Chapter 1 Using the Runtime Gateway Interface

4. Specify the permissions for the job. For more information on the options available,
see “Setting Default Job Permissions,” on page 44.

5. Click OK. Your permission settings are saved and you are returned to the Select
Job dialog box.

Deleting Jobs from the Database


You can delete jobs from the jobs database. This action differs from removing the jobs
from memory. Removing the job from the database permanently deletes the job. The
results can no longer be recovered and used in the Runtime Gateway. Caution should
be used when deleting jobs from the database.

To delete a job from the Database:

1. Access the Select Job dialog box as described in “Opening a Job From a
Database,” on page 37.

Note: You can also access this dialog box from the Design Gateway by selecting
Job Database from the View menu.

2. Enter the search criteria at the top of the dialog box. You can search on any of the
following job information:

„ Text string in the model’s name or description

„ Jobs that started on or after a specific date

„ Whether or not you want approximation initialization jobs included in your


search

3. Click Search.

Note: You can also just click the Search button, without specifying any search
criteria, to view a list of all of the jobs in the database.

iSIGHT-FD Runtime Gateway Guide


Setting Workflow Options 49

All jobs that match the specified search criteria are listed.

4. Select the job you want to remove; then, click the Delete Job(s) button. A
confirmation message appears. If the job you want to delete is running (designated
by a icon in the Status column, you first must click the Cancel Job button to stop
the job. For more information, see “Stopping Running Jobs,” on page 39.

Note: You can select multiple jobs to delete by holding down the CTRL key on
your keyboard and clicking numerous jobs on the list.

5. Click Yes.

Setting Workflow Options


The Workflow tab provides you with a view of the model’s workflow, as well as an
indication of the execution status of each component. If a component is successfully
executed, an icon appears above it. Also, the number of runs the component executed
is shown.

iSIGHT-FD Runtime Gateway Guide


50 Chapter 1 Using the Runtime Gateway Interface

The following additional features are available on this tab:

„ “Viewing/Hiding Annotations” on this page

„ “Saving the Workflow Image” on this page

„ “Using the Component Options” on this page

Viewing/Hiding Annotations
If any workflow annotations were added to the model in the Design Gateway, these
annotations will appear on the Runtime Gateway’s Workflow tab. You can choose to
show or hide these options using the button to the left of the workflow. For more
information on workflow annotations, refer to the iSIGHT-FD User’s Guide.

Saving the Workflow Image


You can save the workflow images as a *.jpg or *.jpeg file using the button to the
left of the workflow. Once saved, you can open the file in the image viewing software
of your choice, or use it in another application.

Using the Component Options


You can right-click a component icon to view the following options:

„ Collapse/Expand. This option either displays or hides the contents of process


components in the Workflow canvas. This option is only available for process
components.

„ Run. This option executes the selected component. If you are connected to an
ACS, you can choose to execute the component using the ACS or to run it locally
using the Test Locally submenu.

„ Print This Component Tree... This option prints information about the
component.

„ Save As. This option allows you to save a model with the component as the root.

iSIGHT-FD Runtime Gateway Guide


Understanding Graph and Table (Visuals) Options 51

„ Publish. This option allows you to publish the component, which makes it
available to other uses who access your Library. For more information on
publishing components, refer to the iSIGHT-FD User’s Guide.

„ Save Results To Disk... This option allows you to save all of the results generated
by the currently loaded job for the component to a specified directory. For more
information on this option, see “Saving Results,” on page 69.

Understanding Graph and Table (Visuals)


Options
For more information on graphs and tables (collectively known as visuals) and other
visualization tools, see Chapter 2 “Using Graphs, Tables, and Visualization Tools”.

Viewing Parameter Information


Following execution, you can view parameter information using the Runtime Gateway
Parameters tab and the History tab. The Parameters tab is also used to display
aggregate parameter for Optimization, DOE, and Monte Carlo components. For more
information, see one of the following sections:

„ “Understanding the Parameters Tab,” on page 52

„ “Setting Viewed Parameters,” on page 53

„ “Viewing Optimization Information,” on page 54

„ “Viewing DOE Information,” on page 54

„ “Viewing Monte Carlo Information,” on page 55

„ “Using the History Tab,” on page 55

iSIGHT-FD Runtime Gateway Guide


52 Chapter 1 Using the Runtime Gateway Interface

Understanding the Parameters Tab


The Parameters tab displays all parameter values for a particular run of the selected
component.

In the following example, the Compute Stress Script component from the I-Beam
example is displayed.

This Parameters tab is divided into two sections, with one section showing the Input
parameters and one showing the Output parameters. You can move between
components using the Model Explorer on the left side of the Runtime Gateway. In/Outs
appear in both tables, with the starting value in the input table and the ending value in
the output table.

You can also use this tab to alter parameter values between runs, and you can view
values of different runs using the View Run button at the bottom of the tab.

Note: Only the values of parameters can be altered using this tab.

iSIGHT-FD Runtime Gateway Guide


Viewing Parameter Information 53

Setting Viewed Parameters


You can control which parameters are displayed on the Parameters tab by clicking the
Configure button in the bottom right corner of the tab.

The Select Parameters for Viewing dialog box appears.

This dialog box displays a list of all parameters for the current component. Only those
parameters checked in the Selected column are displayed. You can clear any check
boxes for parameters you wish to be hidden. You can also click the Select All check
box to display all parameters (instead of selecting each one in the list).

You can use this dialog box to work with dynamic (resizable) arrays. For more
information, see “Using Dynamic Arrays,” on page 58.

Click OK to save your changes and return to the Runtime Gateway.

Note: If the component has less than a 1000 parameters, all the parameters will appear,
by default. You can change this value by editing iSIGHT-FD preferences. Be aware
that increasing the parameters shown could slow down performance. For more
information on editing preferences, see “Setting Gateway Preferences,” on page 30.

Note: This option is also available on the History tab. For more information on using
this tab, see “Using the History Tab,” on page 55.

iSIGHT-FD Runtime Gateway Guide


54 Chapter 1 Using the Runtime Gateway Interface

Viewing Optimization Information


When an Optimization component is created and configured, it creates an output
aggregate parameter called Optimization Results. After execution, every optimization
component writes in this aggregate some basic results: values of constraints at the
optimum point (member called “Constraint Values at Optimum”), values of all selected
input and output parameters (member called “Optimal Design”), and a short summary
of the execution (member called “Execution Summary”).

For optimization techniques NLPQL and LSGRG, another member of this aggregate is
created called “Technique Log”. In this member, all the log messages produced by
those algorithms are saved for later examination. Previously, all log messages from
these techniques were not saved at all.

Viewing DOE Information


The DOE component provides an output aggregate parameter called “DOE Results”
that is initially empty. After configuring the DOE component by selecting factors and
responses, this parameter is populated with various members to represent the relevant
post-processing results from executing the DOE. The following items are included in
the DOE Results parameter:

„ Statistics. For each factor and response selected, the minimum, maximum, range,
mean, and standard deviation are calculated.

„ Main Effects. If the option to “Perform regression analysis” was selected on the
Post-Processing tab of the DOE component editor, for each response selected the
main effect of each factor on that response is reported.

„ Best Point. If an objective was defined for any of the selected responses, the best
point (input and output values) of all points executed is reported.
„ Execution Summary. A file parameter that contains a brief summary of the DOE
execution is provided in HTML format. This file contains DOE setup information
and the calculated effects of all factors on each response (if available).

iSIGHT-FD Runtime Gateway Guide


Viewing Parameter Information 55

„ Data Set. This option can be accessed by clicking the File button, and information
appears in a separate dialog box. You may save this information to a file, if desired.

„ Execution Summary file. This file can be accessed by clicking the File button and
saving to a desired location as an *.html file. It contains task completion
information (such as time and date), technique type, and the number of
experiments. It also contains a table displaying the estimated relative effects that
the various factors had on each response.

Viewing Monte Carlo Information


When a Monte Carlo component is created and configured, it creates an output
aggregate parameter called Monte Carlo Results. After execution, every Monte Carlo
component writes some basic results to its results aggregate:

„ Probability values associated with each output response for which limits were
defined (potentially includes probability above a lower limit, probability below an
upper limit, total probability between the upper and lower limits, and the value of
the response at a specified percentile).
„ Basic statistics for each random variable and responses (includes mean, standard
deviation, minimum, and maximum).
„ A short summary of the execution, which you may save to a file parameter called
Execution Summary, which includes the Monte Carlo setup information (random
variable definitions) and calculated response statistics and probabilities.

Using the History Tab


The History tab shows parameter values from the execution of a model. It differs from
the Parameters tab in that it shows the values for numerous runs. The number of rows
displayed is based on the number of times that the specified component was executed
(one row means a single execution, twenty rows means twenty executions).

iSIGHT-FD Runtime Gateway Guide


56 Chapter 1 Using the Runtime Gateway Interface

In the following example, the Compute Stress Script component from the I-Beam
example is displayed.

Notice the each parameter has its own column, and each row denotes a run for the
component.

The following additional options/features are available on this tab:

„ Run Success Indicator. The first column indicates if the run was successful. If the
run is successful, a symbol appears in the column. If the run was not
successful, a symbol appears in the column. If an approximation was executed
instead of the actual component, a symbol appears in the column.

„ The next columns (before the parameter values) show the run for each component.
The components are shown in relation to one another. The root is always run once.

„ You can select a run in the history tab and use the parameter values to start a new
model execution. For more information, see “Initializing the Model From a Prior
Run,” on page 57.

„ If an array parameter has been defined as “resizable” it can be resized during


execution. For more information, see “Using Dynamic Arrays,” on page 58.

iSIGHT-FD Runtime Gateway Guide


Viewing Parameter Information 57

„ You can sort the data on the tab. For more information, see “Sorting the Data,” on
page 60.

„ You can filter the data on the tab so that only specified information is displayed.
For more details, see “Filtering the Data,” on page 60.

„ Determine which parameters are displayed using the Configure button. For more
information, see “Setting Viewed Parameters,” on page 53.

„ Click the button to copy the highlighted information so that you can paste it
into a separate file. You can also access this option by right-clicking the contents of
the tab.

„ Click the button to save the information to a file.

„ Click the button to print the information.

„ Exporting the data on the tab to a text file or Microsoft Excel. For more
information, see “Exporting Graph Data,” on page 93.

Initializing the Model From a Prior Run


You can select a run from the history tab and easily set the model’s parameter values
and re-execute the model based on the values of the selected run. This process is
known as initializing the model. The parameter values are updated for each component
in the model’s execution path.

To initialize the model from a prior run:

1. Click the run on the History tab whose parameter values you want to use. The run
is highlighted.

2. Right-click the run; then, select Init model from this run from the menu that
appears.

Note: If you are viewing run from a process component (Optimization, Monte
Carlo, etc.), the initialization option is not available if the Show subflow data
check box is selected. This check box is located near the bottom of the History tab.
To use this option with a process component, simply clear (uncheck) the check
box.

iSIGHT-FD Runtime Gateway Guide


58 Chapter 1 Using the Runtime Gateway Interface

3. Save the model by selecting Save from the Runtime Gateway File menu. You are
prompted to save the model with a new file name. This step is recommended, since
your model has changed, but is not necessary. However, if you want to view the
new parameter values using the Design Gateway’s Parameters tab, you must first
save the model.

4. Return to the Design Gateway; then, select Open from Disk... from the File menu
and load the file you saved in step 3.

5. Return to the Runtime Gateway; then, execute the model.

Using Dynamic Arrays


If an array parameter has been defined as “resizable” it can be updated during
execution. Arrays are initially defined, and their resizing setting is determined, using
the Design Gateway. All arrays are resizable from the Design Gateway. However, you
must specify if an array can be resized during execution. For more information on
specifying array information, refer to the iSIGHT-FD User’s Guide.

Any array parameter that is defined as resizable is marked with an asterisk (*) to the
right of the parameters name on the Parameters tab. In the following example, two
parameters are resizable.

iSIGHT-FD Runtime Gateway Guide


Viewing Parameter Information 59

You use the History tab to actually work with dynamic arrays. To access dynamic array
options:

1. Click the History tab; then, click the Configure button near the bottom of the tab.
The Select Parameters for Viewing dialog box appears.

Notice that the root array parameter is selected, by default (a check mark appears
in the Selected column). However, if you expand the array to view its elements (by
clicking the icon), the elements themselves are not selected.
For non-dynamic arrays, if you select the root array parameter, all of the elements
are included by default. Dynamic arrays provide you with more options.

2. Perform any of the following options, as desired:

„ Select only the root array parameter. This option allows you to see all of the
elements of the array, no matter the size, during execution.

„ Select only individual elements. This option allows you to only see the
elements you specify. Be sure the clear (uncheck) the root array parameter.
Note: There are two parameter preference settings that can help you define default
array parameter behavior with regard to mappings between components. For more
information, see “Setting Gateway Preferences,” on page 30.

iSIGHT-FD Runtime Gateway Guide


60 Chapter 1 Using the Runtime Gateway Interface

3. Click OK to save your changes and return to the History tab.

Note: The Data Exchanger, Excel, and Script components may resize arrays. For more
information, refer to the iSIGHT-FD User’s Guide.

Sorting the Data


You can sort in ascending or descending order for any parameter by clicking on that
parameter’s column header. The first click sorts in Ascending order. The second click
sorts in Descending order. A third click returns you to the original non-sorted option.
You can also right-click a column header, and select Sort from the menu that appears
to access these options.

Note: You can also sort multiple columns of data at the same time. Simply press and
hold either the Shift or Ctrl key on your keyboard; then, click the column headers that
correspond to the information you want to sort. When performing a multi-column sort,
the primary sort is always based on the first column clicked.

Filtering the Data


If you are working with a large number of parameters, and only want to view certain
subsets of those parameters, you can use the filter options to change the displayed
parameters on the History tab.

Note: You can also filter the data is tables created to display component parameter
information.

To filter your parameters:


1. Click the button above the parameter list.

iSIGHT-FD Runtime Gateway Guide


Viewing Parameter Information 61

The Table Filters dialog box appears.

The appearance of your dialog box will differ based on the parameter displayed on
your History tab.

2. Filter based on any of the following two options, as desired:

„ Status. This option represents the status of the design run.


„ parameter value.
3. Click OK.

iSIGHT-FD Runtime Gateway Guide


62 Chapter 1 Using the Runtime Gateway Interface

You are returned to the History tab, and the list of parameters is updated based on
your filter selections. Any column selected as part of your filter options now
displays a icon to the left of the column header. In the following example, the sort
was based on the value of the parameter sfy being greater than 1. Also, the text to
the right to the button tells you how many rows (parameters) match your filter
based on the total number of rows (parameters).

4. Perform any of the following actions, as desired:

„ Add to the existing filter by clicking the and returning to step 1.

„ Remove the defined filter, and return the parameter list to its original state, by
clicking the button.

iSIGHT-FD Runtime Gateway Guide


Viewing the Summary 63

Viewing the Summary


All components display basic summaries on the Summary tab. However, some
components show detailed summaries (such as DOE and Optimization).

The following example shows the summary of the Compute Stress Script in the I-Beam
model.

iSIGHT-FD Runtime Gateway Guide


64 Chapter 1 Using the Runtime Gateway Interface

The following example shows the summary of the DOE in the SpringSamples model.

Using the Logs


You can access two distinct log files using the Runtime Gateway.

„ Log Tab: This tab displays execution related information, based on your Log Filter
setting. For more information, see “Viewing the Log Tab,” on page 65.

„ Log Viewer. This dialog box displays information that is written to the
gateway.log file. This log file is the Design Gateway log file, and can also be
accessed that interface. For more information, see “Accessing the Log File,” on
page 66.

In some cases, information that appears in one log display will also appear in the other
log display. If you are connected to an ACS in the FIPER environment, errors may not
be displayed in either log file, if the log file being written to is on a different machine
(such as a system running a FIPER Station).

iSIGHT-FD Runtime Gateway Guide


Using the Logs 65

Viewing the Log Tab


The Log tab displays execution information. The amount of information stored that is
displayed on the Log tab is customizable.

The following example shows a sample Log tab. Notice that a large amount of
information is displayed, since the Debug option was selected from the Log Filter
button. For more information on using this button, see the section below the figure.

The following information and options are available:

„ Show log for selected component only check button. This option allows you to
specify log information for a single component. Only information for the
component selected in the model explorer is displayed.

„ Log Filter button list. This option allows you to specify the information displayed
in the messages area. The options available from the drop-down list include:
Debug, Info, Warning, Error, and SysError. When a job is run, a logging level is
defined. The default setting is Warning. After a job runs, it is not possible to get
logs for a level below that which the job specified. For more information on using
these filter settings, as well as the type of message each provides, see “Setting
Gateway Preferences,” on page 30.

iSIGHT-FD Runtime Gateway Guide


66 Chapter 1 Using the Runtime Gateway Interface

„ Messages area. This area shows the full text of the selected row in the log table.

„ Job Details area. This area contains information about the job, including the
model name, job identification, and status.

Note: If model execution fails, and you view the details using the Logs tab, a
Rerun Job button appears next to the Status icon. For more information on using
this option, see “Re-executing Failed Jobs,” on page 40.

Accessing the Log File


The Design Gateway log file can be easily accessed by clicking the button at
the bottom of the Runtime Gateway (or the Design Gateway). If an error has occurred,
and information has been written to the log file, the button changes to . The
Log Viewer dialog box appears when the button is clicked. The following example
shows a log file that contains information about an error that has occurred.

The actual log file (gateway.log) is stored in the following location on your local
system, and can be accessed directly from this location, if desired:

„ Windows: C:\Documents and Settings\<username>\Local Settings\Temp\

„ UNIX/Red Hat Linux: /home/<username>

iSIGHT-FD Runtime Gateway Guide


Using the Logs 67

You can perform any of the following tasks using the log viewer:

„ Click the Reset button to set the Log Severity icon back to the OK state.
This action does not clear the log file. The error messages remain in the log file.

„ Copy the text (in order to paste it into another application) using the Copy button.
You can select any part of the text you like. If no text is selected, the entire contents
of the log file are automatically copied.

„ Click the Email Log button to send the information to Engineous Software
technical support. The Send FIPER Gateway Log dialog box appears.

If necessary, specify your e-mail address in the From text box. You can set
iSIGHT-FD to use a default From e-mail address whenever an e-mail function is
used. For more information, see “Setting Additional Preferences,” on page 34.

Also, add text or attachments, as desired. When contacting technical support


regarding a problem, please provide the following information in addition to the
log file, if possible:

„ Detailed explanation of the problem

„ Screen captures

Click the Send button. An Engineous Software representative will contact you
about your problem as soon as possible.

iSIGHT-FD Runtime Gateway Guide


68 Chapter 1 Using the Runtime Gateway Interface

Viewing the Dataflow


You can view the dataflow from the Runtime Gateway. However, this option is
deactivated by default. To activate the Dataflow tab, select Dataflow from the View
menu. The corresponding check box is activated, and the Dataflow tab appears on the
Runtime Gateway and is automatically selected.

The same right-click options available from the Workflow tab can be accessed using
the Dataflow tab. For more information on these options, see “Setting Workflow
Options,” on page 49.

iSIGHT-FD Runtime Gateway Guide


Executing a Model or Component from the Runtime Gateway 69

Executing a Model or Component from the


Runtime Gateway
If you run a model directly from the Design Gateway, then execution is started
automatically when the Runtime Gateway is opened.

If you open the Runtime Gateway from the Design Gateway View menu, or if you
open the Runtime Gateway as a standalone interface, you need to manually start the
model execution once you have loaded the model you want to use. You may also want
to re-execute a model originally started in the Design Gateway after altering some of
the information provided in the Runtime Gateway. Model execution in the Runtime
Gateway is similar to model execution in the Design Gateway.

Execution is started using the Run button on the Runtime Gateway toolbar. You
can click the button to simply execute the model, or you can click the down-arrow
portion of the button to execute only the currently selected component or to configure
and run the model or component. For more information on using the configure and run
options, see “Controlling Execution,” on page 24.

You can also execute a component by right-clicking the component icon on the
Workflow or Dataflow tabs and selecting Run from the menu that appears. This runs
the currently selected component.

Saving Results
You can save all of the results generated by the currently loaded job (basically the
information on the Runtime Gateway History tab) to a specified directory. For each
component in the model, a file of runs (a row for each run) is generated, and if that
component contains file parameters a directory is created and populated with a version
of the file for each run.

Important: Results saved in this manner are only for use outside of iSIGHT-FD; they
cannot be read back into the Runtime Gateway for later review or post-processing. To
save results that can be read back into the Runtime Gateway at a later time, set the
Local Results Database setting in the Preferences dialog box. For more information,

iSIGHT-FD Runtime Gateway Guide


70 Chapter 1 Using the Runtime Gateway Interface

see “Setting Preferences,” on page 29. Once results are saved to a database, you can
reload each job you execute and view the results. For more information, see “Opening
a Job From a Database,” on page 37.

To save results to your local disk:


1. Perform one of the following actions:

„ Click the button on the Runtime Gateway toolbar.


„ Select Save Results to Disk... from the Runtime Gateway File menu.

The Select a Directory for the Result Files dialog box appears.

2. Navigate to the parent directory that contains the directory where you’d like the
results saved using the Save In drop-down list. All available directories, based on
your navigation, are displayed below the drop-down list. Do not navigate into the
directory that will store the information.

3. Click the directory to select it.

iSIGHT-FD Runtime Gateway Guide


Saving Results 71

In the following example, the models directory (under the examples parent
directory) has been selected.

4. Click the Save file parameters check box if you want your file parameters saved.
If this option is not checked, only non-file parameters are saved.

5. Use the Parameters drop-down list to specify if All Parameters or Parameters


Shown on History Tab will be saved.

6. Set the delimiter (how the parameter values will be separated in the saved files)
using the corresponding drop-down list. You can select tab or comma delimiters.

7. Click the Select Directory button. Your information is saved in a subdirectory in


the directory you specified. The name of the subdirectory is based on the current
job name. You are returned to the Runtime Gateway.

iSIGHT-FD Runtime Gateway Guide


72 Chapter 1 Using the Runtime Gateway Interface

Creating an ACS Connection Profile


You need to create a connection profile if you are connecting to an ACS in the FIPER
environment. If you are running iSIGHT-FD in the Standalone (Desktop) environment,
this connection profile is included in your installation and does not need to be created.

To create the connection profile file:

1. Access the Profile Editor using one of the following methods:

„ Start the Runtime Gateway; then, when the Logon dialog box appears, click
the button.

„ Execute the editcpr command from a command prompt. If necessary,


navigate to one of the following directories prior to executing the command:

• Windows: <isight-fd_install_directory>\bin\win32
• UNIX/Linux: <isight-fd_install_directory>/bin
The Profile Editor appears.

2. Type the name of the profile in the Profile name text box. This name will appear
on the Connection drop-down list when connecting to the ACS.

iSIGHT-FD Runtime Gateway Guide


Creating an ACS Connection Profile 73

3. Select the server that matches your ACS combination from the Server type
drop-down list. Additional options appear, depending on the server selected.

4. Specify the name of the machine running the ACS in the Server name text box.

Important: If you will be using LSF with iSIGHT-FD, do not specify the server
using its fully qualified domain name. For example, you should type
acsmachine, not acsmachine.yourcompany.com.

5. (optional) Change the port number in the corresponding text box. The port number
provided is the default port number for the application server selected. However,
based on your network or system configuration, you may need to change this
number. Contact your local system administrator for more information.

6. Select Save As... from the File menu; then, name and save the connection profile.
All connection profiles should be stored in the top level of the iSIGHT-FD
installation directory in order to ensure that they appear in the Connection profile
drop-down list on the Logon dialog box.

7. Close the Profile Editor dialog box.

iSIGHT-FD Runtime Gateway Guide


74 Chapter 1 Using the Runtime Gateway Interface

iSIGHT-FD Runtime Gateway Guide


75

2 Using Graphs, Tables, and


Visualization Tools

This chapter discusses using the Runtime Gateway graph and table options, as well as
other visualization tools that are available. Collectively, these items are known as
visuals. The Correlation Map and Engineering Data Mining post-processing tools are
also discussed. The chapter is divided into the following sections:

„ “Introduction,” on page 76

„ “Using Graphs,” on page 76


„ “Using Tables,” on page 96

„ “Using the Correlation Map,” on page 107

„ “Using the Engineering Data Mining Tool,” on page 113

iSIGHT-FD Runtime Gateway Guide


76 Chapter 2 Using Graphs, Tables, and Visualization Tools

Introduction
This section describes the graph and table options available in the Runtime Gateway.
Graphs and tables are collectively known as visuals. It also describes a special type of
visual known as Engineering Data Mining (EDM), which can be used to view results
information for models that use the NSGA-II optimization technique.

Using Graphs
Graphs can be created prior to execution on the Design Gateway (refer to the
iSIGHT-FD User’s Guide) or following execution (as described in this section). Graphs
are updated periodically during execution. However, it is only after execution is
complete that all relevant information is displayed in a graph.

Graphs created on the Design Gateway Graphs Templates tab are saved with the
model. Graphs created on the Runtime Gateway Graphs tab are not saved with the
model. You can save the model on the Runtime Gateway after creating graphs.

This section is divided into the following topics:

„ “Creating a Graph for a Component,” on page 77

„ “Using Specialized Graphs,” on page 83

„ “Updating an Existing Graph,” on page 85

„ “Changing Graph Options,” on page 86

„ “Viewing Graph Information,” on page 87


„ “Exporting Graph Data,” on page 93

„ “Copying a Graph,” on page 94

„ “Normalizing a Graph,” on page 95

„ “Deleting Graphs,” on page 95

iSIGHT-FD Runtime Gateway Guide


Using Graphs 77

Creating a Graph for a Component


Graphs are created using the Graphs tab on the Runtime Gateway.

To create a graph:

1. Select the component you want to graph on the left side of the Runtime Gateway;
then, click the Graphs tab.

The contents of the tab appear with the selected component’s name displayed at the
top of the tab. The example displays the Copy to Arrays component in the I-Beam
model.

Important: You must select the proper component on the left side of the Runtime
Gateway (the Model Explorer section) prior to creating a graph.

2. Verify that the proper page is selected at the bottom of the tab. By default, Page 1 is
used. However, you can create multiple pages using the <New> tab.

3. Click the Graph button .

iSIGHT-FD Runtime Gateway Guide


78 Chapter 2 Using Graphs, Tables, and Visualization Tools

The Graph Creation Wizard appears.

In this example, we will choose the Contour Graph option.

Note: Components such as DOE, Optimization, and Monte Carlo have specialized
graphs options in addition to a list of general graphs. If you are graphing one of
these components, you may select a component-specific graph or general graph
using the embedded tabs. For more information on these component-specific
graphs, see “Using Specialized Graphs,” on page 83.

4. Select the type of graph you want to use. The following options are available on
the General tab:

„ Area Graph. Creates a two-dimensional Area Graph using two or more


parameters. Plots one X value against one or more Y values.

„ Array Graph. Creates a 2D Graph using two or more array parameters. Plots
one X array against one or more Y arrays.

„ Contour Graph. Creates a three-dimensional Contour Graph using three


parameters. Displays color-coded isosurfaces or isobars.

„ Cumulative Frequency. Creates a Cumulative Frequency using one


parameter. The parameter is analyzed over its range and a cumulative
frequency distribution is calculated. This value is similar to the probability
except that there is no guarantee that the data represents the probability
distribution.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 79

„ Frequency Graph. Creates a Frequency Graph using one parameter. The data
is analyzed over its range and divided into frequency bars. This value is similar
to probability except that there is no guarantee that the data represents the
probability distribution.

„ History Graph. Creates a History Graph using one or more parameters. The Y
axis displays one or more parameters, and the X axis is a monotonically
increasing integer value representing the chronological order.

„ Image Graph. Allows you to view file parameters which contain *.gif, *.bmp,
*.jpg, *.jpeg, or *.png files. In other words, models which produce image files
that represent the design can be viewed in the Runtime Gateway.
„ Line Graph. Creates a two-dimensional Line Graph using two or more
parameters. Plots one X value against one or more Y values.

„ Parallel Coordinate Graph. Creates a Parallel Coordinate Graph using 1 or


more parameters. Along the X axis each variable is assigned a position, each
value of that parameter is displayed on a logic axis above that point. Along the
Y axis the values of a given run are strung together with a line connecting all
the dots above each parameter value.

„ Scatter Plot 2D Graph. Creates a two-dimensional Scatter Plot Graph using


two or more parameters. Plots with no connecting lines.

„ Scatter Plot 3D Graph. Creates a three-dimensional Scatter Plot Graph using


three or more parameters. Plots with no connecting lines.

„ Surface Graph. Creates a three-dimensional Surface Graph using three


parameters. Used to show the topology relationship between the parameters
chosen.

„ Value Graph. Creates a Value Graph using one or more parameters. The Y
axis shows the value of one or more parameters, while the X axis displays a
value's rank in the overall group of values. The values are sorted in order of
increasing value, and show the distribution of the sampling over a range.

Note: Additional graphs are available with some components. For information on
these component-specific graphs, see “Using Specialized Graphs,” on page 83.

5. Click Next.

iSIGHT-FD Runtime Gateway Guide


80 Chapter 2 Using Graphs, Tables, and Visualization Tools

The Choose Parameters information appears.

6. Click the parameters that you want to graph. You can select parameters
individually or in groups using the Select drop-down list, which allows you to
automatically select all input parameters, output parameters, local parameters, or
every listed parameter.

7. Click Next. The graph options information appears.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 81

8. Alter any of the following options in the Options area, as desired:

„ Logarithmic X Axis and Logarithmic Y Axis. These options allow you to


change the numeric scaling of either axis to be logarithmic (i.e., in magnitudes
of 10). Using these options may assist you in seeing all the data points when
the data in the graph is displayed in varying degrees of magnitude.

„ Show grid lines. When selected, this option allows the graph to display grid
lines.

Note: These options will vary depending on the type of graph you selected. They
will also not appear for some graph types.

9. In the Legend Options area, click the Show Legend check button if you’d like a
legend displayed with your graph; then, select the legend’s location with respect to
the graph.

10. Set the Include Failed Runs check box. When selected, any failed runs are
included in the graph.

11. Click Next. The Creation Summary information appears.

Note: Some specialized graphs have additional options. For more information on
these options, see “Using Specialized Graphs,” on page 83.

12. Review the information on the Summary tab.

13. Click the Job Selection tab.

iSIGHT-FD Runtime Gateway Guide


82 Chapter 2 Using Graphs, Tables, and Visualization Tools

The contents of the tab appear.

14. Determine which job information will be used to create the graph. You can use the
recently executed job (Active Job) or all jobs that are loaded in the current session
(All Loaded Jobs). For more information on using jobs, see “Working With Jobs,”
on page 36.
15. Click Finish. Your graph(s) is added to the Runtime Gateway.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 83

The Graph / Table Explorer now appears below the Model Explorer on the bottom
left side of the Runtime Gateway. This feature allows you to easily navigate
between graphs and tables on different pages, as well as those tied to different
components.

Using Specialized Graphs


The following sections list the specialized graphs available in the Runtime Gateway.

Monte Carlo Graphs


„ Cumulative Distribution. Creates a Cumulative Distribution Graph for the
specified Random Variables and/or Responses.

„ Pareto Plot. Creates a graph that shows the effect of a factor or set of factors on a
response by plotting the relationship as determined by regression analysis of the
data set. It is an ordered bar chart that displays the effects of each random variable
on a selected response, where the random variables are listed in order of largest
effect to smallest effect. Blue bars indicate positive effects on responses, while red
bars indicate negative effects. Therefore, this plot can be used to identify the
random variables with the most significant effects on, or largest contribution to, the
variability of the responses. The Visual Wizard Chooser allows you to set the
following additional options for Pareto Plots:
„ Regression Analysis Order. You can set this option to either Linear or
Quadratic (if the data allows for this setting).

„ Show bars as. You can set the bars in the graph to show either absolute values
or actual values.

„ Terms to show. You can specify the terms to show by either selecting all
terms, those within a certain range, or those in relation to a specific percentage.
„ Probability Distribution. Creates a Probability Distribution Graph for the
specified Random Variables and/or Responses.

iSIGHT-FD Runtime Gateway Guide


84 Chapter 2 Using Graphs, Tables, and Visualization Tools

„ Scatter Plot 2D. Creates a two-dimensional Scatter Plot Graph using two
parameters. No lines connect the values.

„ Scatter Plot 3D. Creates a three-dimensional Scatter Plot Graph using three
parameters. No lines connect the values.

Design of Experiments (DOE)


„ Main Effects Graph. Creates a graph that shows the effect of a factor or set of
factors on a response by plotting the relationship as determined by regression
analysis of the data set. The Visual Wizard Chooser allows you to set the following
additional option for a Main Effects graph:

„ Fit type. Specify this option as either Continuous or Piecewise.

„ Pareto Plot. Creates a graph that shows the effect of a factor or set of factors on a
response by plotting the relationship as determined by regression analysis of the
data set. It is an ordered bar chart that displays the effects of each random variable
on a selected response, where the random variables are listed in order of largest
effect to smallest effect. Blue bars indicate positive effects on responses, while red
bars indicate negative effects. Therefore, this plot can be used to identify the
random variables with the most significant effects on, or largest contribution to, the
variability of the responses. The Visual Wizard Chooser allows you to set the
following additional options for Pareto Plots:
„ Regression Analysis Order. You can set this option to either Linear or
Quadratic (if the data allows for this setting).

„ Show bars as. You can set the bars in the graph to show either absolute values
or actual values.

„ Terms to show. You can specify the terms to show by either selecting all
terms, those within a certain range, or those in relation to a specific percentage.

Optimization
„ History Graph. Creates a history graph of a parameter and shows its Lower
Bound and Upper Bound (if they exist). The Y axis displays one or more
parameters, and the X axis is a monotonically increasing integer value representing
the chronological order.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 85

„ Line Graph. Creates a line graph using two parameters and shows their Lower
Bound and Upper Bound (if they exist). Plots one X value against one or more Y
values.

„ Optimization 2D Scatter Plot. Creates a two-dimensional Scatter plot using two


parameters and shows their Lower Bound and Upper Bound (if they exist). Plots
one X value against one or more Y values and indicates overall Bounds Violations
via color coding scheme.

„ Optimization 3D Scatter Plot. Creates a three-dimensional scatter plot using


three parameters and shows their Lower Bound and Upper Bound (if they exist).
Plots one X value against one or more Y values and indicates overall Bounds
Violations via color coding scheme.

„ Value Graph. Creates a value ordered graph of any parameter and shows its
Lower Bound and Upper Bound (if they exist). The Y axis shows the value of one
or more parameters while the X axis displays a value's rank in the overall group of
values. The values are sorted in order of increasing value, and show the
distribution of the sampling over a range.

Updating an Existing Graph


Once a graph has been created, you can update it, including changing the parameters
used to create the graph, general options, legend options, and job selection information.

To update an existing graph:

1. Right-click the graph you want to update; then, select Reconfigure from the menu
that appears. The Graph Reconfigure Wizard appears.

2. Update any of the following settings, as desired:

„ Parameters used by the graph


„ Options such as logarithmic axes, grid lines, and legends

„ Which jobs to use for data to display in the graph

For more information on these options, see “Creating a Graph for a Component,”
on page 77.

iSIGHT-FD Runtime Gateway Guide


86 Chapter 2 Using Graphs, Tables, and Visualization Tools

Changing Graph Options


Once a graph is created, you can adjust certain options without recreating the graph,
including the legend, its location, and the way parameter names are displayed.

To update an existing graph:


1. Right-click the graph you want to update; then, select Edit Options from the menu
that appears. The Options Editor dialog box appears.

2. Alter any of the following options in the Options area, as desired:

„ Logarithmic X Axis and Logarithmic Y Axis. These options allow you to


change the numeric scaling of either axis to be logarithmic (i.e., in magnitudes
of 10). Using these options may assist you in seeing all the data points when
the data in the graph is displayed in varying degrees of magnitude.

„ Show grid lines. When selected, this option allows the graph to display grid
lines.
Note: These options will vary depending on the type of graph you selected. The
area containing these options is not displayed in the previous example (since they
are not available for a Contour Graph).

3. In the Legend Options area, click the Show Legend check box if you’d like a
legend displayed with your graph; then, select the legend’s location with respect to
the graph.

4. Set the Include Failed Runs check box. When selected, any failed runs are
included in the graph.

5. Click OK to save your changes and update the graph.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 87

Viewing Graph Information


The following information concerning the customizing options for graphs is contained
in this section:

„ “Manipulating Graphs” on this page

„ “Viewing Graph Data Based on Run Number” on this page

„ “Viewing Data Set Information,” on page 89


„ “Selecting Points in Graphs,” on page 91

„ “Using Zooming Options,” on page 92

„ “Resizing and Aligning Graphs,” on page 92

„ “Rotating Graphs,” on page 93

Manipulating Graphs
You can move graphs around, display them in separate windows, and enlarge them. To
manipulate graphs in this manner:

„ To move a graph: Click the graph and drag your mouse. You can move the graph to
any location on the current page.

„ To display a graph in a separate window: Click the button on the graph. A new
window, which is independent of the Runtime Gateway, is created.

„ To enlarge a graph: Click any edge of the graph window, and drag it with your
mouse.

Viewing Graph Data Based on Run Number


You can scroll through the graph information based on individual run numbers using
the Run Number scroll bar. This scroll bar is located at the bottom of the Runtime
Gateway, beneath the graph visualization area.

iSIGHT-FD Runtime Gateway Guide


88 Chapter 2 Using Graphs, Tables, and Visualization Tools

An example of the Run Number scroll bar is shown below.

You can perform any of the following actions with the scroll bar and its associated
options, as desired:

„ Use the buttons to move forward or backward by one run number.

„ Determine the behavior of the scroll bar when using the control. When the
icon is displayed, the displayed run number is not updated until the control is
clicked, moved, and released. When the icon is displayed, the displayed run
number is updated as the control is moved. Clicking the current icon changes
the setting to the other option.
„ Use the text box to the right of the scroll bar to determine a specific run number to
display.

„ Click the button to have the Runtime Gateway automatically scroll through each
run number, starting with the one currently selected for viewing. You can stop this
automation at any time using the button.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 89

Viewing Data Set Information


When a component executes within multiple nested process components, there are
multiple Data Sets that can be used to present the results for that component. For
example, consider a model that executes a DOE (100 runs) study around 5 different
baseline points (managed by a Loop) as shown below.

When reviewing the history of the Simcode results, typically you will want to see the
results relative to each execution of the DOE (a set of 100 runs). In this case, “Data
Set” controls are provided for selecting and navigating through the multiple data sets (5
different sets in this example).

As mentioned, Data Sets are created when a process component (Optimization, DOE,
etc.) is placed within another process component’s workflow. Each run of the outer
process component produces a different Data Set for each run of the inner process
component. It should be noted that all graphs for DOE and Monte Carlo are only valid
for a given single Data Set.

You can scroll through the available Data Sets using the Data Set scroll bar, which
appears below the graph visualization area, and above the Run Number scroll bar. This

iSIGHT-FD Runtime Gateway Guide


90 Chapter 2 Using Graphs, Tables, and Visualization Tools

area also tells you the number of total Data Sets available, and lets you easily change
the displayed Data Set(s).

Note: The Data Set scroll bar is not visible if only one Data Set exists.

An example of the Data Set scroll bar is shown below.

You can perform any of the following actions with the scroll bar and its associated
options, as desired:

„ Use the buttons to move forward or backward by one Data Set.


„ Use the text box to the right of the scroll bar to determine a specific Data Set
number to display.
„ Use the button to the right of the scroll bar to determine which Data Set to display.
The following options are available:
„ All. This options shows all Data Sets simultaneously.

„ Particular Data Set. This option shows only data from the selected Data Set.

„ Choose. This option allows you to manually select a Data Set by directly
entering the number is the text box that appears when the option is selected.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 91

„ You can lock and unlock the graphs, which impacts which Data Sets are displayed.
When the graphs are locked (the icon is displayed), graphs that are capable of
displaying all Data Sets simultaneously will ignore additional Data Set selections.
When unlocked (the icon is displayed), the graphs display the selected Data Set.
You can change between locked and unlocked graphs by clicking the currently
displayed icon.

„ Click the button to have the Runtime Gateway automatically scroll through each
Data Set, starting with the one currently selected for viewing. You can stop this
automation at any time using the button.

Selecting Points in Graphs


Numerous options are available for selecting points on a graph. These options are
displayed to the left of the graph display area (between the graphs and the Model
Explorer). Selecting a point or points on one graph automatically highlights the same
point on all other graphs and corresponding rows on tables (when applicable).

Note: Not all options are available with each type of graph. If the options are not
available with the currently selected graph, the buttons are disabled.

The following options are available:

„ . This option allows you to highlight a specific point with crosshairs.

„ . This option allows you to highlight a specific point with a color. You can

specify the color by clicking the .

„ . This option allows you to highlight a range of points with a color. You can

specify the color by clicking the .

„ . This option allows you to clear any color coded points, and it resets all graphs
to their original colors.

„ . This option allows you to pan a graph. Once selected, simply click a graph
and move your mouse. The graph is moved in a similar manner.

iSIGHT-FD Runtime Gateway Guide


92 Chapter 2 Using Graphs, Tables, and Visualization Tools

„ . This option allows you to zoom in on a selection within a graph. Once this
button is clicked, clicking and dragging within a graph creates a subarea, which is
outlined. Releasing the mouse button zooms in on the specified area. You can reset
any zoom using the button.

„ . This option allows you to rotate a three-dimensional graph. Once selected,


simply click a graph and move your mouse. The graph is rotated in a similar
manner.

Using Zooming Options


Some graphs give you the ability to focus on sections of data using zoom options.
These zoom options are not available with all graphs. If the options are not available
with the currently selected graph, the buttons are grayed out.

The following zoom options are available with some graphs:

„ . This option zooms in on the currently selected graph.

„ . This option zooms out on the currently selected graph.

„ . This option resets a graph zoom to its original orientation. You can also
right-click the graph; then, select Reset from the menu that appears.

Resizing and Aligning Graphs


You can automatically resize all graphs currently created. You can also automatically
align graphs based on the tiled layout. To resize and align graphs:

„ . This option allows you to increase the size of every graph displayed on the
current tab. Any tables are also increased.

„ . This option allows you to decrease the size of every graph displayed on the
current tab. Any tables are also decreased.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 93

„ . This option allows you to reset all graphs to their default size. Any tables are
also reset.

„ . This option allows you to align graphs in a tiled layout. For example, if you
create two graphs, and one graph is placed slightly below the other graph, this
button brings the top of both graphs into line. Any tables are also aligned.

Rotating Graphs
You can rotate three-dimensional graphs to view them from different angles. To rotate
a three-dimensional graph:

„ . This option allows you to rotate along the x-axis. The number in the
corresponding text box represents the current position of the axis in degrees.

„ . This option allows you to rotate along the y-axis. The number in the
corresponding text box represents the current position of the axis in degrees.

„ . This option allows you to rotate along the z-axis. The number in the
corresponding text box represents the current position of the axis in degrees.

„ . This option resets any custom rotation to the original orientation.

Exporting Graph Data


You can export graph data from the Runtime Gateway to an image file, a text file, or to
Microsoft Excel.

To export graph data:

1. Right-click the graph whose data you want to export. A menu appears.

iSIGHT-FD Runtime Gateway Guide


94 Chapter 2 Using Graphs, Tables, and Visualization Tools

2. Click the Export option; then, select one of the following options:

„ Export to Image. This option allows you to save the graph as an *.jpeg, *.jpg,
or *.png file, based on the extension you provide along with the file name.
Simply navigate to the directory that will store the image file, and type a file
name, with proper extension, in the File Name text box; then, click Save. The
file is saved and can be accessed with any image viewing software.

„ Export to Text File. This option allows you to save the graph data as
numerous types of text files, based on the extension you provide along with the
file name. Simply navigate to the directory that will store the text file, and type
a file name, with proper extension, in the File Name text box; then, click Save.
The file is saved and can be accessed with the text editor of your choice.

„ Export to Excel. This option immediately exports the graph to an Excel


spreadsheet and displays it. From this point, you can manipulate the graph, as
desired, using Excel. However, it should be noted that there are some
limitations with regard to exporting graph data to Excel. These limitations are
as follows:

• Excel has a 64 kilobyte row limit which may impact your ability to export a
graph.
• Array Graphs: Excel evenly spaces the data points on the x axis for this
graph type.
• 3D Scatter Plots: Excel does not support this graph type. If attempted, the
data points are exported, but a graph is not created.

Copying a Graph
You can copy both the image of a graph and the data contained within a graph, and use
either in an application outside of the Runtime Gateway.

iSIGHT-FD Runtime Gateway Guide


Using Graphs 95

To copy a graph:

1. Right-click the graph you want to copy. A menu appears.

2. Click Copy; then, select one of the following options:

„ Copy Image. This option allows you to copy the graph exactly as it appears in
the Runtime Gateway.

„ Copy Data. This option allows you to copy the data displayed in the graph and
then use it in another application (such as Excel), where it is presented in its
raw format.

Normalizing a Graph
You have the option of normalizing a Parallel Coordinate graph. This feature scales all
of the parameter ranges from 0...1.

For example, if you have two variables, one whose value range is 700 to 2000 and
another that is -3.1 to -5.2, you can see these values as a percentage of the range. When
this feature is not used, the graph range is from -5.2 to 2000, and all of the first
parameter’s lines will be near the top of the graph, at the same time, the second
parameter value appears to be a single point at the bottom of that scale.

To normalize a Parallel Coordinate graph:

1. Right-click the graph you want to normalize. A menu appears.

2. Click the Normalize option. The graph is updated.

3. (optional) Return the graph to its previous state by right-clicking it; then, select
Denormalize from the menu that appears.

Deleting Graphs
To delete a graph, simply click the button.

iSIGHT-FD Runtime Gateway Guide


96 Chapter 2 Using Graphs, Tables, and Visualization Tools

Using Tables
Tables can be created prior to execution on the Design Gateway (refer to the
iSIGHT-FD User’s Guide) or following execution (as described in this section). Tables
are updated periodically during execution. However, it is only after execution is
complete that all relevant information is displayed in a table.

Tables created on the Design Gateway Graphs Templates tab are saved with the model.
Tables created on the Runtime Gateway Graphs tab are not saved with the model.

This section is divided into the following topics:

„ “Creating a Table for a Component” on this page


„ “Updating an Existing Table,” on page 101
„ “Viewing Table Information,” on page 102
„ “Customizing a Table,” on page 104
„ “Exporting Table Data,” on page 105
„ “Copying Table Data,” on page 106
„ “Deleting Tables,” on page 106

Creating a Table for a Component


Tables are created using the Graphs tab on the Runtime Gateway.

To create a table:

1. Select the component whose data you want to add to a table on the left side of the
Runtime Gateway; then, click the Graph tab.

iSIGHT-FD Runtime Gateway Guide


Using Tables 97

The contents of the tab appear, with the selected component’s name displayed at
the top of the tab.

Important: You must select the proper component on the left side of the Runtime
Gateway (the Model Explorer section) prior to creating a table.

2. Verify that the proper page is selected at the bottom of the tab. By default, Page 1 is
used. However, you can create multiple pages using the <New> tab.

3. Click the Table button . If you have chosen a component that has the specialized
tables option (DOE or Monte Carlo), the Table Creation Wizard appears, and the
Table Chooser information is displayed. If no specialized tables are available, the
component parameters are displayed. You should continue to step 6.

iSIGHT-FD Runtime Gateway Guide


98 Chapter 2 Using Graphs, Tables, and Visualization Tools

In the following example, Monte Carlo tables are displayed.

4. Select the type of table you want to create. The following options are available:
„ Parameters Table. This table is available for all components, and is created
by default if no other table options are available. It creates a table for the
selected parameters.

„ Coefficients Table. This table is available for the DOE component only. It
creates a table of the coefficients calculated from regression analysis on the
data set for a given response.

„ Correlation Coefficients Table. This table is available for the Monte Carlo
component only. It creates a table containing linear correlation coefficients for
the Monte Carlo responses.
„ Probability Table. This table is available for the Monte Carlo component
only. It creates a Probability Table for the Monte Carlo responses with limits
specified.

„ Response Percentiles Table. This table is available for the Monte Carlo
component only. It creates a table of response values at specified percentiles
for the Monte Carlo responses.

„ Statistics Table. This table is available for the Monte Carlo component only. It
creates a Statistics Table for the Monte Carlo parameters.

iSIGHT-FD Runtime Gateway Guide


Using Tables 99

5. Click Next. The component parameters are displayed. If the Table Chooser screen
does not appear (as in step 3), this information is shown immediately after clicking
the Table button.

6. Verify that the desired parameters are visible. You can change the displayed
parameters using the Show Parameter For drop-down list.

7. Determine if you want file parameters included in your parameter selection (if you
use the Select drop-down list) using the Include Files check box.

8. Click the parameters that you want to include in the table. You can select
parameters individually or in groups using the Select drop-down list, which allows
you to automatically select all input parameters, output parameters, local
parameters, or every listed parameter.

Note: Which parameters are selected may be impacted by how you set the Include
Files option in step 7. For example, if you clear (unselect) this check box and select
All from the Select drop-down list, all parameter except displayed file parameter
are highlighted.

9. Click Next.

iSIGHT-FD Runtime Gateway Guide


100 Chapter 2 Using Graphs, Tables, and Visualization Tools

The Creation Summary information is displayed.

10. Review the information on the Summary tab.

11. Click the Job Selection tab. The contents of the tab appear.

12. Determine which job information will be used to create the table. You can use the
recently executed job (Active Job) or all jobs that are loaded in the current session
(All Loaded Jobs). For more information on using jobs, see “Working With Jobs,”
on page 36.

iSIGHT-FD Runtime Gateway Guide


Using Tables 101

13. Click Finish. Your table is added to the Runtime Gateway.

Updating an Existing Table


Once a table has been created, you can update it, including changing the parameters
used to create the table and job selection information.

To update an existing table:


1. Right-click the table you want to update; then, select Reconfigure from the menu
that appears. The Table Reconfigure Wizard appears.

2. Update any of the following settings, as desired:

„ Parameters displayed in the table

„ Which jobs to use for data to display in the table

For more information on these options, see “Creating a Table for a Component,”
on page 96.

iSIGHT-FD Runtime Gateway Guide


102 Chapter 2 Using Graphs, Tables, and Visualization Tools

Viewing Table Information


Once you create a table, you have several options available for viewing the
information. Proceed to one of the following sections for more details:

„ “Understanding Displayed Columns” on this page

„ “Selecting Points in Tables” on this page

„ “Sorting Table Data” on this page


„ “Filtering Table Data,” on page 103

„ “Viewing Table Data Based on Run Number,” on page 103

Understanding Displayed Columns


The first column in a table indicates if the run was successful. If the run is successful, a
symbol appears in the column. If the run was not successful, a symbol
appears in the column. If an approximation was executed instead of the actual
component, a symbol appears in the column.

The next columns (before the parameter values) show the run for each component. The
components are shown in relation to one another. The root is always run once.

Selecting Points in Tables


Selecting a point or points on one table (clicking a particular row) automatically
highlights the row corresponding to the same point on all other tables and
corresponding points on all other graphs (when applicable).

Sorting Table Data


Once a table has been created, you can sort the data it contains. You can sort in
ascending or descending order for any parameter by clicking that parameter’s column
header. The first click sorts in Ascending order. The second click sorts in Descending
order. A third click returns you to the original non-sorted option. The small arrow icons
to the right of the column headings shows you the current sorting option selected.

iSIGHT-FD Runtime Gateway Guide


Using Tables 103

Filtering Table Data


If you are working with a large number of parameters in a table, and only want to view
certain subsets of those parameters, you can use the filter options to change the
displayed parameters. For more information on using this feature, see “Filtering the
Data,” on page 60.

Viewing Table Data Based on Run Number


You can scroll through the table information based on individual run numbers using the
Run Number scroll bar. This scroll bar is located at the bottom of the Runtime
Gateway, beneath the table visualization area.

An example of the Run Number scroll bar is shown below.

You can perform any of the following actions with the scroll bar and its associated
options, as desired:

„ Use the buttons to move forward or backward by one run number.

„ Determine the behavior of the scroll bar when using the control. When the
icon is displayed, the displayed run number is not updated until the control is

iSIGHT-FD Runtime Gateway Guide


104 Chapter 2 Using Graphs, Tables, and Visualization Tools

clicked, moved, and released. When the icon is displayed, the displayed run
number is updated as the control is moved. Clicking the current icon changes
the setting to the other option.

„ Use the text box to the right of the scroll bar to determine a specific run number to
display.

„ Click the button to have the Runtime Gateway automatically scroll through each
run number, starting with the one currently selected for viewing. You can stop this
automation at any time using the button.

Customizing a Table
The following information concerning the customizing options for tables is contained
in this section:

„ “Manipulating Tables” on this page

„ “Resizing and Aligning Tables,” on page 105

Manipulating Tables
You can move tables around, display them in separate windows, and enlarge them. To
manipulate tables in this manner:
„ To move a table: Click the table and drag your mouse. You can move the table to
any location on the current page.

„ To display a table in a separate window: Click the button on the table. A new
window, which is independent of the Runtime Gateway, is created.
„ To enlarge a table: Click any edge of the table window, and drag it with your
mouse.

iSIGHT-FD Runtime Gateway Guide


Using Tables 105

Resizing and Aligning Tables


You can automatically resize all tables currently created. You can also automatically
align tables based on the tiled layout. To resize and align tables:

„ . This option allows you to increase the size of every table displayed on the
current tab. Any graphs are also increased.

„ . This option allows you to decrease the size of every table displayed on the
current tab. Any graphs are also decreased.

„ . This option allows you to reset all tables to their default size. Any graphs are
also reset.

„ . This option allows you to align tables in a tiled layout. For example, if you
create two tables, and one table is placed slightly below the other table, this button
brings the top of both tables into line. Any graphs are also aligned.

Exporting Table Data


You can export table data from the Runtime Gateway to either a text file or to
Microsoft Excel.

To export table data:

1. Right-click the table whose data you want to export. A menu appears.

2. Click the Export option; then, select one of the following options:
„ Export to Text File. This option allows you to save the table data as numerous
types of text files, based on the extension you provide along with the file name.
Simply navigate to the directory that will store the text file, and type a file
name, with proper extension, in the File Name text box; then, click Save. The
file is saved and can be accessed with the text editor of your choice.

„ Export to Excel. This option immediately exports the table to an Excel


spreadsheet and displays it. From this point, you can manipulate the table, as
desired, using Excel.

iSIGHT-FD Runtime Gateway Guide


106 Chapter 2 Using Graphs, Tables, and Visualization Tools

Copying Table Data


You can copy either portions of a table or the entire contents of a table for use in an
application outside of the Runtime Gateway.

To copy table data:


1. Perform one of the following actions:

„ To copy the entire contents of the table; proceed to step 3.

„ To copy portions of the table; proceed to step 2.


2. Select the table row(s) that you want to copy.

3. Right-click the table whose data you want to copy. A menu appears.

4. Click Copy; then, select one of the following options, based on your choice in
step 1:

„ Copy Selected. This option allows you to copy only specified rows in the
table.

„ Copy All. This option allows you to copy all of the data in the selected table.

Once copied, table data can be used in another application (such as Excel), where it
is presented in its raw format.

Deleting Tables
To delete a table, simply click the button.

iSIGHT-FD Runtime Gateway Guide


Using the Correlation Map 107

Using the Correlation Map


Given the large sets of data that iSIGHT-FD can work with, it can be very time
consuming to sort the relevance of particular parameters. The Correlation Map is a
post-processing aid that calculates the rank and linear correlation values of every pair
of parameters in a given model. The Correlation Map can provide a bird’s eye view of
the parameters and their relations to one another.

This tool provides several benefits including:

„ Illustrates how the system works via its data flow

„ Identifies areas of redundancy

„ Identifies weak points

„ Identifies the rules that govern the performance of the system

The Correlation Map allows you to make decisions to focus the efforts of your design
team on the parameters that have the most effect on a desired outcome.

This section is divided into the following topics:

„ “Accessing the Correlation Map” on this page

„ “Viewing the Data,” on page 109

„ “Working with the Filter Options,” on page 111

Accessing the Correlation Map


To access the Correlation Map from the Runtime Gateway:

1. Access the Runtime Gateway. Typically, the Runtime Gateway appears


automatically after you execute a model using the Design Gateway. For
information on other ways to start the Runtime Gateway, see “Using the Runtime
Gateway,” on page 16.

2. Select the component you want to examine on the left side of the Runtime
Gateway; then, click the Graphs tab.

iSIGHT-FD Runtime Gateway Guide


108 Chapter 2 Using Graphs, Tables, and Visualization Tools

The contents of the tab appear with the selected component’s name displayed at the
top of the tab.

Important: You must select the desired component on the left side of the Runtime
Gateway (the Model Explorer section) prior to creating a graph.

3. Verify that the proper page is selected at the bottom of the tab. By default, Page 1 is
used. However, you can create multiple pages using the <New> tab.

4. Click the button.

iSIGHT-FD Runtime Gateway Guide


Using the Correlation Map 109

The Correlation Map dialog box appears based on the results of the previously run
model.

5. Proceed to “Viewing the Data” on this page for more information on how to read
the data displayed on this dialog box.

Viewing the Data


The graph in the center of the interface is the heart of the Correlation Map. The labeled
nodes down the diagonal are the parameters used by the model. The inputs are located
in the upper left half and the outputs are located in the lower right. Connecting pairs of
these parameters together are the edges that represent a correlation. If the edge is in the
upper right half then there is a direct correlation; while the edges in the lower left
indicate an indirect correlation. The lines are further subdivided, with the strongest half
represented as a solid line and the weaker half as a dashed line. When the mouse
hovers over one of these correlation edges, the two parameters related and their linear
and rank correlation values are displayed in the lower left corner.

Note: The icons are the same as used in the Design Gateway. For more information
about the Design Gateway, refer to the iSIGHT-FD User’s Guide.

iSIGHT-FD Runtime Gateway Guide


110 Chapter 2 Using Graphs, Tables, and Visualization Tools

To select a parameter, simply click it. To select multiple parameters, click a parameter;
then, hold down the <shift> or <ctrl> keys while selecting other parameters.

The toolbar on the left side of the interface provides the main controls for viewing the
data. The following buttons are available:

„ . This option displays a bar graph for every parameter that is selected and puts
that graph on a new tab. The bar graph displays the top ten parameters of the
opposite mode that are correlated with the parameter in question. If no parameters
are selected, a parameter chooser is generated.

„ . This option displays a 2D scatter plot for every unique pair of parameters
selected (so at least two must be selected); and then places the plot on a new tab.
The scatter plot is based on the raw data from the model. Therefore, any given
point shows the two parameter’s values at a particular run. If no parameters are
selected, a parameter chooser is generated.

„ . This option displays a 3D scatter plot for every unique set of three parameters
selected (so at least three must be selected); and then places the plot on a new tab.
The scatter plot is based on the raw data from the model. Therefore, any given
point shows the three parameters’ values at a particular run. If no parameters are
selected, a parameter chooser is generated.

Note: Excel does not support 3D scatter plots. If attempted, the data points are
exported, but a graph is not created.

„ . When a graph tab is selected, this button will delete that graph. This option
does not work with Correlation Maps; therefore, it is not initially enabled.

„ . This option zooms in on the Correlation Map.

„ . This option zooms out on the Correlation Map.

„ . This option fits the Correlation Map in the window.

„ . This option copies the map or graph image of any tab to the clipboard.

„ . This option saves any tab to a file. The graph tabs are opened directly in Excel.
The Correlation Map itself can be saved only as a JPEG (image) file.

iSIGHT-FD Runtime Gateway Guide


Using the Correlation Map 111

Right-clicking on the Correlation Map displays a menu with the following options:

„ Toggle Pan Mode. This option provides an easy way to navigate the Correlation
Map using the mouse (click and drag).

„ Toggle Labels. This option shows and hides the parameter labels.
„ Center Graph. This option centers the Correlation Map in the window.

„ Fit to Window. This option fits the Correlation Map in the window.

Note: Large Correlation Maps may not fit in the window.

„ Copy. This option copies the Correlation Map to the clipboard.

„ Export Image to File. This option saves the Correlation Map to a JPEG (image)
file.

„ Export Data to File. This option saves the data generated in the current
Correlation Map to a text file.
„ Advanced Filter Options. This option gives you access to the Advanced Filter
Options. For more information about the Advanced Filter Options, see “Working
with the Filter Options” on this page.

Working with the Filter Options


Changing the cutoff value changes the correlations that are displayed. The correlations
are ranked from -1 to 1. The sign of the value indicates whether the correlations are
direct (+) or indirect (-); while the value indicates the strengths (0 is the lowest, +/-1 is
the highest). The cutoff value indicates the minimum absolute value of the correlations
to display. For example, a cutoff value of 0.5 will display all the correlations greater
than 0.5 and less than -0.5.

You can change the Cutoff Value by updating the value in the Cutoff Value text box.
You can also use the slider adjacent to the box to adjust the value. The Redraw While
Sliding check box allows you to view your changes while sliding the ruler. If Redraw
While Sliding is not selected, then your changes won’t appear until after you release
the mouse button. The check box is not selected by default.

The advanced filter options allow you to filter parameters and includes an option that
aids readability.

iSIGHT-FD Runtime Gateway Guide


112 Chapter 2 Using Graphs, Tables, and Visualization Tools

To access the advanced filter options:

1. Click the Advanced Filter Options button at the bottom of the interface.

The filter dialog box appears.

From here, you can do one of the following:

„ Show only those Parameters that have some relation. While the next two
options are mutually exclusive (you must choose one or the other); this option
applies to all situations. If selected, the Correlation Map draws the parameters
that have no correlations above that cutoff value. This option is enabled by
default.

„ Restrict to only this Parameter and those related to it. This option takes the
parameters you select from the drop-down list and the cutoff value into
account. The Correlation Map displays all the correlations that involved your
selection and are greater than the cutoff value.

„ Permit only these Parameters to be displayed. This option takes the


parameters you select from the list below this option and the cutoff value into
account. The Correlation Map shows only the correlations that involve the
parameters that were selected and greater than the cutoff value. All parameters
are selected by default.

2. Click OK to save your filtering options. The Correlation Map changes based on
the parameters selected.

iSIGHT-FD Runtime Gateway Guide


Using the Engineering Data Mining Tool 113

Using the Engineering Data Mining Tool


The iSIGHT-FD Engineering Data Mining (EDM) tool provides an effective way to
view many designs (inputs and corresponding outputs) and view the relationships and
trends among those designs. More specifically, the tool provides post-processing
functionality for multi-objective optimization by analyzing the results and effectively
visualizing Pareto solutions and sorting (screening) the data interactively. The
multi-objective technique provided in iSIGHT-FD is NSGA-II. For more information
on this technique, refer to the iSIGHT-FD User’s Guide.

The tool allows you to create and manipulate two main types of graphs:

„ Multi-variable and multi-response plots. These plots facilitate Multi-Criteria


Decision Making. All of the responses can be compared on one graph, and
interactive screening capability from response values exists.

„ Two-dimensional Pareto plots. These plots create two-dimensional correlations


between inputs and outputs. In both types of graphs, Pareto solutions are
highlighted (when they exist).

Proceed to one of the following sections for more information on using this tool:

„ “Accessing EDM from the Runtime Gateway” on this page

„ “Starting EDM in Standalone Mode and Selecting Data,” on page 117

„ “Viewing the Data,” on page 121

„ “Changing the Selected Parameters,” on page 123

„ “Viewing and Manipulating Scatter Plots,” on page 124

Accessing EDM from the Runtime Gateway


When accessed from the Runtime Gateway, the necessary data is loaded from the
selected parameters.

iSIGHT-FD Runtime Gateway Guide


114 Chapter 2 Using Graphs, Tables, and Visualization Tools

To access Engineering Data Mining from the Runtime Gateway:

1. Access the Runtime Gateway. Typically, the Runtime Gateway appears


automatically after you execute a model using the Design Gateway. For
information on other ways to start the Runtime Gateway, see “Using the Runtime
Gateway,” on page 16.
2. Select the component you want to examine on the left side of the Runtime
Gateway; then, click the Graphs tab.
The contents of the tab appear with the selected component’s name displayed at the
top of the tab.

Important: You must select the desired component on the left side of the Runtime
Gateway (the Model Explorer section) prior to creating a graph.

3. Verify that the proper page is selected at the bottom of the tab. By default, Page 1 is
used. However, you can create multiple pages using the <New> tab.

4. Click the EDM button .

iSIGHT-FD Runtime Gateway Guide


Using the Engineering Data Mining Tool 115

The Engineering Data Mining Creation Wizard dialog box appears.

5. Click the parameters that you want to graph as input parameters, using the list in
the Input Parameters area. You can select parameters individually or in groups
using the Select drop-down list, which allows you to automatically select all input
parameters, output parameters, local parameters, or every listed parameter.

6. Click the parameters that you want to graph as input parameters, using the list in
the Output Parameters area. You can select parameters individually or in groups
using the Select drop-down list, which allows you to automatically select all input
parameters, output parameters, local parameters, or every listed parameter.

7. Click Finish.

iSIGHT-FD Runtime Gateway Guide


116 Chapter 2 Using Graphs, Tables, and Visualization Tools

The Engineering Data Mining Tool dialog box appears, and the information is
loaded into the interface.

8. Proceed to “Viewing the Data,” on page 121 for more information on how to read
the data displayed on this dialog box.

iSIGHT-FD Runtime Gateway Guide


Using the Engineering Data Mining Tool 117

Starting EDM in Standalone Mode and Selecting


Data
When accessed in Standalone Mode, the necessary data is loaded from the selected
files.

Note: Engineering Data Mining requires access to a local Library. If you have not
accessed the Design Gateway prior to using EDM in Standalone mode, you many not
have a valid Library yet, and EDM will not work.

To start the Engineering Data Mining tool and select the data it will use:

1. From a command prompt, navigate to the iSIGHT-FD installation directory (if


necessary); then, execute the edm executable file. This file is located in one of the
following directories, based on your operating system:
„ Windows: <isight-fd_install_directory>\bin\win32

„ UNIX/Linux: <isight-fd_install_directory>/bin

The Logon dialog box appears.

2. Select Standalone from the Connection profile drop-down list.

3. Click OK.

iSIGHT-FD Runtime Gateway Guide


118 Chapter 2 Using Graphs, Tables, and Visualization Tools

The Engineering Data Mining Tool dialog box appears.

4. Select Open Data File... from the File menu, or click the button on the
Engineering Data Mining Tool toolbar.

iSIGHT-FD Runtime Gateway Guide


Using the Engineering Data Mining Tool 119

The File and Parameters Wizard appears.

5. Select the database file for your problem using the Browse... button next to the
corresponding text box. This file must contain the following information in the
specified format:

„ Each row represents a data point (set of input and output parameter values)
separated by spaces or tabs.

„ Each column represents a parameter.

„ If provided, a header row may supply the name of the parameters


corresponding to the columns of data beneath it (otherwise, generic names of
"column#" are assigned).

A typical standard database file would be similar to the following example:

Length Width Area Mass


2.0 4.0 8.0 700
2.2 5.0 11.0 820

Note: A practical limitation on the number of design points that can be loaded is
around 5000 (depending on your system’s memory and processor speed). Beyond
this amount, you will begin to witness performance degradation.

iSIGHT-FD Runtime Gateway Guide


120 Chapter 2 Using Graphs, Tables, and Visualization Tools

6. (optional) Select the Pareto file for your problem using the Browse... button next
to the corresponding text box. This file consists of Pareto solutions to be overlaid
on top of the full data set, typically produced by a multi-objective optimization
technique. It contains the following information: run counter, design variables,
responses, and generation number.

7. Click Next. The Define Parameters screen appears.

The parameters are read from the database file specified in step 5

8. Select the parameters you want to use as inputs for your graphs from the Available

Parameters list on the left side of the screen; then, use the buttons to define
them as Input or Output parameters.

Note: If you incorrectly select a parameter, or add it to the wrong list (Inputs or

Outputs), select the parameter; then, click the button to return it to the
Available Parameters list.

9. (optional) Use the and buttons to rearrange the selected parameters in the
Inputs and Outputs areas. This order defines the order in which the parameters
appear in the graphs and tables.

10. Click Finish.

iSIGHT-FD Runtime Gateway Guide


Using the Engineering Data Mining Tool 121

The information from the data file and Pareto file (if specified) is loaded into the
Engineering Data Mining Tool.

11. Proceed to “Viewing the Data” on this page for more information on how to read
the data displayed on this dialog box.

Viewing the Data


The two graphs on the Engineering Data Mining Tool dialog box display your input
and output parameter information for each run in the specified database file.

The graph consists of all inputs and outputs (depending on the graph you are viewing)
displayed across the x-axis, with each value found in the database file for each variable

iSIGHT-FD Runtime Gateway Guide


122 Chapter 2 Using Graphs, Tables, and Visualization Tools

displayed in increasing order above that variable. Variable values for each input or
output are linked by a sequential line graph to represent each design point. The initial
values for normalization are the maximum and minimum values located in all of the
samples. You can change these values at a later time.

A table is displayed below each graph showing the current values of your inputs and
outputs. Several options appear at the bottom of the dialog box and allow you to
manipulate the order and range of the displayed parameters.

To view the data displayed on the Engineering Data Mining Tool:

1 Run your mouse pointer over items in either the Inputs area or the Outputs area.
Information that corresponds to the selected point is displayed in all other areas of
the dialog box.

2. Set the View Pareto Only check button at the top of the dialog box (if available).
By default, the graphs on the Data View dialog box display all points found in the
iSIGHT-FD database file. If a Pareto file is also specified, the View Pareto Data
Only check button is displayed. Activating this check button filters out all
non-Pareto data points so that graphs only display the Pareto solutions.

Note: You can also select Pareto Data from the View menu if you are using the
tool in standalone mode.

3. Set the Normalize Data check box.

Note: You can also select Normalize Data from the View menu if you are using
the tool in standalone mode.

Based on your selection, the following actions occur:

„ If checked, the data for each input and output is normalized by the range of the
data. The data for all input and outputs is then displayed across the full vertical
range of the graphs.

„ If not checked, the resulting range of the graphs is based on the smallest and
largest values of all the input or output parameters. In this case, if one
parameter range is between 1 and 100, and another parameter range is 1 to 10,
the second parameter is displayed over only 10 percent of the vertical range of
the graph. This option allows the inputs or outputs to be compared by
magnitude and range.

iSIGHT-FD Runtime Gateway Guide


Using the Engineering Data Mining Tool 123

4. Alter the information displayed in the tables using any of the following options:

„ Directly modify the Lower or Upper value for any parameter in the table to
filter the data points that are displayed.

„ Set the sort options for the data in the tables by clicking the Sort by drop-down
list and selecting which responses to base the sort on (currently, only the Run

Number option is available); then, click the button to


determine the order of your sort. You can sort in ascending or descending
order.

„ Use the buttons to move between runs. The text box shows you the run
whose data is currently being displayed.

„ (optional) Click the Reset button to return the values in the table to their
default setting.

Note: You can also select Reset Data from the View menu if you are using the
tool in standalone mode.
5. Save a data point by clicking the point in either of the two graphs (you can also use

the button to select the currently highlighted point); then, click the
button on the toolbar.

Note: If you are using EDM in Standalone mode, you can also select Save Data
Point... from the File menu. For more information, see “Starting EDM in
Standalone Mode and Selecting Data,” on page 117.
Once you specify the name and location, the parameter information for the selected
point is saved in a text file (in a <name>:<value> format).

Changing the Selected Parameters


After you have defined the parameters that Engineering Data Mining will use and
viewed the information, you can change the parameter settings that you defined earlier
and view the updated information.

iSIGHT-FD Runtime Gateway Guide


124 Chapter 2 Using Graphs, Tables, and Visualization Tools

To change the parameters selected for use by the EDM tool:

1. Click the button on the Engineering Data Mining Tool toolbar. The Select
Inputs/Outputs to Show dialog box appears.

2. Perform any of the following actions, as desired:

„ Make any desired changes to the list of inputs and outputs as described in
step 8 on page 120.

„ Rearrange the parameters in the Inputs and Outputs list using the and
buttons.

3. Click OK to save your changes and return to the main EDM interface. You graphs
and tables are updated based on your changes.

Viewing and Manipulating Scatter Plots


You can select numerous combinations of scatter plots to display your results.

1. Click the button on the Engineering Data Mining Tool toolbar.


Note: You can also select Scatter Plots from the View menu if you are using the
tool in standalone mode.

iSIGHT-FD Runtime Gateway Guide


Using the Engineering Data Mining Tool 125

The Scatter Plots and Select Graphs dialog boxes appear. The Select Graphs dialog
box allows you to choose which plots to display.

This dialog box shows scatter plots for all combinations of two outputs. The graphs
on the so-called main diagonal are the frequency plots for each of the responses.
They show how many data points fall in every fraction of the total range of values
of the response.
Note: All data points found in the database file are displayed in all graphs unless
the View Pareto Only check box is activated on the Engineering Data Mining Tool
dialog box, in which case only the Pareto solution data points will be displayed.

This dialog box also:

„ provides a single view of all of the combinations of outputs


„ allows you to select a set of graphs to view in greater detail on the Scatter Plots
dialog box
„ allows you to swap the x and y axes for every graph by switching between the
upper and lower versions of the same graph (above and below the main
diagonal)

iSIGHT-FD Runtime Gateway Guide


126 Chapter 2 Using Graphs, Tables, and Visualization Tools

2. Perform any of the following actions, as desired:

„ Click the Select Upper Triangle button to highlight all of the plots that appear
in the upper right portion of the Select Plots dialog box.

„ Click the Deselect All Scatter Plots button to clear all selected plots.

„ Click individual plots to select them for viewing. Remember, if you select a
plot in the lower portion of the dialog box, the corresponding plot in the upper
portion is unselected (since you are simply changing which parameter will
appear on the x and y axes).

3. Click OK to save your changes and populate the Scatter Plots dialog box.

iSIGHT-FD Runtime Gateway Guide


Using the Engineering Data Mining Tool 127

4 Alter the way the plots are displayed, if desired, using the # of Columns text box.
When you enter a number in this text box and hit the Enter key, the number of
columns is updated, and the dialog box changes accordingly.

5 Perform any of the following actions on a plot:

„ Run your mouse pointer over items in the plot. A design point is highlighted in
all scatter plots, and information that corresponds to the selected point is
displayed on the Engineering Data Mining Tool dialog box.

Note: Moving your mouse pointer over either graph in the Engineering Data
Mining Tool dialog box also highlights the design in all of your scatter plots.
„ To copy a graph, right-click the graph; then, select Copy from the menu that
appears.

6. To change the set of plots displayed, click the Select Plots button; then, return to
step 2 on page 126 for complete instructions.
7. Click the Close button. You are returned to the Engineering Data Mining Tool
dialog box.

iSIGHT-FD Runtime Gateway Guide


128 Chapter 2 Using Graphs, Tables, and Visualization Tools

iSIGHT-FD Runtime Gateway Guide


129

3 Runtime Gateway Reference


Information

This chapter provides reference information related to the Runtime Gateway interface.
It is divided into the following sections:

„ “Introduction,” on page 130

„ “Menu Options,” on page 130

„ “Toolbar Buttons and Options,” on page 135


„ “Setting Options in the Runtime Gateway File,” on page 136

„ “Keyboard Shortcuts,” on page 137

„ “Command Line Options,” on page 140

iSIGHT-FD Runtime Gateway Guide


130 Chapter 3 Runtime Gateway Reference Information

Introduction
This section contains reference information about menu options, toolbar buttons, and
command line options. Some sections (mainly the menu and toolbar sections) are only
as a quick reference, and does not necessarily describe how to use the options.

This section is divided into the following parts:

„ “Menu Options” on this page

„ “Toolbar Buttons and Options,” on page 135

„ “Setting Options in the Runtime Gateway File,” on page 136

„ “Keyboard Shortcuts,” on page 137

„ “Command Line Options,” on page 140

Menu Options
The following tables describe the options available from each menu on the Runtime
Gateway, including the menu option name, the icon that represents the action (if one
exists), the toolbar button that performs the same action (if one exists), and the action
description. Proceed to one of the following sections:
„ “File Menu,” on page 131

„ “Edit Menu,” on page 132

„ “Run Menu,” on page 132

„ “View Menu,” on page 133

„ “Window Menu,” on page 134

„ “Help Menu,” on page 134

iSIGHT-FD Runtime Gateway Guide


Menu Options 131

File Menu
The following table (Table 3-1) describes options available from the Runtime Gateway
File menu.

Table 3-1. File Menu Options

Option Icon Toolbar Action


Button
Open from Disk... Allows you to open a job from your
computer’s hard drive. For more
information see “Opening a Model From the
Disk,” on page 19.
Open from Library... Allows you to open a job from the current
Library. For more information, see
“Opening a Model From a Library,” on
page 20.
Load Job from Allows you to open a job from the local or
Database... ACS database (depending on your
connection) using the Select Job dialog box.
For more information, see “Opening a Job
From a Database,” on page 37.
Save Saves the current model, with the same file
name, to the local disk as a *.zmf file.
Save As... Allows you to save the current model (*.zmf
file) with a new file name.
Publish... Allows you to publish a model to the
Library. For more information, refer to the
iSIGHT-FD User’s Guide.
Save Results to Disk... Allows you to save your job results to a file.
For more information, see “Saving Results,”
on page 69.
(Recently Used Files) A list of recently used models is displayed,
which allows quick access to these files.
Close Window Closes the Runtime Gateway.
Exit Closes all iSIGHT-FD interfaces.

iSIGHT-FD Runtime Gateway Guide


132 Chapter 3 Runtime Gateway Reference Information

Edit Menu
The following table (Table 3-2) describes options available from the Runtime Gateway
Edit menu.

Table 3-2. Edit Menu Options

Option Icon Action


Preferences Allows you to set options for different iSIGHT-FD interfaces
and some components. For more information on using
preferences, see “Setting Preferences,” on page 29. The
preferences accessed are the same as those accessed using
the Design Gateway.

Run Menu
The following table (Table 3-3) describes options available from the Runtime Gateway
Run menu.

Table 3-3. Run Menu Options

Option Icon Toolbar Action


Button
Run Model This action executes the entire model.
The action is automatically performed if
only the Run button is clicked (instead of
the associated menu).
Run (Selected Component) This action executes only the selected
component.
Configure and Run Model This action executes the entire model,
but offers additional options prior to
execution. For more information, see
“Using the Configure and Run Options,”
on page 24.

iSIGHT-FD Runtime Gateway Guide


Menu Options 133

Table 3-3. Run Menu Options (cont.)

Option Icon Toolbar Action


Button
Configure and Run (Selected This action executes the selected
Component) component, but offers additional options
prior to execution. For more information,
see “Using the Configure and Run
Options,” on page 24.
Test Locally If you are connected to an ACS in the
FIPER environment, this option opens a
submenu that allows you to execute a
model locally using options similar to
those described above.

View Menu
The following table (Table 3-4) describes options available from the Runtime Gateway
View menu.

Table 3-4. View Menu Options

Option Icon Action


Dataflow When activated, displays the Dataflow tab on the Runtime Gateway.
By default, this option is deactivated. For more information, see
“Viewing the Dataflow,” on page 68.
Summary When activated, displays the Summary tab on the Runtime Gateway.
By default, this option is activated. For more information, see
“Viewing the Summary,” on page 63.
Log When activated, displays the Log tab on the Runtime Gateway. By
default, this option is activated. For more information, see “Using the
Logs,” on page 64.

iSIGHT-FD Runtime Gateway Guide


134 Chapter 3 Runtime Gateway Reference Information

Window Menu
The following table (Table 3-5) describes options available from the Runtime Gateway
Window menu.

Table 3-5. Window Menu Options

Option Icon Action


(Current Open This list shows all currently open models in the Runtime
Models List) Gateway. You can use this menu to move between different
models.
Unload Jobs... This option allows you to remove jobs from your system’s
memory. For more information, see “Removing Jobs From
Memory,” on page 42.

Help Menu
The following table (Table 3-6) describes options available from the Runtime Gateway
Help menu.

Table 3-6. Help Menu Options

Option Icon Action


Contents Opens the iSIGHT-FD Runtime Gateway online help. If you have
any trouble accessing the online help, refer to the iSIGHT-FD User’s
Guide for information on supported help platforms.
About Displays information about iSIGHT-FD, as well as contact
information.

iSIGHT-FD Runtime Gateway Guide


Toolbar Buttons and Options 135

Toolbar Buttons and Options


The following table (Table 3-7) describes buttons and options available from the
Runtime Gateway Toolbar.

Table 3-7. Toolbar Buttons

Button Action
Allows you to open a job from your computer’s
hard drive.
Allows you to save the current job with a new
file name.
Allows you to save your job results to a file. For
more information, see “Saving Results,” on
page 69.
Allows you to open a job from the local or ACS
database (depending on your connection) using
the Select Job dialog box. For more information,
see “Opening a Job From a Database,” on
page 37.
This button runs the job using the ACS or in
Standalone mode, based on the type of
connection. Clicking the down arrow to the right
of the button accesses additional execution
options. For more information, see “Controlling
Execution,” on page 24.
The Job Name drop-down list. It allows you to
select a specific job.
Execution Status. It displays the status of your
current execution. It also displays a Run
Counter, which specifies how many runs have
been executed (left side number), and how many
runs will be executed (right side number)
This button stops the current job.

iSIGHT-FD Runtime Gateway Guide


136 Chapter 3 Runtime Gateway Reference Information

Table 3-7. Toolbar Buttons (cont.)

Button Action
This button pauses the current job.

This button allows you to re-execute a job that


failed during execution. For more information,
see “Re-executing Failed Jobs,” on page 40.

Setting Options in the Runtime Gateway File


The following options are similar to the command line options. However, they are set
in the rt_gateway.bat file (rt_gateway file on UNIX) and are set
automatically when the file is executed. These options may be particularly useful if
you always log in using the same connection profile, user name, and password.

Note: Some of these options have matching command line arguments, while some do
not.

These options should be added at the end of the set JVMParms= entry in the
rt_gateway.bat (rt_gateway) file. You can also set these options directly in
the FIPER_JVMPARMS environment variable.

Note: Be sure to leave a space between this argument and the last one currently on the
line.

„ -Dfiper.gateway.modelToLoad=MODEL.zmf. This setting allows you to


define a model that will be loaded with the Runtime Gateway.

„ -Dfiper.runtimeGateway.log=runtimeGateway.log. This setting


allows you to specify the log file for the Runtime Gateway.

„ -Dfiper.logon.profile=PROFILE. This settings allows you to specify the


connection profile.

iSIGHT-FD Runtime Gateway Guide


Keyboard Shortcuts 137

„ -Dfiper.logon.prop.user=USER. This setting allows you to specify the


user name.

„ -Dfiper.logon.prop.pw=PASSWORD. This setting allows you to specify


the password.

„ -Dfiper.logon.prompt=yes|no. This settings allows you to specify


whether or not the Logon dialog box appears when the Runtime Gateway is
started.

„ -Dfiper.gateway.executeModelLocally=true. This setting allows


you to tell the Runtime Gateway to execute the loaded model locally.

„ -Dfiper.gateway.executeModelRemotely=true. This setting allows


you to tell the Runtime Gateway to execute the loaded model using an ACS.

„ -Dfiper.gateway.quitAfterExecution=true. This setting allows


you to have the Runtime Gateway close automatically following execution.

Keyboard Shortcuts
This section describes keyboard shortcuts available when using the Runtime Gateway.
Proceed to one of the following topics for more information:
„ “Runtime Gateway Keyboard Shortcuts,” on page 138

„ “Using Keyboard Shortcuts on HP-UX,” on page 139

iSIGHT-FD Runtime Gateway Guide


138 Chapter 3 Runtime Gateway Reference Information

Runtime Gateway Keyboard Shortcuts


The following table lists the keyboard shortcuts available from the Runtime Gateway.
The shortcuts work when the Runtime Gateway is the active window.

Table 3-8. Runtime Gateway Keyboard Shortcuts

Menu Text Mnemonic Accelerator


File F
Open from Disk... O Ctrl-O
Open from Library... L Ctrl-Shift-O
Load Job from Database... J Ctrl-J
Save S Ctrl-S
Save As... A F12
Publish... U Ctrl-U
Save Results to Disk R Ctrl-D
Close Window W Ctrl-W
Exit x

Edit
Preferences P Alt-N

Run R
Run Model (Local) L F4
Run Model (ACS) M F5
Run Component (Local) N Shift-F4
Run Component (ACS) U Shift-F5
Config and Run Model G Alt-Shift-F4
(Local)
Config and Run Model F Alt-Shift-F5
(ACS)
Config and Run Component O Ctrl-Shift-F4
(Local)
Config and Run Component I Ctrl-Shift-F5
(ACS)

iSIGHT-FD Runtime Gateway Guide


Keyboard Shortcuts 139

Table 3-8. Runtime Gateway Keyboard Shortcuts (cont.)

Menu Text Mnemonic Accelerator


View V
Dataflow D
Summary S
Log L

Window W
Unload Jobs... U

Help H
Contents C F1
About A

Using Keyboard Shortcuts on HP-UX


Several keyboard shortcuts do not work on the HP-UX operating system without
making some modifications to the default key mappings. In general, you must modify
the key mappings so that Alt_L and Alt_R are no longer synonymous with Meta_L and
Meta_R.

To update the key mappings to work with iSIGHT-FD:

1. Open a terminal window.

2. Execute the following commands, using the xmodmap command to change the
key mappings:
xmodmap -e "keysym Alt_L = Alt_L"
xmodmap -e "keysym Alt_R = Alt_R"
xmodmap -e "clear Mod1"
xmodmap -e "add Mod1 = Alt_L"
xmodmap -e "add Mod1 = Alt_R"

iSIGHT-FD Runtime Gateway Guide


140 Chapter 3 Runtime Gateway Reference Information

3. Close the terminal window; then, verify that the shortcuts listed below function
properly:

„ Alt-F opens the File menu.


„ Alt-E opens the Edit menu.
„ Alt-R opens the Run menu.
„ Alt-V opens the View menu.
„ Alt-W opens the Window menu.
„ Alt-H opens the Help menu.

Command Line Options


Several command line options can be used in conjunction with the rt_gateway
command at the command prompt:

Note: Arguments with a value may be specified using either of the following methods
(tag is case-insensitive):

„ tag:VALUE. For example: rt_gateway model:i_beam.zmf


„ -tag VALUE. For example: rt_gateway -model i_beam.zmf

The following commands are available:

„ <no_argument>. Not specifying an argument with the rt_gateway command


simply opens the Runtime Gateway with no model loaded.

„ -config. This argument prompts you to configure your model before executing,
allowing you to do such things as update parameter values or customize the job
name. The argument must be used with the run option. For more information, see
“Using the Configure and Run Options,” on page 24.

„ input:<nv_file>. This argument allows you to configure model inputs from the
specified name-value file. The argument must be used with the run option.

„ -help. This argument prints information about the available command line
arguments and then exits.

iSIGHT-FD Runtime Gateway Guide


Command Line Options 141

„ -l <locale>. This argument sets the local (language environment) for the current
session. It is useful only when testing support for a language. For example, typing
rt_gateway -1 de_DE displays all messages in German.

„ logfile. This argument allows you to specify a file name and location for the
iSIGHT-FD log file.

„ loglevel. This argument allows you to determine what information is sent to


your iSIGHT-FD log file. Components create different levels of log messages. You
can define the minimum log information setting (debug), and you will receive
information on that particular level, and all other levels above it. For more
information on log levels, see “Setting Gateway Preferences,” on page 30. The
following log levels are available:

„ syserror
„ error
„ warning
„ info
„ debug

„ logonprompt:[yes|no]. This argument allows you to specify if the Logon


dialog box appears when the Runtime Gateway is executed. If you use this
argument to stop the Logon dialog box from appearing (the no option), you must
specify a profile name, user name and password using the arguments in this list.
Failure to specify this information will cause the Runtime Gateway to cancel the
logon and exit due to the error.
„ <model_name>.zmf. This argument allows you to specify a particular model that
will be loaded into the Runtime Gateway.
„ profile:<connection_profile_file_name>. This argument allows you to specify
the connection profile that the Runtime Gateway will use. If you only specify this
argument, the Logon dialog box will appear, and you’ll have to specify the name
and password for the connection profile. If you receive an error that the connection
profile cannot be found, use a full path to the profile. For example:
gateway profile:\progra~1\engineous\isight-fd_2.5\
standalone.cpr
„ pw:<password>. This argument allows you to specify the password of the user
that will log into the Runtime Gateway when connecting to an ACS in the FIPER
environment. It is not used for the desktop (Standalone) connections. If you only

iSIGHT-FD Runtime Gateway Guide


142 Chapter 3 Runtime Gateway Reference Information

specify this argument, the Logon dialog box will appear, but the password will
already be defined.

„ run:[local|remote]. This argument allows you to execute the specified model


either locally (the local option) or on an ACS in the FIPER environment (the
remote option).
„ tab. This argument allows you to specify which tab is selected when the Runtime
Gateway appears. The following options are available:
„ Parameters
„ History
„ Graphs
„ Workflow
„ Summary
„ Logs

„ tree. This argument allows you to specify which component is selected on the
model explorer (on the left side of the interface) when the Runtime Gateway
appears.
„ -q. This argument allows you to tell the Runtime Gateway to automatically close
after execution. It is only useful when combined with the -xl or -xr arguments.
„ user:<user_id>. This argument allows you to specify the user that will log on to
use the Runtime Gateway when connecting to an ACS in the FIPER environment.
It is not used for the desktop (Standalone) connections. If you only specify this
argument, the Logon dialog box will appear, but the user name will already be
defined.

„ -xl. This argument allows you to run a model locally as soon as the interface
opens. It requires the use of the -m option described above.

„ -xr. This argument allows you to run a model on an ACS as soon as the interface
opens. It requires the use of the -m option described above.
Windows Users: Use the command rt_gateway.bat -help instead of
rt_gateway -help.

iSIGHT-FD Runtime Gateway Guide


143

Index

A D
ACS connection profile 72 data sets 89
annotations 50 dataflow tab 68
approximations 56, 102 Design of Experiments (DOE) 84
area graph 78 DOE, viewing information 54
array graph 78 dynamic arrays, using 58

C E
command line options 140 engineering data mining
component info area 26 accessing
configure and run option 25 from Runtime Gateway 113
contour graph 78 Standalone mode 117
contour grid graph 78 graph types 113
contour matrix graph 78 introduction 113
copying parameters, changing 123
graphs 94 Pareto data 122
tables 106 scatter plots 124
correlation map viewing data 121
accessing 107 exporting
benefits 107 graph data 93
filtering 111 table data 105
overview 107
viewing data 109
cumulative distribution graph 83
cumulative frequency 78
customizing graphs 87

iSIGHT-FD Runtime Gateway Guide


144 Index

F J
filtering data, history tab 60 job details area 66
fit type 84 jobs
frequency graph 79 custom names, creating 25, 41
definition 24, 36
deleting 48
location of database 36
G opening database 37
overview 36
graph/table explorer 23 permissions (ACS only) 36, 43
graphs removing from memory 42
copying 94 selecting 42
customizing 87 stopping jobs that are running 39
data sets, viewing 89 jobs database, accessing 37
deleting 95
exporting data 93
normalizing 95
run number scroll bar 87 K
updating 85
graphs tab 27 keyboard shortcuts 138

H L
history graph 79, 84 line graph 79, 85
history tab log file
dynamic arrays 58 accessing 66
filtering data 60 copying contents 67
initializing from a prior run 57 e-mailing 67
overview 27 log filter 65
using 55 log tab, viewing 65
logging level button 25

I
M
image graph 79
initializing a model from a prior run 57 main effects graph 84
menu bar 23

iSIGHT-FD Runtime Gateway Guide


Index 145

messages area 66
model explorer 23
R
models
changes 16 re-executing a failed job
opening 19 overview 40
Monte Carlo graphs 83 purpose and limitations 40
Monte Carlo, viewing information 55 runtime gateway 26
select job dialog box 40
rerun (re-execute) button 26, 41
resizable arrays, using 58
run number scroll bar 87, 103
N run option 25

normalizing, graphs 95

S
O scatter plot 2D 84
scatter plot 2D graph 79
optimization 84 scatter plot 2D grid graph 79
optimization 2D scatter plot 85 scatter plot 3D 84
optimization 3D scatter plot 85 scatter plot 3D graph 79
optimization, viewing information 54 server information button 23
shortcuts, keyboard 138
show bars as 83
stop button 26
P summary tab 28
surface graph 79
parallel coordinate graph 79
parameters tab 27, 52
Pareto plot
overview 84 T
regression analysis order 83, 84
show bars as option 84 tables
terms to show option 83, 84 copying 106
pause button 26 customizing 104
permissions, jobs 43 deleting 106
preferences, setting 29 exporting data 105
probability distribution 83 filtering data 103
purpose of interface 16, 76 run number scroll bar 103
sorting data 102

iSIGHT-FD Runtime Gateway Guide


146 Index

specialty types 98
types 98
V
updating 101
tabs 23 value graph 79, 85
tool bar 23 view run button 52

U W
updating existing graphs 86 workflow
updating graphs options 49
logarithmic X axis and logarithmic Y axis tab 28
options 81, 86 workflow annotations 50
show grid lines option 81, 86 workflow image, saving 50

iSIGHT-FD Runtime Gateway Guide