ISIS-Fish Development

Simulation Launcher

This module is used to launch a simulation, or set of simulations, using ISIS-Fish scripts (see Scripts) applied to a
region that has been set up (see Defining regions).

Introduction

The simulation launcher has a set of tabs for configuring and launching a simulation or set of simulations.

Parameters – for setting the basic simulation parameters (name, description, region, strategies, initial
populations, rules, number of months to simulate) as well as for launching the simulation process.

Pre simulation script – for defining a pre-simulation script which will be executed to modify the database before
any simulations are run. This tab is activated when Use pre simulation script is checked in the parameters window.

Simulation plan – for defining a simulation plan to carry out multiple simulations. This tab is activated when
Use simulation plan is checked in the parameters window.

Optimization – for defining the objective function, the optimization method, exported values and observations.
This tab is activated when Use optimization method is checked in the parameters window.

Results export – for selecting scripts for exporting results.

Result choice – for selecting results to be kept for viewing in the Results window.

Advanced parameters – for setting parameters such as the simulator to be used, cache control, trace levels and
Free parameters than can be used in rules, the simulator, etc.

If a rule or export script requires a result that is not selected, then the result required is added automatically to
the list results selected.

When a simulation is run, the local timestamp, yyyy-mm-dd-hh-mm, is added to the simulation name.

The user interface

Window layout

The Simulation menu

Save simulation parameters – to save the all the simulation parameters for future use.

The tabs for selecting the various pages for setting the simulation parameters

The contents of each tab

The status area

Parameters tab

The Parameters tab is used for setting the basic simulation parameters.

Load old simulation – This lists all the simulations executed locally. The list is empty when ISIS-Fish is executed
for the first time. When a simulation is run successfully, it will be added to this list the next time ISIS-Fish is
run.

Filter – Filter for the list of simulations.

Refresh list – Cancels the current simulation filter and refreshes the list of simulations.

Simulation name – The name of the simulation.

If you load a previous simulation, the name will appear here.

A new simulation can be created easily from a previous simulation by changing the name.

Description – The description of the simulation.

If you load a previous simulation, the description will appear here.

Region – Select the region for the simulation.

Loading the region will fill in the list of strategies and the list of populations.

Always select the region before defining the rules as these are linked to the objects in the region.

Strategies – When the region has been loaded, all the strategies defined for the region will be listed here. The
strategies selected in this list will be used by the simulator.

Populations – When the region has been loaded, all the populations defined for the region will be listed here.

When a population is selected, the initial counts for age or length groups in each population zone are displayed in
the table, Item 9.

These are used to initialize the simulator.

Initial population – This table holds the initial counts for each age or length group in each zone for the
population selected.

Number of months – This specifies the period over which the simulation is carried out.

Use pre simulation script – Activates, or deactivates, the Pre simulation script tab and the script.

Check the box to specify a pre-simulation script. The Pre simulation script tab will be activated and selected for
editing the script (see below).

To deactivate the pre-simulation script, uncheck the box. The Pre simulation script tab will also be deactivated.

Use simulation plan – Activates, or deactivates, the Simulation plan tab and the plans.

Check the box to specify one or more simulation plans. The Simulation plan tab will be activated and selected for
selecting and parameterizing the simulation plans (see below).

To deactivate the simulation plans, uncheck the box. The Simulation plan tab will also be deactivated.

Use Optimization method – Activates, or deactivates, the Optimization tab and the optimization method.

Check the box to specify that optimization is required. The Optimization tab will be activated and selected for
selecting the objective function, optimization method and parameters (see below).

To deactivate optimization, uncheck the box. The Optimization tab will also be deactivated.

Simulation launcher – Specifies where the simulations will be run:

in subprocess – the simulations will be run in subprocesses. If several simulations are run at the same time, each
will run in its own subprocess and so, potentially, each in parallel on a separate core.

on Caparmor server – the simulations will be run on the Ifremer Caparmor supercomputer.
See Installing ISIS-Fish on Caparmor for details of the configuration required.

in current process – the simulations will be run in the current process.

Save simulation parameters – The simulation parameters can be saved for a future simulation. This has the same
effect as the menu Simulation / Save simulation parameters.

Available rules – This is a list of rules that have been defined in ISIS-Fish.

Each rule is followed by its description.

Selected rules – This is the list of rules that have been selected for the simulation.

Each rule is followed by its description.

When a rule is selected in this list, the parameters are displayed in the table below.

Add – Adds the rules selected in the Available rules, Item 10, to the Selected rules, Item 11.

As each rule is added, a dialog box is displayed for setting the parameters.

Remove – Removes the rules selected from the Selected rules, Item 11.

Clear – Removes all the rules from the Selected rules, Item 11.

Rule parameters – When a rule in the Selected rules list is selected, the parameters are displayed in this table
and may be modified.

When you move the pointer over a parameter name, a tooltip will appear with the description of the parameter.