Compound Output Parameters

With the Compound Output Parameters tab selected these are displayed in a list with two fields, as show in the figure below.

Figure 19: List of Compound Output Parameters

Adding Compound Output Parameters to the Export setup

Compound Output Parameters Compound Output Parameters adding are computed by AMEPilot, using an expression that you supply. The expression can be any valid combination of:

• Simple Output Parameters,

• Input Parameters,

• other Compound Output Parameters,

• simple mathematical functions,

• special export functions.

Simple mathematical functions are things like sin, exp, abs etc. Some special export functions (globMin, globMax, and restrict) have been introduced in the example in Getting Started with AMEPilot and the Export module.

The full list of special export functions and a description of each is given in Description of EXPORT and Post Processing functions.

In order to add a new Compound Output Parameter, go through the following steps:

1. If necessary select Settings > Export setup… to create the Export Parameter Setup dialog box.

2. Ensure the Compound Output Parameters tab is active.

3. Click on the Add button.

A new line appears in the input list.

Removing Compound Output Parameters from the Export setup

To remove a parameter from the Compound Output Parameter Compound Output Parameters removing list, select it in the list and click on the Remove button or press the Del key.

Compound Output Parameter properties

Once the Compound Output Parameters have been added, their properties have to be set. The following section details the properties that define a Compound Output Parameter.

• Export name This is the same as for Input Parameters: see Export name.

• Expression

Compound Output Parameters expression

This property is needed by AMEPilot in order to compute the output. Note See Description of the Expression Editor functions in the Simcenter Amesim Reference Manual for more information on the syntax of mathematical functions.

To change the expression, click twice on the corresponding cell: you then enter edit mode. There are two ways to set the new expression:

If it is simple, you can just type in the new expression and validate it by pressing the Enter key.

Click on the ... button on the right-hand side of the edited cell.The Expression Editor appears in which you can build the expression. However, please note that the expression editor that opens for Export Setup contains certain enhancements, as shown in the figure below.

Figure 20: Special Expression editor for Export setup.

Expression evaluation rules

Compound Output Parameters expression evaluation rules

At run time, the following rules are applied to evaluate the expression:

• For Input Parameters, the value used is the one used to perform the simulation (e.g. the one you set or the default one).

• For Simple Output Parameters: unless you specify something else (using the valueAt function for instance) the value used is the value of the corresponding variable at the end of the simulation.

• For Compound Output Parameters, the value used is the result of evaluating the corresponding expression.

• Some specific functions consider all the values taken by a variable during the simulation period. If such function is applied to a Compound Output Parameter, this Compound Output Parameter will have to be evaluated for each simulation communication time.

Under some circumstances, it is impossible to compute a Compound Output Parameter. In this case, the result is said to be undefined and then all Compound Output Parameters which use it are also undefined.

Finally, note that even an integer Input Parameter is considered as real when used in an expression.