ONELAB

Revision as of 13:42, 16 April 2015 by Geuzaine (talk | contribs) (Give it a try!)

Revision as of 13:42, 16 April 2015 by Geuzaine (talk | contribs) (Give it a try!)

ONELAB (Open Numerical Engineering LABoratory) is a lightweight interface to finite element software for engineering applications. It allows calling sequences of independent clients (e.g. mesh generators, finite element solvers and other related tools) and have them share parameters and modeling information.

Give it a try!

  1. Download and uncompress the ONELAB bundle for Windows64, Windows32, Linux64, Linux32 or MacOSX.
  2. Double-click on the Gmsh executable (gmsh.exe
    Error creating thumbnail: Unable to save thumbnail to destination
    on Windows).
  3. Load one of the models (.pro file) through the File/Open menu, e.g. inductor.pro in the model/inductor directory.
  4. Click on Run.
  5. ... that's it!

Use other clients

Try out native ONELAB clients:

  • GetDP: a finite element solver for electromagnetism, heat transfer, acoustics and generic PDEs
  • Gmsh: a mesh generator and post-processor (Gmsh also plays the role of ONELAB server)
  • Onelab/Mobile: a finite element package for iPhone, iPad and Android devices based on GetDP and Gmsh

Other clients (non-native) are interfaced with ONELAB by a system of input file pre-processing. The different steps of a simulation (meshing, solving, post-processing) are controlled by a python script. See worked-out examples with:

  • Elmer: a finite element solver for multi-physic problems developed by CSC
  • OpenFOAM: an open source CFD software package developed by OpenCFD

Other clients can be interfaced readily by following the above examples.

Finally, find here some useful hints to use efficiently the graphical front-end of ONELAB.

Develop your own client

Implement your own native ONELAB clients:

  • With Python: any Python code can become a native ONELAB client
  • With C++: how to create a native C++ ONELAB client

Technical information

The ONELAB interface is based on an abstraction of the interface to finite element solvers and related tools: for geometry modeling and meshing, for the definition of physical properties, constraints and other solver parameters, and for post-processing. It allows calling sequences of independent clients (e.g. mesh generators, finite element solvers and other related tools) and have them share parameters and modeling information.

The implementation is based on a client-server model, with a server-side database and (optional) graphical front-end, and local or remote clients communicating in-memory or through TCP/IP sockets. Contrary to most available solver interfaces, the ONELAB server has no a priori knowledge about any specifics (input file format, syntax, ...) of the clients. In practice, this is made possible by having any simulation preceded by an analysis phase, during which the clients are asked to upload their parameter set to the server.

Native ONELAB clients can be written in C++ or Python. For native clients the specification of which data to share is completely dynamic. For non-native clients, the ONELAB server can act as a pre-processor of their input files, which should be instrumented to specify the information to be shared. In all cases the issues of completeness and consistency of the parameter sets are completely dealt with on the client side: the role of ONELAB is limited to data centralization, modification and re-dispatching. The parameters can be controlled and displayed interactively using Gmsh.

The ONELAB project was funded by the Walloon Region under WIST3 grant n° 1017086.