Orchestration Reference

The orchestration script is the heart and soul for the execution of a GeMA simulation and one of the main reasons for its flexibility. 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.

The most important building blocks for the orchestration are the methods provided by processes. Those are documented by the plugins providing the specific processes. Available process documentation can be found on the Plugin Reference page and also on the tutorial on how to build a GeMA simulation model.

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.

If the monitor server is active, and cancelation requests are enabled, the monitor application can issue cancelation requests to stop the execution of the current simulation. Every process call, and each API method described in this reference, automatically does a cancelation check that can abort the execution of the orchestration script by raising a Lua error. Explicit cancelation checks can also be done by functions described in the global functions section.

The following pages present a reference manual with the syntax and some examples for each available function that can be used at the orchestration Lua script for querying and modifying model objects.

Global functions:

• Global variables
• Global functions

Model objects:

• Model data object methods

• Mesh object methods
• Cell object methods
• Cell geometry object methods

• Boundary condition object methods
• Contact boundary condition object methods
• Property Set object methods
• Node set object methods
• Cell boundary object methods
• Cell Group Set object methods

• Discontinuity set object methods
• Discontinuity object methods

• Spatial index object methods

Data objects:

• Value Info object methods
• Accessor object methods
• Matrix object methods
• Interpolation functions

Analysis objects:

• Integration Rule object methods
• Shape function object methods

Other objects and functions:

• Parallel calls
• State dumping object methods