Create Diagnostic Stages

In the Diagnostic Viewer, errors, warnings, and information messages are displayed in groups based on the operation, such as model load, simulation, and build. These groups are called stages. Thesldiagviewer.createStagefunction enables you to create stages. You can also create child stages for a stage object. A parent stage object must be active to create a child stage. When you create a stage object, Simulink^®initializes a stage. When you close the stage object, Simulink ends the stage. If you delete a parent stage object, the corresponding parent and its child stage close in the Diagnostic Viewer. The syntax for creating a stage is:

stageObject = sldiagviewer.createStage(StageName,'ModelName',ModelNameValue)

In this syntax,

my_stage = sldiagviewer.createStage('Analysis','ModelName','vdp');

Report Diagnostic Messages

You can use thesldiagviewerfunctions to report error, warning, or information messages in the Diagnostic Viewer. The syntaxes for reporting diagnostic messages are:

Messagedescribes the error, warning, or build information and is a required argument.Messagecan have values in these formats:

Optionally, you can use the'Component'argument and its corresponding value in the syntax to specify the component or product that generates the message, for example,'Simulink'and'Stateflow'.

% Create a Stage to display all the messagesmy_stage = sldiagviewer.createStage('Analysis','ModelName','vdp');% Catch the error introduced in vdp as an exception.trysim卡('vdp');catcherrorend% Report the caught exception as warningsldiagviewer.reportWarning(error);% Report a custom info message to Diagnostic Viewersldiagviewer.reportInfo('My Info message');

Log Diagnostic Messages

You can use thesldiagviewer.diaryfunction to log the simulation warning, error, and build information to a file. The syntaxes for generating log files are:

In this syntax,

% Log messages using sldiagviewer.diarysldiagviewer.diary open_system('vdp') rtwbuild('vdp')% Open diary.txt to view logs.### Startingbuildprocedureformodel:vdp### Buildprocedureformodel:'vdp'abortedduetoanerror....% Log messages using sldiagviewer.diary(filename)sldiagviewer.diary('C:\MyLogs\log1.txt')% Log messages using sldiagviewer.diary(toggle)sldiagviewer.diary('C:\MyLogs\log1.txt')% Switch on logging and specify a log file.open_system ('vdp') rtwbuild('vdp') sldiagviewer.diary('off')% Switch off logging.open_system ('sldemo_fuelsys') rtwbuild('sldemo_fuelsys') sldiagviewer.diary('on')% Resume logging in the previously specified log file.% Log messages using sldiagviewer.diary(filename,'UTF-8')sldiagviewer.diary('C:\MyLogs\log1.txt','UTF-8')