show

Display optimization object

Syntax

show(obj)

Description

show(obj) displays information about obj at the command line. If the object display is large, consider using write instead to output the display to a text file.

Examples

Use show To Examine Problem-Based Setup

The show function returns information about problem-based objects at the command line. For example, examine the various stages of problem construction for optimizing the Rosenbrock function confined to the unit disk (see Solve a Constrained Nonlinear Problem, Problem-Based).

Create a 2-D optimization variable x. Show the variable.

x = optimvar('x',2);
show(x)

    [ x(1) ]
    [ x(2) ]

Create an expression for the objective function. Show the expression.

obj = 100*(x(2) - x(1)^2)^2 + (1 - x(1))^2;
show(obj)

  ((100 .* (x(2) - x(1).^2).^2) + (1 - x(1)).^2)

Create an expression for the constraint. Show the constraint.

cons = x(1)^2 + x(2)^2 <= 1;
show(cons)

  (x(1).^2 + x(2).^2) <= 1

Create an optimization problem having obj as the objective function and cons as the constraint. Show the problem.

prob = optimproblem("Objective",obj,"Constraints",cons);
show(prob)

  OptimizationProblem : 

	Solve for:
       x

	minimize :
       ((100 .* (x(2) - x(1).^2).^2) + (1 - x(1)).^2)


	subject to :
       (x(1).^2 + x(2).^2) <= 1
     

Finally, create an initial point [0 0] and solve the problem starting at the intial point.

x0.x = [0 0];
[sol,fval,exitflag] = solve(prob,x0)

Solving problem using fmincon.

Local minimum found that satisfies the constraints.

Optimization completed because the objective function is non-decreasing in 
feasible directions, to within the value of the optimality tolerance,
and constraints are satisfied to within the value of the constraint tolerance.

sol = struct with fields:
    x: [2x1 double]

fval = 0.0457

exitflag = 
    OptimalSolution

Examine the solution point.

sol.x

ans = 2×1

    0.7864
    0.6177

Input Arguments

obj — Optimization object

OptimizationProblem object | EquationProblem object | OptimizationExpression object | OptimizationVariable object | OptimizationConstraint object | OptimizationEquality object | OptimizationInequality object

Optimization object, specified as one of the following types.

• OptimizationProblem — show(obj) displays the variables for solution, objective function, constraints, and variable bounds.

• EquationProblem — show(obj) displays the variables for solution, equations for solution, and variable bounds.

• OptimizationExpression — show(obj) displays the optimization expression.

• OptimizationVariable — show(obj) displays the optimization variables. This display does not indicate variable type or bounds, it shows only the variable dimensions and index names (if any).

• OptimizationConstraint — show(obj) displays the constraint expression.

• OptimizationEquality — show(obj) displays the equality expression.

• OptimizationInequality — show(obj) displays the inequality expression.

Example: show(obj)