Worked Example Optimization

On this page…
Example Overview Using the Worked Example Optimization

Example Overview

There is a simple worked example provided to show you what you can do by modifying the template file to write your own optimizations. This example demonstrates a simple use of the CAGE optimization feature. The aim of this example is to obtain values of spark (SPK) and air/fuel ratio (AFR) that maximize torque at a given speed (N) and load (L). These values could then be used to fill calibration tables.

An example of a user-defined optimization algorithm is provided.

• To see a description of this algorithm, at the command line type

  help mbcweoptimizer
  

mbcweoptimizer is an example of a user-specified optimization that solves the following problem:

Maximum TQ over (AFR, SPK) at a given (N, L) point.

The syntax for this example function, mbcweoptimizer, mimics that used in the Optimization Toolbox product.

• To evaluate this at the command line, type this example:

  [bestafr, bestspk] = mbcweoptimizer(@(afr, spk)mbcTQ(afr,...
  spk, 1000, 0.2))
  

The optimization finds values of AFR and spark (the free variables) that give the maximum output from TQ at the values of speed and load (the fixed variables) that you specified, in this case speed = 1000, load = 0.2, as shown below.

bestafr =
12.9167
bestspk =
25

To use this optimization algorithm in CAGE, you need to include the function in a CAGE optimization function script. This worked example modifies the template provided to show you how to use your own algorithms within CAGE. You can find detailed information on all the available CAGE optimization interface functions in User-Defined Optimizations in the CAGE documentation.

• To view the worked example file, at the command line, type

  edit mbcOSworkedexample
  

The worked example optimization wraps mbcweoptimizer in a function that can be called by the CAGE optimization feature. When you run your optimization from CAGE, you can alter the search ranges of the free variables and the resolution of the search.

The next section, Using the Worked Example Optimization, demonstrates how to use the example within CAGE.

The section Creating an Optimization from Your Own Algorithm is a detailed tutorial example explaining how to incorporate an example user-defined optimization algorithm into a CAGE optimization function.

Back to Top

Using the Worked Example Optimization

In order to run any optimization, you first need to set up your CAGE session with a model.

For this example, the CAGE session requires

• A torque model

• A variable dictionary defining required variable ranges and set points (N, L, AFR, and SPK)

• A data set defining the (N,L) operating points where you want to run the optimizer

There is a preconfigured session provided that contains the model, variable dictionary, and data set.

1. Select File > Open Project and load the file optimworkedexample.cag. This is in the mbctraining directory.

   • The tq model was fitted to the Holliday engine data and exported from the Model Browser quick start tutorial (also used in the CAGE feature calibration tutorial). It can be found in tutorial.exm in the mbctraining directory. To view this model in your current session, click the Models button in the Data Objects pane. There is also another model in the session that you will use later.

   • You can look at the variables by clicking the Variable Dictionary button in the Data Objects pane.

   • You can look at the operating point set by clicking Data Sets in the Data Objects pane. Note you can specify fixed variables for optimizations either directly in the optimization view or import them from a data set or table.

2. Select File > New > Optimization.

   The Optimization Wizard appears.

3. Select WorkedExample, and click Next.

4. Associate each pair of inputs and variables, by clicking afr and A in the left and right lists, and then click the Select button. Similarly associate spark with spk. Click Next.

   

5. The next screen of the wizard automatically shows the Torque model selected and Maximize chosen; these are specified in the function. Select tq in the CAGE model list and click the button to match it with the Torque optimization model, then click Finish.

   

   CAGE switches to the Optimization view and the new Optimization node appears in the tree.

6. If you ran the optimization now it would run at one point, the set point of all the variables. You use the free and fixed Variable Values panes to select operating points. You can edit points manually or import them. Select Optimization > Import From Data Set.

   

   The project file contains a data set with N and L values, and these are automatically selected. Click OK to import.

   Notice 36 rows appear in both fixed and free variable panes, and operating point values have been imported into the N and L columns in the Fixed Variables pane. The initial values for A and spark for each point are the set points in the variable dictionary.

7. Click Run Optimization   in the toolbar.

8. When the optimization completes, the view switches to the new Optimization_Output node.

   The output display should look like the following. The optimization has found the values of SPK and AFR that give the maximum model value of torque at each operating point specified. Select different operating points by clicking in the table: the model plots at the selected operating point are shown. There is only one solution per operating point, so you cannot scroll through the solutions.

   

   For a detailed walk-through of incorporating an example user-defined optimization algorithm into a CAGE optimization function, see the next tutorial section, Creating an Optimization from Your Own Algorithm.

Back to Top

Automated Tradeoff

Creating an Optimization from Your Own Algorithm

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS