# Effects of Pattern Search Options

This example shows the effects of some options for pattern search. The options include plotting, stopping criteria, and other algorithmic controls for speeding a solution.

### Set Up a Problem for Pattern Search

The problem to minimize is a quadratic function of six variables subject to linear equality and inequality constraints. The objective function, `lincontest7`, is included with Global Optimization Toolbox.

`type lincontest7`
```function y = lincontest7(x); %LINCONTEST7 objective function. % y = LINCONTEST7(X) evaluates y for the input X. Make sure that x is a column % vector, whereas objective function gets a row vector. % Copyright 2003-2004 The MathWorks, Inc. x = x'; %Define a quadratic problem in terms of H and f (From web unknown source) H = [36 17 19 12 8 15; 17 33 18 11 7 14; 19 18 43 13 8 16; 12 11 13 18 6 11; 8 7 8 6 9 8; 15 14 16 11 8 29]; f = [ 20 15 21 18 29 24 ]'; y = 0.5*x'*H*x + f'*x; ```

Specify the function handle `@lincontest7` as the objective function.

`objectiveFcn = @lincontest7;`

The objective function accepts a row vector of length six. Specify an initial point for the optimization.

`x0 = [2 1 0 9 1 0];`

Create linear constraint matrices representing the constraints `Aineq*x <= Bineq` and `Aeq*x = Beq`. For details, see Linear Constraints (Optimization Toolbox).

```Aineq = [-8 7 3 -4 9 0 ]; Bineq = ; Aeq = [7 1 8 3 3 3; 5 0 5 1 5 8; 2 6 7 1 1 8; 1 0 0 0 0 0]; Beq = [84 62 65 1];```

Run the `patternsearch` solver, and note the number of iterations and function evaluations required to reach the solution.

`[X1,Fval,Exitflag,Output] = patternsearch(objectiveFcn,x0,Aineq,Bineq,Aeq,Beq);`
```Optimization terminated: mesh size less than options.MeshTolerance. ```
`fprintf('The number of iterations is: %d\n', Output.iterations);`
```The number of iterations is: 132 ```
`fprintf('The number of function evaluations is: %d\n', Output.funccount);`
```The number of function evaluations is: 1531 ```
`fprintf('The best function value found is: %g\n', Fval);`
```The best function value found is: 2189.03 ```

Monitor the optimization process by specifying options that select two plot functions. The plot function `psplotbestf` plots the best objective function value at every iteration, and the plot function `psplotfuncount` plots the number of times the objective function is evaluated at each iteration. Set these two plot functions in a cell array.

`opts = optimoptions(@patternsearch,'PlotFcn',{@psplotbestf,@psplotfuncount});`

Run the `patternsearch` solver, including the `opts` argument. Because the problem has no upper or lower bound constraints and no nonlinear constraints, pass empty arrays (`[]`) for the seventh, eighth, and ninth arguments.

```[X1,Fval,ExitFlag,Output] = patternsearch(objectiveFcn,x0,Aineq,Bineq, ... Aeq,Beq,[],[],[],opts);```
```Optimization terminated: mesh size less than options.MeshTolerance. ``` ### Mesh Options

Pattern search involves evaluating the objective function at points in a mesh. The size of the mesh can influence the speed of solution. You can control the size of the mesh using options.

Initial Mesh Size

The mesh at each iteration is the span of a set of search directions that are added to the current point, scaled by the current mesh size. The solver starts with an initial mesh size of `1` by default. To start the initial mesh size at `10`, set the `InitialMeshSize` option.

`options = optimoptions(opts,'InitialMeshSize',10);`

Mesh Scaling

You can scale the mesh to improve the minimization of a poorly scaled optimization problem. Scaling rotates the pattern by some degree and scales along the search directions. The `ScaleMesh` option is on (`true`) by default, but you can turn it off if the problem is well scaled. In general, if the problem is poorly scaled, setting this option to `true` can reduce the number of function evaluations. For this problem, set `ScaleMesh` to `false`, because `lincontest7` is a well-scaled objective function.

`opts = optimoptions(opts,'ScaleMesh',false);`

Mesh Accelerator

Direct search methods require many function evaluations compared to derivative-based optimization methods. The pattern search algorithm can quickly find the neighborhood of an optimum point, but can be slow in detecting the minimum itself. The `patternsearch` solver can reduce the number of function evaluations by using an accelerator. When the accelerator is on (`opts.AccelerateMesh = true`), the solver contracts the mesh size rapidly after some minimum mesh size. This option is recommended only for smooth problems; in other types of problems, you can lose some accuracy. The `AccelerateMesh` option is off (`false`) by default. For this problem, set `AccelerateMesh` to `true` because the objective function is smooth.

`opts = optimoptions(opts,'AccelerateMesh',true);`

Run the `patternsearch` solver.

```[X2,Fval,ExitFlag,Output] = patternsearch(objectiveFcn,x0,Aineq,Bineq, ... Aeq,Beq,[],[],[],opts);```
```Optimization terminated: mesh size less than options.MeshTolerance. ``` `fprintf('The number of iterations is: %d\n', Output.iterations);`
```The number of iterations is: 86 ```
`fprintf('The number of function evaluations is: %d\n', Output.funccount);`
```The number of function evaluations is: 893 ```
`fprintf('The best function value found is: %g\n', Fval);`
```The best function value found is: 2189.03 ```

The mesh option settings reduce the number of iterations and the number of function evaluations, and there is no apparent loss of accuracy.

### Stopping Criteria and Tolerances

`MeshTolerance` is a tolerance on the mesh size. If the mesh size is less than `MeshTolerance`, the solver stops. `StepTolerance` is the minimum tolerance on the change in the current point to the next point. `FunctionTolerance` is the minimum tolerance on the change in the function value from the current point to the next point.

Set the `MeshTolerance` to 1e-7, which is ten times smaller than the default value. This setting can increase the number of function evaluations and iterations, and can lead to a more accurate solution.

`opts.MeshTolerance = 1e-7;`

### Search Methods in Pattern Search

The pattern search algorithm can use an additional search method at every iteration, based on the value of the `SearchFcn` option. When you specify a search method using `SearchFcn`, `patternsearch` performs the specified search first, before the mesh search. If the search method is successful, `patternsearch` skips the mesh search, commonly called the poll function, for that iteration. If the search method is unsuccessful in improving the current point, `patternsearch` performs the mesh search.

You can specify different search methods for `SearchFcn`, including `searchga` and `searchneldermead`, which are optimization algorithms. Use these two search methods only for the first iteration, which is the default setting. Using either of these methods at every iteration might not improve the results and can be computationally expensive. However, you can use the `searchlhs` method, which generates Latin hypercube points, in every iteration or possibly every 10 iterations.

Other choices for search methods include poll methods such as positive basis N+1 or positive basis 2N. A recommended strategy is to use the positive basis N+1 (which requires at most N+1 points to create a pattern) as a search method and positive basis 2N (which requires 2N points to create a pattern) as a poll method.

Update the options structure to use `positivebasisnp1` as the search method. Because positive basis 2N is the default for the `PollFcn` option, do not set that option.

`opts.SearchFcn = @positivebasisnp1;`

Run the `patternsearch` solver.

```[X5,Fval,ExitFlag,Output] = patternsearch(objectiveFcn,x0,Aineq,Bineq,Aeq,Beq, ... [],[],[],opts);```
```Optimization terminated: mesh size less than options.MeshTolerance. ``` `fprintf('The number of iterations is: %d\n', Output.iterations);`
```The number of iterations is: 66 ```
`fprintf('The number of function evaluations is: %d\n', Output.funccount);`
```The number of function evaluations is: 838 ```
`fprintf('The best function value found is: %g\n', Fval);`
```The best function value found is: 2189.03 ```

The total number of iterations and function evaluations decreases, even though the mesh tolerance is smaller than its previous value and is the stopping criterion that halts the solver.

Watch now