linqueryIsOnPath

Query object for finding blocks that are on the linearization path

Description

linqueryIsOnPath creates a custom query object for finding all the blocks in a linearization result that are on the linearization path.

When you linearize a Simulink^® model, you can create a LinearizationAdvisor object that contains diagnostic information about individual block linearizations. To find block linearizations that satisfy specific criteria, you can use the find function with custom query objects. Alternatively, you can analyze linearization diagnostics using the Linearization Advisor in the Model Linearizer. For more information on finding specific blocks in linearization results, see Find Blocks in Linearization Results Matching Specific Criteria.

Creation

Syntax

query = linqueryIsOnPath

Description

query = linqueryIsOnPath creates a query object for finding all the blocks in a LinearizationAdvisor object that are on the linearization path.

Properties

QueryType — Query type

'On Linearization Path' (default) | character vector

Query type, specified as 'On Linearization Path'.

Description — Query description

'Blocks on the Linearization Path' (default) | character vector

Query description, specified as 'Blocks on the Linearization Path'. You can add your own description to the query object using this property.

Usage

After creating a linqueryIsOnPath query object, you can:

• Find all the blocks in a LinearizationAdvisor object that are on the linearization path by using the linqueryIsOnPath query directly with the find command.

• Create a CompoundQuery object by logically combining the linqueryIsOnPath query with other query objects.

Object Functions

find	Find blocks in linearization results that match specific criteria

Examples

Find All Blocks On Linearization Path

Load the Simulink model.

mdl = 'scdspeed';
load_system(mdl)

Linearize the model and obtain the LinearizationAdvisor object.

opts = linearizeOptions('StoreAdvisor',true);
io(1) = linio('scdspeed/throttle (degrees)',1,'input');
io(2) = linio('scdspeed/rad//s to rpm',1,'output');
[sys,op,info] = linearize(mdl,io,opts);
advisor = info.Advisor;

Create query object, and find all the linearized blocks on the linearization path.

qPath = linqueryIsOnPath;
advPath = find(advisor,qPath)

advPath = 
  LinearizationAdvisor with properties:

               Model: 'scdspeed'
      OperatingPoint: [1x1 opcond.OperatingPoint]
    BlockDiagnostics: [1x26 linearize.advisor.BlockDiagnostic]
           QueryType: 'On Linearization Path'

Alternative Functionality

App

You can also create custom queries for finding specific blocks in linearization results using the Linearization Advisor in the Model Linearizer. For more information, see Find Blocks in Linearization Results Matching Specific Criteria.