Home
Scripts and Application Programming Interface (API)
CADFEKO and POSTFEKO have a powerful, fast, lightweight scripting language integrated into the application allowing you to create models, get hold of simulation results and model configuration information as well as manipulation of data and automate repetitive tasks.
Script Types
There are two types of scripts that are supported in Feko, API scripts and result scripts. POSTFEKO supports both types of scripts, while CADFEKO only supports API scripts. It is important to use the correct script type in POSTFEKO to ensure that the desired result is achieved.
Result Script
A result script (math script), perform actions similar to general scripts, but the script returns a result object for displaying on graphs and the 3D view in POSTFEKO.
Structure of a DataSet
In order to modify or generate a DataSet, it is important to understand how they are constructed.

Welcome
Release Notes
See what's new in the latest release.
Get Started
The Feko Getting Started Guide contains step-by-step instructions on how to get started with Feko.
Examples
The Feko Example Guide contains a collection of examples that teaches you Feko concepts and essentials.
Introduction to Feko
Feko is a comprehensive electromagnetic solver with multiple solution methods that is used for electromagnetic field analyses involving 3D objects of arbitrary shapes.
CADFEKO
CADFEKO is used to create and mesh the geometry or model mesh, specify the solution settings and calculation requests in a graphical environment.
POSTFEKO
POSTFEKO, the Feko post processor, is used to display the model (configuration and mesh), results on graphs and 3D views.
EDITFEKO
EDITFEKO is used to construct advanced models (both the geometry and solution requirements) using a high-level scripting language which includes loops and conditional statements.
Feko Solution Methods
One of the key features in Feko is that it includes a broad set of unique and hybridised solution methods. Effective use of Feko features requires an understanding of the available methods.
Optimisation in Feko
Feko offers state-of-the-art optimisation engines based on generic algorithm (GA) and other methods, which can be used to automatically optimise the design and determine the optimum solution.
Feko Utilities
The Feko utilities consist of PREFEKO, OPTFEKO, ADAPTFEKO, the Launcher utility, Updater and the crash reporter.
Description of the Output File of Feko
Feko writes all the results to an ASCII output file .out as well as a binary output file .bof for usage by POSTFEKO. Use the .out file to obtain additional information about the solution.
Feko Application Macros
A large collection of application macros are available for CADFEKO and POSTFEKO.
Scripts and Application Programming Interface (API)
CADFEKO and POSTFEKO have a powerful, fast, lightweight scripting language integrated into the application allowing you to create models, get hold of simulation results and model configuration information as well as manipulation of data and automate repetitive tasks.
- Introduction to Scripting and the API
  The scripting language that has been integrated with CADFEKO and POSTFEKO is called Lua. Lua has a syntax that is similar to Python and Matlab (or Octave) and is easy to learn and use.
- Script Editor
  The script editor allows you to create scripts based on the Lua language to control CADFEKO, POSTFEKO and other applications as well as manipulation of data to be viewed and analysed further in POSTFEKO.
- Macro Recording
  Use macro recording to record actions in a script. Play the script back to automate the process or view the script to learn the Lua-based scripting language by example. Macro recording allows you to perform repetitive actions faster and with less effort.
- Scripting Basics
  The scripting capability is powerful and help your work to be completed faster, but you first need to learn the basics of Lua and scripting in Feko.
- Script Types
  There are two types of scripts that are supported in Feko, API scripts and result scripts. POSTFEKO supports both types of scripts, while CADFEKO only supports API scripts. It is important to use the correct script type in POSTFEKO to ensure that the desired result is achieved.
  - General Scripts
    General or API scripts, are stored outside the POSTFEKO session and CADFEKO model as.lua files. These scripts are used by math scripts, but do not return data for visualisation. The script executes methods for controlling POSTFEKO or CADFEKO, for example, exporting all views as images, launching other applications, and reading and writing data to disk. Almost every aspect of POSTFEKO and CADFEKO is accessed and controlled using the API. A detailed description of the API objects, collections, enumerations, data types, predefined constants, methods and properties are available in the sections that follow.
  - Result Script
    A result script (math script), perform actions similar to general scripts, but the script returns a result object for displaying on graphs and the 3D view in POSTFEKO.
    - Pulling Data Into the Math Scripting Environment
      A common use for the scripting functionality is to modify existing POSTFEKO results.
    - Structure of a DataSet
      In order to modify or generate a DataSet, it is important to understand how they are constructed.
      - Axes
        An axis is a dimension which data is calculated along. Typically an axes contain the set of physical points where data is calculated, the frequency or position where the data is calculated. A full list is given in topics/feko/user_guide/scripting/dataset_axes_feko_c.html#concept_d51_b3y_ncb__table_aqn_xb1_ybb. Any of these axes may be added to a DataSet.
      - Quantities
        A quantity is a value that is calculated at each point for each axis in a DataSet. More than one quantity can be calculated for any position on the axes and each one typically represents a different type or component of a result.
      - MetaData
        In addition to Axes and Quantities, it may be required to provide additional information about a DataSet.
    - Processing and Modifying a DataSet
      A typical use for the scripting functionality is to modify existing results.
    - Index of Single Element in a DataSet
      This type of scheme is used when fine control is required when accessing a DataSet. It is also the most intuitive method of accessing the elements.
    - Iterate Through Elements in a DataSet
      For the individual element style of indexing, it is necessary to manually iterate over each element. A method to iterate over an unknown number of axes is presented, it is a powerful tool and simpler to maintain than nested loops.
    - Creating a Custom DataSet
      Another use for scripting is when custom data objects are required.
- Custom Dialogs (Forms)
  During the execution of an automation script, custom dialogs can be used that allows the script to be more interactive. When used in conjunction with the custom command library, it is possible to extend the user interface for a variety of custom workflows.
- Application Macros
  An application macro is a reference to an automation script, an icon file and associated metadata.
- Application Macro Library
  The application macro library allows commonly used application macros to be stored in a repository.
- Command Line Arguments for Launching Script
  A script can be run via the command line.
Appendix
Reference information is provided in the appendix.

Structure of a DataSet

In order to modify or generate a DataSet, it is important to understand how they are constructed.

The structure of a DataSet contains three types of data:

Axes refer to the independent axes along which data can be plotted in a view.
Quantities refer to the types of data that can be plotted along a specified axis.
MetaData refers to additional data that pertains to a DataSet that affects how POSTFEKO interprets the DataSet.

Figure 1. Visualisation of the DataSet.

The additional data field refers to the actual values of the results. The indexing of the data is dependent on the structure of the axes and quantities that were defined. Since the data fields should not be accessed directly, it is not discussed here. Rather, the discussion of the proper access methods will follow.

Table 1 shows all of the base units currently supported by POSTFEKO. For all Axes and Quantities, the units need to be specified to help ensure that POSTFEKO knows how to manage the values. More complex units may be constructed out of the base unit from the table by using the operators / and ˆ. For example, acceleration can be written as m/sˆ2.

Data can also consist of different types of data. Table 2 indicates the supported data types.

Table 1. Supported units
Quantity	Unit
Distance	m
	inch
	feet
	mile
	mil
Angle	deg
Angle	rad
Frequency	Hz
Time	s
	min
	hr
Mass	g
Mass	t
Temperature	C
	K
	F
Current	A
Charge	C
Force	N
Potential difference	V
Resistance	Ohm
Conductivity	S
Power	W
Capacitance	F
Inductance	H

Table 2. Supported data types
Data type	Description
scalar	Any real valued data.
complex	Complex values; values containing real and imaginary components.
boolean	Either a true or false value.