Plot Value

The (plot-value) function can be created using the following Lisp syntax:

The (plot-value) function takes three or four arguments:

• plot_reference: reference to a plot created with (make-plot)
• label: a string (in quotes) that will be used as a label for the graph of this data
• controller_reference: a controller whose data will be plotted.
• dimension: (optional) dimension of the controller which will be plotted (defaults to 0)

You obviously do not need to provide a dimension for one-dimensional controllers. Dimensions are numbered starting from 0.

For each curve you want plotted, you call the plot-value command before running the synthesis. The first argument is a reference to a graph created with (make-plot). The second argument is a string which will be the label for that curve. The third argument is a reference to a controller whose data will be graphed. The fourth argument is optional, and can be used to specify a dimension other than the first for multi-dimensional controllers. Here is a simple example of how to plot the three dimensions of a 3-dimensional controller (the resulting graph is shown in the image, above):

This command must be called after (make-plot) and before running the synthesis with the (run ...) command.

In very old versions of Modalys the plot feature worked slightly differently. The (plot-value ... ) function used a lambda expression instead of a controller. Older scripts will need to be updated to the new syntax.