Controllers View :: Reference for the Design Tool GUI (Model Predictive Control Toolbox™)

Controllers View

Selecting Controllers in the tree displays this view (see example below).

The following sections describe the view's main features:

Controllers List

This table lists all the controllers in your project. The example below lists two controllers, MPC1 and MPC2.

The Name field is editable. The name you assign here must be unique. You will refer to it elsewhere in the design tool, e.g., when you use the controller in a simulation scenario. Each listed controller corresponds to a subnode of Controllers (see Tree View). Editing the name in the table will rename the corresponding subnode.

The Plant Model field is editable. To change the selection, click the cell and choose one of your models from the list. (All models appearing in the Plant Models view are valid choices. See Plant Models View.)

The Control Interval field is editable and must be a positive real number. You can also set it in the Controller Specifications view (see Model and Horizons Tab for more details).

The Prediction Horizon field is editable and must be a positive, finite integer. You can also set in the Controller Specifications view (see Model and Horizons Tab for more details).

The noneditable Last Update field gives the date and time the controller was most recently modified.

Controller Details

This scrollable viewport shows details of the controller currently selected in the controllers list (see Controllers List). An example appears below.

Note This view shows controller details once you have used the controller in a simulation. Prior to that, it is empty. If necessary, you can use the Display button to force the details to appear.

Additional Notes

You can use this editable text area to enter comments, distinguishing controller features, etc.

Buttons

Import

Opens the MPC Controller Importer dialog box (see Importing a Controller).

Export

Opens the MPC Controller Exporter dialog box (see Exporting a Controller).

New

Creates a new controller specification subnode containing the default Model Predictive Control Toolbox™ settings, and assigns it a default name.

Copy

Copies the selected controller, creating a controller specification subnode containing the same controller settings, and assigning it a default name.

Display

Calculates and displays details for the selected controller.

Delete

Deletes the selected controller. If the controller is being used elsewhere (i.e., in a simulation scenario), the first controller in the list replaces it (and a warning message appears).

Right-Click Options

Right-clicking the Controllers node causes the following menu options to appear.

New Controller

Creates a new controller specification subnode containing the default Model Predictive Control Toolbox settings, and assigns it a default name.

Import Controller

Opens the MPC Controller Importer dialog box (see Importing a Controller).

Export Controller

Opens the MPC Controller Exporter dialog box (see Exporting a Controller).

Provide feedback about this page

Plant Models View Simulation Scenarios List