Следующие примеры показывают, как управлять диагностическими подавлениями программно.
В этом примере показано, как получить доступ к метаданным симуляции, чтобы управлять диагностическими подавлениями и восстановить диагностические сообщения программно.
Создайте новую папку и скопируйте соответствующие файлы
Создайте локальную рабочую папку, например, c:\diagnostic_suppressor_demo
.
Превратитесь в docroot\toolbox\simulink\examples
папка. В командной строке MATLAB®, введите:
cd(fullfile(docroot, 'toolbox', 'simulink', 'examples'))
Скопируйте getDiagnosticObjects.m
, suppressor_script.m
, и Suppressor_CLI_Demo.slx
файлы к вашей локальной рабочей папке.
getDiagnosticObjects.m
функционируйте запрашивает метаданные симуляции, чтобы получить доступ к диагностике, которая была выдана в процессе моделирования. suppressor_script.m
скрипт содержит команды для подавления и восстановления диагностики к Suppressor_CLI_Demo
модель.
Откройте и симулируйте модель
Откройте модель. Получить доступ к 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));
restore
| Simulink.getSuppressedDiagnostics
| Simulink.restoreDiagnostic
| Simulink.SimulationMetadata
| Simulink.suppressDiagnostic
| Simulink.SuppressedDiagnostic