16—Simulation Sequence Editor

16 Simulation Sequence Editor

The Simulation Sequence Editor provides full access to simulation sequences,
allowing you to:

• add and delete simulation sets

• edit the attributes of simulation sets

• select a subset of simulation runs to execute

The Simulation Sequence Editor appears instead of the Configure/Run DES

dialog box when the des.configuration_mode preference is set to “advanced”.
In addition, you can open a Simulation Sequence Editor at any time in the
following ways:

• To edit the simulation sequence for the current scenario—Click the Edit
Simulation Sequence… button in the detailed Configure/Run DES dialog
box.

• To open any existing simulation sequence—Choose File > Open…, select

Simulation Sequence in the “Files of type:” pull-down menu, and select the
desired Simulation Sequence from the file list.

• To create a new simulation sequence—Choose File > New… and select

Simulation Sequence in the pull-down menu.

The Simulation Sequence Editor contains a treeview listing the simulation sets
in the sequence. Simulation sets that contain multiple runs can be expanded to
show each run. If a set contains multiple runs, the area to the right of the
treeview shows the name of each attribute with multiple values and the attribute
values used for each run. Checkboxes next to each simulation set and run let
you specify which runs should be executed.

Figure 16-1 Simulation Sequence Editor

ER-16-1 OPNET Modeler/Release 16.1

 16—Simulation Sequence Editor

Menus
The Simulation Sequence Editor provides many operations for creating and
working with network models. You access these operations from the Simulation
Sequence Editor menu bar, which contains the following menus:

Table 16-1 Simulation Sequence Editor Menus

Menu Description Reference

File Contains operations that relate to high-level functions File Menu on

such as opening and closing projects, saving page ER-2-2
scenarios, importing models, and printing graphics
and reports

Edit Contains operations that allow you to edit the Edit Menu on
environment attributes that control program operation page ER-2-5
and to manipulate text and objects

Objects Contains operations that create objects within the Objects Menu on
Simulation Sequence Editor workspace page ER-16-3

Simulation Contains operations for running simulations and Simulation Menu on

viewing the DES log page ER-16-3

Windows Lists all open editor windows and allows you to make Windows Menu on
one active page ER-2-7

Help Provides access to context-sensitive help, the product Help Menu on

documentation and tutorials, and information about page ER-2-8
the program

In addition to the menu items, the Simulation Sequence Editor provides two
pop-up menus:

• Simulation Set Pop-Up Menu on page ER-16-4

• Simulation Run Pop-Up Menu on page ER-16-4

Note—The editor menus on your machine might vary from those described
here, particularly if there has been any UI customization or use of ETS.

OPNET Modeler/Release 16.1 ER-16-2

16—Simulation Sequence Editor

Objects Menu
The Objects menu includes an operation for creating objects in the Simulation
Sequence Editor workspace.

Table 16-2 Objects Menu Summary

Menu item Description Reference

Create Simulation Set Creates an object that defines the Create Simulation Set
attributes needed for one simulation on page ER-16-5
run (or for multiple runs, when a range
of values is defined)

Simulation Menu
The Simulation menu includes operations for running simulations and viewing
the DES log.

Table 16-3 Simulation Menu Summary

Menu item Description Reference

Run Simulation Executes the current simulation sequence. Run Simulation Sequence
Sequence on page ER-16-6

Open DES Log Displays the log of discrete event Open DES Log on
simulation errors and significant events. page ER-16-6

ER-16-3 OPNET Modeler/Release 16.1

 16—Simulation Sequence Editor

Pop-Up Menus
Simulation Set Pop-Up Menu
When you right-click on simulation set in the Simulation Sequence Editor
treeview, a pop-up menu with the following operations opens:

Table 16-4 Simulation Set Pop-Up Menu

Menu Item Description Reference

Edit Attributes Opens the Simulation Set dialog box for Edit Attributes on
configuring a simulation set. page ER-16-5

Execute All Runs in Set Begins executing every simulation run Execute… on
in the set. (This operation appears only page ER-16-6
when one or more runs are
unselected.)

Execute Selected Runs Begins executing only selected Execute… on

in Set simulation runs in the set. (This page ER-16-6
operation appears only when one or
more runs are selected.)

Show Set Info Shows a list containing the complete Show… Info on
configuration of the simulation set and page ER-16-7
any attribute values that vary across
runs.

Simulation Run Pop-Up Menu

When you right-click on simulation run in the Simulation Sequence Editor
treeview, a pop-up menu with the following operations opens:

Table 16-5 Simulation Run Pop-Up Menu

Menu Item Description Reference

Execute Run Begins executing the run. Execute… on

page ER-16-6

Show Run Info Shows a list containing the complete Show… Info on
configuration of the simulation run. page ER-16-7

Toolbar Buttons
The Simulation Sequence Editor has toolbar buttons for frequently-used
operations.

Figure 16-2 Toolbar Buttons (Simulation Sequence Editor)

1 2 3

OPNET Modeler/Release 16.1 ER-16-4

16—Simulation Sequence Editor

The following table lists the name of each toolbar button—the name appears as
a tooltip when you rest the cursor on the button—and its equivalent menu
command. To configure the toolbar buttons, see Configuring the Toolbar on
page ER-1-7.

Table 16-6 Toolbar Buttons in the Simulation Sequence Editor

Button Name in the Toolbar Equivalent Menu Command

1 Create Simulation Set Object Objects > Create Simulation Set

2 Execute Simulation Sequence Simulation > Run Simulation Sequence

3 Display Error and Simulation Event Simulation > Open DES Log
Information

Operations
This section describes the operations available on the various menus of the
Simulation Sequence Editor:

• Create Simulation Set

• Edit Attributes

• Execute…

• Open DES Log

• Run Simulation Sequence

• Show… Info

Create Simulation Set

This operation adds a new simulation set to the simulation sequence. The
attributes of a simulation set specify the configuration of one or more simulation
runs, including what statistics and animation data are collected during a run and
what outputs are generated. Other attributes determine the length of the
simulation run, the seed value for random number generation, and the values of
various promoted and user-defined attributes. To edit the attributes of a
simulation set, right-click on the set and choose Edit Attributes.

Edit Attributes
This operation lets you configure the attributes of a simulation set. It opens a
Simulation Set dialog box (similar to the detailed Configure/Run DES dialog
box).

For a description of the dialog box, see Configure/Run DES Dialog Box
(Detailed) on page ITG-3-94.

ER-16-5 OPNET Modeler/Release 16.1

 16—Simulation Sequence Editor

Execute…
The three Execute… operations on the Simulation Sequence Editor pop-up
menus all start one or more simulation runs, as follows:

• Execute All Runs in Set—Starts execution of every simulation run in the

simulation set that was right-clicked, whether or not the run is selected.

• Execute Run—Starts execution of the simulation run that was right-clicked.

• Execute Selected Runs in Set—Starts execution of every selected simulation

run in the simulation set that was right-clicked.

Open DES Log

This operation allows you to view the log of errors and significant simulation
events produced during a simulation. This simulation log is written to a
tab-delimited ASCII file. Because there can be many events in a simulation log,
a simulation log browser is provided so that you can view only those events of
interest to you.

For a description of the simulation log browser, see Open DES Log on
page ITG-3-19.

Run Simulation Sequence

This operation executes the current simulation sequence, as defined by the
attributes of the defined simulation sets. Only simulation sets and runs that are
selected in the treeview will be executed.

For more information, see Monitoring Simulation Progress on page ITG-3-101.

OPNET Modeler/Release 16.1 ER-16-6

16—Simulation Sequence Editor

Show… Info
The Show Run Info and Show Set Info operations on the Simulation Sequence
Editor pop-up menus open a window that displays information about the
configuration of the simulation set or run that was right-clicked. This information
includes the simulation invocation, contents of environment files, and all
attribute values. This information is available also by clicking the Preview
Simulation Sequence button in the Configure/Run DES dialog box.

Figure 16-3 Simulation Sequence Info Window

ER-16-7 OPNET Modeler/Release 16.1