Main Content

linqueryHasInputs

Query object for finding blocks with specified number of inputs

Description

linqueryHasInputs creates a custom query object for finding all the blocks in a linearization result that have a specified number of inputs.

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

Description

query = linqueryHasInputs(numInputs) creates a query object for finding all the blocks in a LinearizationAdvisor object that have the specified number of inputs. This syntax sets the NumInputs property of the query object.

example

Properties

expand all

Number of block inputs, specified as a nonnegative integer.

Query type, specified as a character vector of the form 'Has <N> Inputs', where <N> is equal to NumInputs.

Query description, specified as a character vector of the form 'Blocks with <N> Inputs', where <N> is equal to NumInputs. You can add your own description to the query object using this property.

Usage

After creating a linqueryHasInputs query object, you can:

  • Find all the blocks in a LinearizationAdvisor object that have the specified number of inputs by using the linqueryHasInputs query directly with the find command.

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

Object Functions

findFind blocks in linearization results that match specific criteria

Examples

collapse all

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 with two inputs.

qIn = linqueryHasInputs(2);
advIn = find(advisor,qIn)
advIn = 
  LinearizationAdvisor with properties:

               Model: 'scdspeed'
      OperatingPoint: [1x1 opcond.OperatingPoint]
    BlockDiagnostics: [1x13 linearize.advisor.BlockDiagnostic]
           QueryType: 'Has 2 Inputs'

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 compound query object for finding all blocks with one input and one output.

qSISO = linqueryHasInputs(1) & linqueryHasOutputs(1);

Find all SISO blocks using compound query object.

advSISO = find(advisor,qSISO)
advSISO = 
  LinearizationAdvisor with properties:

               Model: 'scdspeed'
      OperatingPoint: [1x1 opcond.OperatingPoint]
    BlockDiagnostics: [1x10 linearize.advisor.BlockDiagnostic]
           QueryType: '(Has 1 Inputs & Has 1 Outputs)'

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.

Version History

Introduced in R2017b