TALOS Scripting Language

Posted on September 9, 2013 by sgun — 1 Comment ↓

TALOS Scripting Language is created for designing the super-system (system of multiple optimization models) on TALOS Computation Server.

Each global variable is declared and initialized with the keyword var.

var i = 0

var i = 0

Steps are initialized with step command. Steps are defined in the format: step {from}->{to} in which to represent the model that’s going to be run within this sequence. Steps are finalized with the command end step.

step dim1->dim2
...
end step

step dim1->dim2

...

end step

Two kinds of tasks are defined in TALOS Scripting Language: Global and Local (inside a step). These tasks are typically overriding or manipulating a global variable, (part of) data file and parameter with another asset. When it comes to using tabular data files, file name is written after the model name and dollar sign ‘$‘. And file sections are defined using square brackets ‘[ .. , .. ]‘ just after the file name.

Global tasks are defined with the keyword task.

task j<-0

task j<-0

Local tasks are defined with the keywords pretask and posttask inside a step. Pretasks are performed before running the model while posttasks are performed after the model run.

pretask dim1$arcDataExtern.csv[4,3]<-override(j)
posttask vPenTotal<-dim1$Z-best

1 2	pretask dim1$arcDataExtern.csv[4,3]<-override(j) posttask vPenTotal<-dim1$Z-best

Loops are defined with the command loop while(condition). And loop structure is finalized with end loop command. Nested loops are fully supported.

loop while(vPenn<15)
...
end loop

loop while(vPenn<15)

...

end loop

Super-system is run with the command run.

In order to save the super-system design the command write is used.

The command performJSON is used to run the super-system design previously saved.

Nothing is lost during the super-system runs on TALOS Computation Server. The command trace will display all previous and the present values of global variables.

Now let’s see a working script written in TALOS language.

#dim1&2 Exhaustive vPenn Calculation
var vPenTotal = 0
var best = 0
var i = 0, j = 0

step #start->dim1
pretask dim1$arcDataExtern.csv[4,3]<-override(1)
pretask dim1$arcDataExtern.csv[5,3]<-override(1)
posttask best<-dim1$Z
end step

loop while(i<2)
   task j<-0
   loop while(j<2)
      step #start->dim1
         pretask dim1$arcDataExtern.csv[4,3]<-override(i)
         pretask dim1$arcDataExtern.csv[5,3]<-override(j)
         posttask vPenTotal<-dim1$Z-best
         posttask inc(j)
      end step
   end loop
   task inc(i)
end loop
run

#dim1&2 Exhaustive vPenn Calculation

var vPenTotal = 0

var best = 0

var i = 0, j = 0

step #start->dim1

pretask dim1$arcDataExtern.csv[4,3]<-override(1)

pretask dim1$arcDataExtern.csv[5,3]<-override(1)

posttask best<-dim1$Z

end step

loop while(i<2)

task j<-0

loop while(j<2)

step #start->dim1

pretask dim1$arcDataExtern.csv[4,3]<-override(i)

pretask dim1$arcDataExtern.csv[5,3]<-override(j)

posttask vPenTotal<-dim1$Z-best

posttask inc(j)

end step

end loop

task inc(i)

end loop

run