Main Content

linqueryIsNumericallyPerturbed

Query object for finding blocks linearized using numerical perturbation

expand all in page

Description

linqueryIsNumericallyPerturbed creates a custom query object for finding all the blocks in a linearization result that are linearized using numerical perturbation.

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 = linqueryIsNumericallyPerturbed

Description

query = linqueryIsNumericallyPerturbed creates a query object for finding all the blocks in a LinearizationAdvisor object that are linearized using numerical perturbation.

example

Properties

expand all

Query type, specified as 'Perturbation'.

Query description, specified as 'Blocks that are Numerically Perturbed'. You can add your own description to the query object using this property.

Usage

After creating a linqueryIsNumericallyPerturbed query object, you can:

  • Find all the blocks in a LinearizationAdvisor object that are linearized using numerical perturbation by using the linqueryIsNumericallyPerturbed query directly with the find command.

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

Object Functions

findFind blocks in linearization results that match specific criteria

Examples

collapse all

Open Live Script

Load the Simulink model. 

mdl = 'scdpendulum';
load_system(mdl)

Linearize the model and obtain the LinearizationAdvisor object.

opts = linearizeOptions('StoreAdvisor',true);
io = getlinio(mdl);
[sys,op,info] = linearize(mdl,io,opts);
advisor = info.Advisor;

Create query object, and find all numerically perturbed blocks.

qPert = linqueryIsNumericallyPerturbed;
advPert = find(advisor,qPert)
advPert = 
  LinearizationAdvisor with properties:

               Model: 'scdpendulum'
      OperatingPoint: [1x1 opcond.OperatingPoint]
    BlockDiagnostics: [1x4 linearize.advisor.BlockDiagnostic]
           QueryType: 'Perturbation'

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

See Also

Objects

Functions

Topics