View Diagnostics
You can view and diagnose errors and warnings generated by your model using theDiagnostic Viewer. TheDiagnostic Viewerdisplays three types of diagnostic messages: errors, warnings, and information. A model generates these messages during a runtime operation, like model load, simulation, or update diagram.
You can dock the diagnostic viewer to a model to view diagnostics specific to the model or you can have a standalone diagnostic viewer to view the diagnostics of all the models.
To dock the diagnostic viewer to a model, go toDebug>Diagnostics>Docked Diagnostic Vieweror go toModeling>Environment>Simulink Preference>Editor>Use docked Diagnostic Viewer
Note
Docking the diagnostic viewer is a system-wide operation. You cannot change the preferences model-wise.
The diagnostic viewer window is divided into:
Toolbar menu: Displays various commands to help you manage the diagnostic messages. For more information, seeToolbar.
Diagnostic Message pane: Displays the error, warning, and information messages. For more information, seeDiagnostic Message Pane.
Suggested Actions: Displays suggestions and fixes to correct the diagnostic errors and warnings. For more information, seeSuggested Actions.
Toolbar
To manage the diagnostic messages, use theDiagnostic Viewertoolbar.
Menu | Action |
---|---|
View all error messages | |
View all warning messages | |
View all information messages | |
|
Search messages for specific keywords and navigate between messages |
|
The time and the events appear in this drop-down. You can view diagnostic messages specific to an event by clicking on the event. |
Reports |
You can
Note You can right-click anywhere inside the messages to save or copy the messages specific to the event. |
Settings |
Group similar warnings. Set maximum number of models to display in tabbed panes and the maximum number of events to display per model |
Diagnostic Message Pane
诊断信息窗格显示错误,佤邦rning, and information messages in a tabbed format. These messages are color-coded for distinction and are hierarchical.
A new stage is generated for each successive event, you can save or clear stage. Each stage represents a single event such as model load, update diagram, or simulation.
Different types of diagnostic messages are:
Information message: Displays the information related to a model load. Information messages are marked as.
High priority warning: Displays the errors encountered during model load as a high priority warning. Any subsequent operation, like update on the model without rectifying the high priority warning messages are marked as errors. High priority warnings are marked as.
Warning: Displays the warnings associated during an operation on a model. Warnings are marked as.
Error: Displays the errors associated during an operation on a model. Errors are marked as.
Tip
To locate the source of error, click the hyperlink in the message. The source of error in the model is highlighted.
Trace Diagnostics Location
The Diagnostic Viewer can trace the location of an error so that you can investigate the errors in your model easily. If the error is in a file that is being called from another file, the diagnostic shows up as an expandable stack. You can expand or collapse the stack, as required. Expanding the stack displays information about the file and the line in which the error or warning is located. You can click any of the links to go the error or warning. You can also see the same diagnostic message with stack trace enabled, while using thesim
command in MATLAB®.
Note
Tracing the exact location of an error is not applicable for protected files.
Identify Diagnostics from Custom Compilers
Diagnostic viewer can recognize errors and warnings from builds generated by custom compilers. You can specify compiler-specific patterns using the following directives:
% Here tool is the buildtool obtained from the toolchaintool.setDirective ('WarningPattern','warning #(\d+):');%Specifies warning patternstool.setDirective ('ErrorPattern','error:');%Specifies error patterntool.setDirective ('FileNamePattern','[^\s]*\w+\.(c|h)');%Specifies file name patterntool.setDirective ('LineNumberPattern','\(\d+\)');%Specifies line number pattern
For more information about creating aToolchainInfo
object, seeRegister Custom Toolchain and Build Executable(Simulink Coder).
Suppress Diagnostics
Use theSuppression Managerto suppress certain numerical diagnostics (for example, overflow, saturation, precision loss) for specific objects in your models. You can also suppress certain errors that have the diagnostic level set toerror
in theDiagnosticssection of the Model Configuration Parameters. You can add a comment for the suppressed diagnostics.
To suppress a diagnostic from the specified source, clickSuppressin the Diagnostic Viewer. Add appropriate comments to the suppressed diagnostic.
To view the suppressed diagnostic, on theDebugtab, clickDiagnostics>Suppression Manager. To restore the suppressed diagnostic, selectRestore. Diagnostic suppressions are saved with the model and persist across sessions.
TheSuppression Manager显示模型名称,抑制位置和comments of the diagnostic in tabular format. Using theActionsmenu, you can add and edit comments, suppress a diagnostic, or move a diagnostic to the subsystem level from the block level (Add to Parent Level).
For more information, seeSuppress Diagnostic Messages Programmatically.
Suggested Actions
Diagnostic viewer provides suggestions and fixes for diagnostic error and warning messages. These suggestions and fixes are provided in theSuggested Actionssection of diagnostic message pane.
A diagnostic error or warning can have multiple fixes and suggestions. Each fix is associated with aFixbutton.
You can click theFixbutton for the most suitable fix to rectify the error automatically. In some cases, you can provide the fix by one of these ways:
Enter the values in the available edit boxes.
Select a value from one of the listed values from a combo box.
TheFixbuttons for a diagnostic error or warning are no longer available after a fix is successfully applied. If a fix was unsuccessful, a failure message is displayed in theSuggested Actionssection.
Suggestions are provided for errors and warnings that cannot be fixed automatically.
Note
TheSuggested Actionssection is available only for the diagnostic errors or warnings that have a predefined fix.