Professional Documents
Culture Documents
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.
Windows is either a registered trademark or trademark of Microsoft Corporation in the United States and/
or other countries.
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.
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
Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Contacting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
United States and North America . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Japan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Korea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Germany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
United Kingdom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
France . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
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.
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.
Other Documentation
iSIGHT-FD Development Guide
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.
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.
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
Screen captures
Copies of logs
Japan
Telephone
Calling from within Japan 045.477.3300
Calling from outside Japan 81.45.477.3300
E-mail tech@engineous.co.jp
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
If you have suggestions for improvement, or wish to point out specific errors, please
send your comments to:
documentation@engineous.com
Documentation Suggestions
Engineous Software
Name
Title
Company
Address
Telephone number
Email address
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
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.
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.
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.
When you start an iSIGHT-FD interface, the Logon dialog box appears, allowing you
to determine your session environment.
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.
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:
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.
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.
In the following example, the I-beam example model has been selected.
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
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.
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.
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.
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.
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.
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.
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.
. 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.
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.
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.
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.
1. Select Preferences from the Edit menu. The iSIGHT-FD Preferences dialog box
appears.
“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.
General preferences
Parameter options
Execution
Sounds
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.
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.
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.
Type, Value, and Mode drop-down lists. When changes are made to a
parameter that is mapped to/from other parameters, iSIGHT-FD can
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.
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.
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.
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.
Approximations
File Directories
Mail Server
Local Results Database (MySQL)
Permissions (default settings)
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Note: You can access the same interface from the Design Gateway by selecting
Job Database from the View menu.
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.
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.
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.
For more information on opening jobs from the database, see “Opening a Job From a
Database,” on page 37.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
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 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.
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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.
Exporting the data on the tab to a text file or Microsoft Excel. For more
information, see “Exporting Graph Data,” on page 93.
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.
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.
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.
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.
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.
Note: The Data Exchanger, Excel, and Script components may resize arrays. For more
information, refer to the iSIGHT-FD User’s Guide.
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.
Note: You can also filter the data is tables created to display component parameter
information.
The appearance of your dialog box will differ based on the parameter displayed on
your History tab.
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).
Remove the defined filter, and return the parameter list to its original state, by
clicking the button.
The following example shows the summary of the Compute Stress Script in the I-Beam
model.
The following example shows the summary of the DOE in the SpringSamples model.
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).
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.
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.
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.
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:
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.
Screen captures
Click the Send button. An Engineous Software representative will contact you
about your problem as soon as possible.
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.
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,
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.
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.
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.
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.
Start the Runtime Gateway; then, when the Logon dialog box appears, click
the button.
• 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.
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.
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
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.
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.
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:
Array Graph. Creates a 2D Graph using two or more array parameters. Plots
one X array against one or more Y arrays.
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.
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.
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.
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.
Note: Some specialized graphs have additional options. For more information on
these options, see “Using Specialized Graphs,” on page 83.
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.
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.
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.
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.
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.
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.
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.
1. Right-click the graph you want to update; then, select Reconfigure from the menu
that appears. The Graph Reconfigure Wizard appears.
For more information on these options, see “Creating a Graph for a Component,”
on page 77.
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.
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.
You can perform any of the following actions with the scroll bar and its associated
options, as desired:
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.
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
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.
You can perform any of the following actions with the scroll bar and its associated
options, as desired:
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.
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.
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.
. This option allows you to highlight a specific point with a color. You can
. This option allows you to highlight a range of points with a color. You can
. 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.
. 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 resets a graph zoom to its original orientation. You can also
right-click the graph; then, select Reset from the menu that appears.
. 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.
. 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.
1. Right-click the graph whose data you want to export. A menu appears.
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.
• 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.
To copy a graph:
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.
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.
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.
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.
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.
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.
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.
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.
For more information on these options, see “Creating a Table for a Component,”
on page 96.
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 perform any of the following actions with the scroll bar and its associated
options, as desired:
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.
Customizing a Table
The following information concerning the customizing options for tables is contained
in this section:
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.
. 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.
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.
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.
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.
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.
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.
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.
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 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.
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.
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.
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.
1. Click the Advanced Filter Options button at the bottom of the interface.
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.
2. Click OK to save your filtering options. The Correlation Map changes based on
the parameters selected.
The tool allows you to create and manipulate two main types of graphs:
Proceed to one of the following sections for more information on using this tool:
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.
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.
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.
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:
UNIX/Linux: <isight-fd_install_directory>/bin
3. Click OK.
4. Select Open Data File... from the File menu, or click the button on the
Engineering Data Mining Tool toolbar.
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.
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.
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.
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.
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.
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
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.
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.
Note: You can also select Normalize Data from the View menu if you are using
the tool in standalone mode.
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.
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
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).
1. Click the button on the Engineering Data Mining Tool toolbar. The Select
Inputs/Outputs to Show dialog box appears.
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.
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.
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.
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.
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.
This chapter provides reference information related to the Runtime Gateway interface.
It is divided into the following sections:
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.
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
File Menu
The following table (Table 3-1) describes options available from the Runtime Gateway
File menu.
Edit Menu
The following table (Table 3-2) describes options available from the Runtime Gateway
Edit menu.
Run Menu
The following table (Table 3-3) describes options available from the Runtime Gateway
Run menu.
View Menu
The following table (Table 3-4) describes options available from the Runtime Gateway
View menu.
Window Menu
The following table (Table 3-5) describes options available from the Runtime Gateway
Window menu.
Help Menu
The following table (Table 3-6) describes options available from the Runtime Gateway
Help menu.
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.
Button Action
This button pauses the current job.
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.
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
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)
Window W
Unload Jobs... U
Help H
Contents C F1
About A
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"
3. Close the terminal window; then, verify that the shortcuts listed below function
properly:
Note: Arguments with a value may be specified using either of the following methods
(tag is case-insensitive):
-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.
-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.
syserror
error
warning
info
debug
specify this argument, the Logon dialog box will appear, but the password will
already be defined.
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.
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
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
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
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