Подавите диагностические сообщения программно

Следующие примеры показывают, как управлять диагностическими подавлениями программно.

Подавите диагностические сообщения программно

В этом примере показано, как получить доступ к метаданным симуляции, чтобы управлять диагностическими подавлениями и восстановить диагностические сообщения программно.

Создайте новую папку и скопируйте соответствующие файлы

  1. Создайте локальную рабочую папку, например, c:\diagnostic_suppressor_demo.

  2. Превратитесь в docroot\toolbox\simulink\examples папка. В MATLAB® командная строка, введите:

    cd(fullfile(docroot, 'toolbox', 'simulink', 'examples')) 

  3. Скопируйте getDiagnosticObjects.m, suppressor_script.m, и Suppressor_CLI_Demo.slx файлы к вашей локальной рабочей папке.

    getDiagnosticObjects.m функционируйте запрашивает метаданные симуляции, чтобы получить доступ к диагностике, которая была выдана в процессе моделирования. suppressor_script.m скрипт содержит команды для подавления и восстановления диагностики к Suppressor_CLI_Demo модель.

     getDiagnosticObjects.m

Откройте и симулируйте модель

Откройте модель. Получить доступ к Simulink.SimulationMetadata, установите ReturnWorkspaceOutputs значение параметров к 'on'. Симулируйте модель.

model = 'Suppressor_CLI_Demo';
open_system(model);
set_param(model,'ReturnWorkspaceOutputs','on');
out = sim(model);

Получите идентификаторы сообщений от метаданных симуляции

Найдите имена диагностических идентификаторов сообщений с помощью метаданных симуляции, сохраненных в MSLDiagnostic объект.

if (exist('out', 'var'))
    diag_objects = getDiagnosticObjects(out);
end

Несколько предупреждений были сгенерированы в процессе моделирования, включая насыщение блока Data Type Conversion. Запросите diag_objects переменная, чтобы получить больше информации об идентификаторах.

diag_objects(5)
ans = 

  MSLDiagnostic with properties:

    identifier: 'SimulinkFixedPoint:util:Saturationoccurred'
       message: 'Saturation occurred. This originated from 'Suppressor_CLI_Demo/Con…'
         paths: {'Suppressor_CLI_Demo/Convert/FixPt To FixPt3'}
         cause: {}
         stack: [0×1 struct]

Подавите диагностику насыщения на блоке

Используйте Simulink.suppressDiagnostic функция, чтобы подавить диагностику насыщения на преобразовании типа данных блокируется только. Симулируйте модель.

Simulink.suppressDiagnostic('Suppressor_CLI_Demo/Convert/FixPt To FixPt3', ...
'SimulinkFixedPoint:util:Saturationoccurred');
set_param(model,'SimulationCommand','start');

Восстановите диагностику насыщения

Используйте Simulink.restoreDiagnostic функционируйте, чтобы восстановить диагностику насыщения того же блока.

Simulink.restoreDiagnostic('Suppressor_CLI_Demo/Convert/FixPt To FixPt3',...
 'SimulinkFixedPoint:util:Saturationoccurred');
set_param(model,'SimulationCommand','start');

Подавите несколько объектов диагностики на источнике

Можно подавить несколько предупреждений на одном источнике путем создания массива ячеек идентификаторов сообщений. Подавите потерю точности и предупреждения потери значимости параметра блока Constant, one, в модели.

diags = {'SimulinkFixedPoint:util:fxpParameterPrecisionLoss',...
 'SimulinkFixedPoint:util:fxpParameterUnderflow'};
Simulink.suppressDiagnostic('Suppressor_CLI_Demo/one',diags);
set_param(model,'SimulationCommand','start');

Восстановите всю диагностику на блоке

Восстановите всю диагностику на заданном блоке с помощью Simulink.restoreDiagnostic функция.

Simulink.restoreDiagnostic('Suppressor_CLI_Demo/one');
set_param(model,'SimulationCommand','start');

Подавите диагностику на многих блоках

Можно подавить одну или несколько диагностики на многих блоках. Например, используйте find_system функция, чтобы создать массив ячеек всего Data Type Conversion блокируется в системе и подавить все предупреждения насыщения на заданных блоках.

dtc_blocks = find_system('Suppressor_CLI_Demo/Convert',...
 'BlockType', 'DataTypeConversion');
Simulink.suppressDiagnostic(dtc_blocks, 'SimulinkFixedPoint:util:Saturationoccurred');
set_param(model,'SimulationCommand','start');

Восстановите всю диагностику в подсистеме

Можно также использовать Simulink.restoreDiagnostic функционируйте, чтобы восстановить всю диагностику в заданной подсистеме.

Simulink.restoreDiagnostic('Suppressor_CLI_Demo/Convert',...
 'FindAll', 'On');
set_param(model,'SimulationCommand','start');

Добавьте комментарии и информацию о пользователе к подавлению

SuppressedDiagnostic объект содержит информацию об источнике подавления и подавленного диагностического идентификатора сообщения. Можно также включать комментарии и имя пользователя, кто продержался, изменил подавление.

Object = Simulink.SuppressedDiagnostic('Suppressor_CLI_Demo/Convert/FixPt To FixPt1',...
 'SimulinkFixedPoint:util:Saturationoccurred');
Object.Comments = 'Reviewed: John Doe';
Object.LastModifiedBy = 'Joe Schmoe'
set_param(model,'SimulationCommand','start');
Object = 

  SuppressedDiagnostic with properties:

            Source: 'Suppressor_CLI_Demo/Convert/FixPt To FixPt1'
                Id: 'SimulinkFixedPoint:util:Saturationoccurred'
    LastModifiedBy: 'Joe Schmoe'
          Comments: 'Reviewed: John Doe'
      LastModified: '2016-Jun-21 18:23:01'

Получите данные о подавлении

Чтобы получить данные о подавлении для определенной подсистемы или блока, используйте Simulink.getSuppressedDiagnostics функция.

Object = Simulink.getSuppressedDiagnostics('Suppressor_CLI_Demo/Convert/FixPt To FixPt1');
set_param(model,'SimulationCommand','start');

Восстановите всю диагностику на модели

Когда модель содержит много диагностических подавлений, и вы хотите восстановить всю диагностику к модели, использовать Simulink.getSuppressedDiagnostics функционируйте, чтобы возвратить массив Simulink.SuppressedDiagnostic объекты. Затем используйте restore метод, когда вы выполняете итерации через массив.

Objects = Simulink.getSuppressedDiagnostics('Suppressor_CLI_Demo');
for iter = 1:numel(Objects)
    restore(Objects(iter));
end
set_param(model,'SimulationCommand','start');

Подавите диагностические сообщения модели, на которую ссылаются,

В этом примере показано, как подавить диагностику, когда диагностика происходит из модели, на которую ссылаются. Путем доступа к MSLDiagnostic объект определенного экземпляра предупреждения, можно подавить предупреждение только для экземпляров, когда модель, на которую ссылаются, симулирована от заданной топ-модели.

Эта модель в качестве примера содержит два экземпляра той же модели, на которую ссылаются, RefModel. Модель RefModel ссылки еще одна модель, RefModel_Low. RefModel_Low содержит два блока Gain, что каждый производит перенос на переполнении, предупреждающем в процессе моделирования. Подавите один из четырех экземпляров этого предупреждения в модели путем доступа к MSLDiagnostic объект, сопоставленный с переносом на переполнении, предупреждающем произведенный одним из Усиления, блокируется в RefModel_Low модель только, когда на это ссылается Ref_block1.

Откройте топ-модель. Симулируйте модель и сохраните выход в переменной, out.

out = sim('TopModel');

Доступ к метаданным симуляции сохранен в MSLDiagnostic объект.

diag = getDiagnosticObjects(out)
diag = 

  1×4 MSLDiagnostic array with properties:

    identifier
    message
    paths
    cause
    stack

Можно просмотреть диагностику и их причины в Диагностическом Средстве просмотра или в командной строке.

for i = 1 : numel(diag)
    disp(diag(i));
    disp(diag(i).cause{1});
end

Подавите один из переноса на предупреждениях переполнения от RefModel_Low только, когда это симулировано от TopModel/Ref_block1 путем доступа к определенной диагностике. Симулируйте модель.

Simulink.suppressDiagnostic(diag(1));
out = sim('TopModel')

Доступ к метаданным симуляции. Эта симуляция произвела только три предупреждения.

diag = getDiagnosticObjects(out)
diag = 

  1×3 MSLDiagnostic array with properties:

    identifier
    message
    paths
    cause
    stack

Восстановите диагностику к модели.

Simulink.restoreDiagnostic(diag(1));

Смотрите также

| | | | |

Для просмотра документации необходимо авторизоваться на сайте