The Exploration Task

Basics

The EplorationTask is a keyTask in the OpenMole framework.

Endeed this Task embed a Sampling. The Sampling will provide to the Exploration Task an array of combination of Prototypes at the runtime. This way all the Tasks located after the Exploration Task in the workflow (ie connected to it with a Transition) will be replicated with a different set of Prototypes values. Let us remind you the figure presented in the Concepts :

In this representation, a Task containing my model will be generated 3 times : once for each value givent by the Sampling (1,2 and 3). Note that in this example there is only one Prototype myVar, but you can take as many Prototypes as you want and combine it according to the Sampling algorithms proposed in OpenMole (Complete, LHS, …).

Creation

To create an Exploration :

> create first a Sampling (see the Sampling section)
> select Task > Exploration Task in the top menu
> give it a name
> select the Sampling you previously created in the proposed combo box
> click on create

Your Exploration Task is ready to use.

Note that you will see all the Prototypes used in the associated Sampling defined as implicit output Prototypes of the Task (switch to the Prototype view). Indeed, all the Prototypes defined in the Sampling will be used later in the workflow (to parametrize the inputs of your models for instance) and are then made available for the next Task.

Example

Let use create simple Mole with an Exploration Task and a dummy Groovy Task :

> create 2 Double Prototypes p1 and p2
> create a Complete sampling with the previous 2 Prototypes on ranges [1;3] and [4;6]
> create an Exploration Task and select the Sampling previously builtNote that if you switch to the Prototype view, the two implicit Prototypes have been added.
> create a dummy Groovy Task, which only displays the two Prototypes
> add both Prototypes as input of the Groovy Task
> add both Tasks on the scene (right click on the scene)
> Ensure that the Exploration Task myExplo is the starting capsule (the input slot is green rather than yellow). If not, right click on this task and select Define as starting capsule
> draw an Transition between the two Tasks (keep the Shift key pressed and drag an arrow from the myExplo Task to the input slot of the groovyTask Task)
> the Mole is now ready to be run : press the build Button
> the execution shows up in a new tab. Switch to the Execution progress view and press the play button

> the Mole is run and you can see the following output :

As you can see, the Complete Sampling has been played. Therefore the groovyTask Task has been executed 9 times (3 x 3) with 9 different couple of parameters.