Documentation

Specify Custom Requirements

This topic shows how to specify custom requirements in the Response Optimization tool.

You can specify custom requirements, such as minimizing system energy. To specify custom requirements:

  1. In the Response Optimization tool, in New drop-down menu, select Custom Requirement. The Create Requirement dialog box opens where you specify the custom requirement.

  2. Specify a requirement name in Name.

  3. Specify the requirement type in the Type drop-down menu.

  4. Specify the name of the function that contains the custom requirement in Function. The field must be specified as a function handle using @. The function must be on the MATLAB® path. Click to review or edit the function.

    If the function does not exist, clicking opens a template MATLAB file. Use this file to implement the custom requirement. The default function name is myCustomRequirement.

  5. (Optional) To prevent the solver from considering specific parameter combinations, select Error if constraint is violated. Use this option for parameter-only constraints.

    During an optimization iteration, the solver first evaluates requirements with this option selected.

    • If the constraint is violated, the solver skips evaluating any remaining requirements and proceeds to the next iteration.

    • If the constraint is not violated, the solver evaluates the remaining requirements for the current iteration. If any of the remaining requirements bound signals or systems, then the solver simulates the model.

    For more information, see Skip Model Simulation Based on Parameter Constraint Violation (GUI).

      Note:   If you select this check box, then do not specify signals or systems to bound. If you do specify signals or systems, then this check box is ignored.

  6. (Optional) Specify the signal or system, or both, to be bound.

    You can apply this requirement to model signals, or a linearization of your Simulink® model (requires Simulink Control Design™ ), or both.

    Click Select Signals and Systems to Bound (Optional) to view the signal and linearization I/O selection area.

    • To apply this requirement to a model signal:

      In the Signal area, select a logged signal to which you will apply the requirement.

      If you have already selected a signal to log, as described in Specify Signals to Log, it appears in the list. Select the corresponding check box.

      If you have not selected a signal to log:

      1. Click . A Create Signal Set dialog box opens where you specify the logged signal.

      2. In the Simulink model window, click the signal to which you want to add a requirement.

        The Create Signal Set dialog box updates and displays the name of the block and the port number where the selected signal is located.

      3. Select the signal and click to add it to the signal set.

      4. In Signal set field, enter a name for the selected signal set.

        Click OK. A new variable, with the specified name, appears in the Data area of the Response Optimization tool.

    • To apply this requirement to a linear system:

      1. Specify the simulation time at which the model is linearized in Snapshot Times. For multiple simulation snapshot times, specify a vector.

      2. Select the linearization input/output set from the Linearization I/O area.

        If you have already created a linearization input/output set, it appears in the list. Select the corresponding check box.

        If you have not created a linearization input/output set, click to open the Create linearization I/O set dialog box. For more information on using this dialog box, see Create Linearization I/O Sets.

      For more information on linearization, see What Is Linearization?.

  7. Click OK.

    A new variable, with the specified name, appears in the Data area of the Response Optimization tool. A graphical display of the requirement also appears in the Response Optimization tool window.

Related Examples

Was this topic helpful?