In a broad way, the execution of a simulation in GeMA can be seen as being composed by the execution of a series of processes that exchange data between them, cooperating to achieve the desired final result.

The orchestration script is the tool for the user to specify which processes should be executed. Written in the Lua language, it defines, through series of function calls and language constructions (loops, conditions, etc), the order in which processes will be executed during the simulations, thus providing its main loop.

Documentation for the available processes are described in each process plugin documentation. Besides calling process methods, several functions provided by the GeMA framework itself are available at the orchestration script. Those functions allow the user to query and modify most of the simulation objects. In particular, they provide access to every information stored on mesh nodes, cells or Gauss points. Their documentation can be found on the Orchestration Reference page.

There must be exactly one orchestration script on the simulation file, given by the ProcessScript() function.

Example

function ProcessScript()
  -- Solve the simulation using the FEM process
  fem.solve({'HeatPhysics'}, 'solver')
  -- Print results
  print('Calculated results:')
  io.printMeshNodeData('meshName', {'coordinate', 'T'})
  -- Save results to a file
  io.saveMeshFile('meshName', './fileName', 'nf', {'T'})
end