6.6.5 Using the CreateXYScalarPlot() Function

In 5.1 Running the Built-in Efficiency Testplan, you simulated the efficiency of the converter using the built-in efficiency testplan. The last graph produced in that section plotted three efficiency curves based on scalar data aggregated from the previous tests. Three CreateXYScalarPlot() functions were used to generate those curves. A copy of the efficiency testplan is available from  SIMPLIS_dvm_tutorial_examples.zip at this path:

testplans/dvm_builtin-efficiency_dcdc_1in_1out.testplan

CreateXYScalarPlot(x-expression, y-expression, scalars to extract, curve_name, graph_name, grid_index, axis_name, OPTIONAL_PARAMETER_STRING)

* For additional information about graph_name, grid_index, and axis_name, see Graph Address System.

** For additional information about OPTIONAL_PARAMETER_STRING, see Optional Parameters.

In the simplest case, the scalar expressions x-expression and y-expression can be any scalars from the test reports. In more complex applications, the expressions can be any mathematical expression of scalar values, such as values set with the Var(), GlobalVar(), and Change() testplan entries.

The built-in efficiency testplan uses the following arguments in the CreateXYScalarPlot() function that plotted the efficiency vs. load current:

The complete CreateXYScalarPlot() function for the nominal input voltage in the built-in efficiency testplan is as follows:

CreateXYScalarPlot( AVG(ILOAD), Efficiency_Nom, AVG(ILOAD) Efficiency_Nom, DVM Vin Nom, DVM Efficiency, A1, vert, xlabel=Load Current xunits=A ylabel=Efficiency yunits=%%% showpoints=true color=red)

To build the other two functions for the minimum and maximum input voltages, follow these steps:

1. Make two copies of the above function.
2. In one copy, replace all Nom entries with Min and change the color from red to green.
3. In the second copy, replace all Nom entries with Max and change the color from red to blue.

The final three functions are shown below.

After these three CreateXYScalarPlot() functions are entered in three new Create columns, you have the following built-in testplan that was used in 5.1 Running the Built-In Efficiency Testplan.