Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la última versión en inglés.

Advisor.addExclusion

Agregar exclusiones al modelo o archivo de exclusiones

Desde R2021a

Sintaxis

Advisor.addExclusion(modelName,filterType,entityIdentifier)

Advisor.addExclusion(___,Name,Value)

Descripción

Advisor.addExclusion(modelName,filterType,entityIdentifier) agrega una exclusión a una entidad, como un bloque, subsistema o elemento de Stateflow^®, en el modelo modelName. El tipo de exclusión se especifica mediante el argumento filterType. La entidad se especifica mediante el argumento entityIdentifier.

Si agrega una exclusión, puede ahorrar tiempo durante el desarrollo y la verificación del modelo porque limita el alcance del análisis que Model Advisor debe realizar en su modelo.

Advisor.addExclusion(___,Name,Value) especifica opciones utilizando uno o más argumentos de nombre-valor además de los argumentos de entrada en sintaxis anteriores. Por ejemplo, puede utilizar el argumento checks para excluir una entidad de comprobaciones específicas de Model Advisor o el argumento rationale para proporcionar un motivo para la exclusión.

Ejemplos

Excluir bloques de Simulink del análisis de Model Advisor

Utilice la función Advisor.addExclusion para excluir un bloque de Simulink^® del análisis de Model Advisor.

Abra el modelo slexAircraftExample.

openExample('simulink_aerospace/AircraftLongitudinalFlightControlExample')

En el área de diseño de Simulink, haga clic en la entidad que desea excluir de las comprobaciones de Model Advisor. Para este ejemplo, haga clic en el bloque Inport denominado u.

Excluya el bloque seleccionado del análisis de Model Advisor agregando una exclusión al bloque. En la ventana de comandos de MATLAB^®, ingrese:

Advisor.addExclusion('slexAircraftExample','Block',gcb);

'Block' especifica que la exclusión debe filtrar un bloque de Simulink y la función gcb devuelve la ruta al bloque que seleccionó. Para obtener más información, consulte gcb.

Puede ver la exclusión en el Editor de exclusiones de Model Advisor haciendo clic con el botón secundario en el área de diseño de Simulink y seleccionando Model Advisor > Open Model Advisor Exclusion Editor.

Model Advisor Exclusion Editor muestra una tabla con una fila para la exclusión del bloque u Inport. La columna Filter Identifier muestra la ruta de acceso especificada por el argumento entityIdentifier y la columna Filter Type muestra el tipo de filtro de exclusión especificado por el argumento filterType. Las columnas Rationale y Check ID(s) están asociadas con los argumentos rationale y checks.

Excluir el gráfico de Stateflow del análisis de Model Advisor y proporcionar una justificación

Utilice la función Advisor.addExclusion para excluir un gráfico de Stateflow del análisis de Model Advisor. Este ejemplo requiere Stateflow.

Abra el modelo sf_collatz.

openExample('stateflow/StateTransitionActionsGetStartedExample')

En el gráfico de Stateflow, haga clic en la entidad que desea excluir de las comprobaciones de Model Advisor. Para este ejemplo, haga clic en la transición predeterminada {n = u;}.

Excluya la transición seleccionada del análisis de Model Advisor agregando una exclusión a la transición. En la ventana de comandos de MATLAB, ingrese:

Advisor.addExclusion('sf_collatz','Transition',gcb,'rationale','Do not analyze.')

Puede ver la exclusión en el Editor de exclusiones de Model Advisor haciendo clic con el botón secundario en el área de diseño de Simulink y seleccionando Model Advisor > Open Model Advisor Exclusion Editor.

Argumentos de entrada

modelName — Modelo al que se añadirán exclusiones

vector de caracteres | arreglo de cadenas

Modelo al que agregar la exclusión, especificado como un vector de caracteres o un arreglo de cadenas.

Tipos de datos: char | string

filterType — Tipo de entidad a excluir

Block | BlockType | Subsystem | Library | MaskType | ...

Tipo de entidad a excluir, especificada como uno de estos valores.

Valor	Descripción
Block	Bloque de Simulink
BlockType	Bloques con un valor de propiedad BlockType específico
Subsystem	Bloques dentro de un subsistema
Library	Instancias de un bloque de biblioteca
MaskType	Bloques o subsistemas con un valor de propiedad MaskType específico
Stateflow	Bloques de Stateflow en Simulink
Chart	Cada entidad dentro del gráfico de Stateflow
State	Estado de Stateflow
Transition	Transición de Stateflow
Junction	Intersección de Stateflow
GraphicalFunction	Función gráfica de Stateflow
MatlabFunction	Función de MATLAB en Stateflow
SimulinkFunction	Función de Simulink en Stateflow
TruthTable	Tabla de verdad de Stateflow
SimulinkBasedState	Estado basado en Simulink en Stateflow

Ejemplo: Advisor.addExclusion('mymodel', 'Block', 'mymodel/Constant')

Tipos de datos: char | string

entityIdentifier — Identificador de la entidad que desea excluir

Valor BlockType | Valor MaskType | ruta de acceso

Identificador de la entidad que desea excluir, especificado como un valor de propiedad BlockType, un valor de propiedad MaskType o una ruta de acceso.

El formato del valor entityIdentifier depende del filterType que haya especificado.

Valor filterType	Valor entityIdentifier	Ejemplo
BlockType	Valor de la propiedad BlockType para el bloque	Utilice la función gcb para obtener el bloque seleccionado actualmente y get_param para obtener el tipo de bloque. myblock = gcb; blockType = get_param(myblock,'BlockType'); Advisor.addExclusion('mymodel','BlockType',blockType);
MaskType	Valor de la propiedad MaskType para el bloque	Utilice la función gcb para obtener el bloque actual y get_param para obtener el tipo de máscara. blockWithMask = gcb; maskType = get_param(blockWithMask,'MaskType'); Advisor.addExclusion('mymodel','MaskType',maskType);
Todos los demás valores filterType	Ruta de acceso para la entidad	Puede utilizar las funciones gcb o find_system para obtener la ruta de acceso de una entidad. myblock = gcb; Advisor.addExclusion('mymodel','Block',myblock)

Ejemplo: Advisor.addExclusion('mymodel','BlockType',blockType)

Ejemplo: Advisor.addExclusion('mymodel','MaskType',maskType)

Ejemplo: Advisor.addExclusion('mymodel','Block','mymodel/Constant')

Tipos de datos: char | string

Argumentos de par nombre-valor

Especifique pares opcionales de argumentos como Name1=Value1,...,NameN=ValueN, donde Name es el nombre del argumento y Value es el valor correspondiente. Los argumentos de nombre-valor deben aparecer después de otros argumentos, pero el orden de los pares no importa.

Antes de la versión R2021a, use comas para separar cada nombre y valor, y encierre Name entre comillas.

Ejemplo: Advisor.addExclusion('mymodel', 'BlockType', 'Integrator', 'checks', {'mathworks.jmaab.jc_0231', 'mathworks.jmaab.jc_0222'}, 'validateChecks', true);

checks — Comprueba que la exclusión se aplica a

arreglo de celdas de vectores de caracteres

Comprueba que se aplica la exclusión, especificada como un arreglo de celdas de ID de comprobación de Model Advisor.

De forma predeterminada, cuando se agrega una exclusión a una entidad, la exclusión se aplica a todas las comprobaciones. Puede utilizar el argumento checks para excluir solo las comprobaciones seleccionadas.

Ejemplo: Advisor.addExclusion('mymodel','Block','mymodel/Constant','checks',{'mathworks.design.UnconnectedLinesPorts'})

Ejemplo: Advisor.addExclusion('mymodel','Block','mymodel/Constant','checks',{'mathworks.jmaab.jc_0231','mathworks.design.UnconnectedLinesPorts'})

Tipos de datos: cell

validateChecks — Valida que las comprobaciones admiten exclusiones

false (predeterminado) | true

Valida que las comprobaciones especificadas por el argumento checks se puedan excluir, especificado como un 0 numérico o lógico (false) o 1 (true).

Ciertas comprobaciones, como Check usage of enumerated values, no permiten exclusiones. Si especifica validateChecks como true, Model Advisor advierte que la comprobación no admite exclusiones.

Advisor.addExclusion('vdp','Block',gcb,...
'checks',{'mathworks.jmaab.jc_0231','mathworks.maab.na_0031'},..
'validateChecks',true);

The following checks do not support exclusions:
    {'mathworks.maab.na_0031'}

Ejemplo: Advisor.addExclusion('mymodel','Block','mymodel/Constant','checks',{'mathworks.jmaab.jc_0231','mathworks.maab.na_0031'},'validateChecks',true)

Tipos de datos: logical

rationale — Motivo de exclusión

vector de caracteres | arreglo de cadenas

Motivo de la exclusión, especificado como un vector de caracteres o un arreglo de cadenas.

Ejemplo: Advisor.addExclusion('mymodel','Block','mymodel/Constant','rationale','Block to be removed later.')

Tipos de datos: char | string

Funcionalidad alternativa

Model Advisor Exclusion Editor

También puede agregar exclusiones del área de diseño de Simulink utilizando Model Advisor Exclusion Editor. Para agregar una exclusión al área de diseño de Simulink, haga clic con el botón secundario en una entidad, seleccione Model Advisor y seleccione la opción de menú para el tipo de exclusión que desea agregar. Para obtener más información, consulte Exclude Blocks from Model Advisor Check Analysis.

Historial de versiones

Introducido en R2021a

R2020a: Utilice la ruta de acceso en lugar del identificador de Simulink (SID)

No se recomienda la función Simulink.ID.getSID. Utilice la ruta de acceso en lugar de un identificador de Simulink (SID) cuando especifique el argumento entityIdentifier. Puede encontrar la ruta de acceso utilizando las funciones gcb o find_system.

Consulte también

Advisor.removeExclusion | Advisor.clearExclusion | Advisor.getExclusion | Advisor.saveExclusion | Advisor.loadExclusion

Temas

• Exclude Blocks from Model Advisor Check Analysis
• Exclude Blocks from Custom Checks