MXAM: Frequently Asked Questions

These are some of the most frequently asked questions:

Questions asked by users
Questions asked by quality/project managers
Questions asked by toolchain managers
Questions asked by check developers


Questions asked by users

Start analysis in MES Model Examiner

How do I start an analysis?

You can start an analysis in the Project perspective.
A default project is already open.
Simply select the 'Analyze' link.

Go top

How do I handle the different views in the report perspective?

The report perspective has different views that interact with one another.

Report application window in MES Model Examiner

On the left-hand side are two navigation views. Use the Document Navigation view to see an overview and filter the reported findings by the document structure. The view on the bottom-left side shows an overview of the selected element.  If you select an element in the tree, all findings for this element and all sub-elements will be displayed in the Findings view. Use the Artifact Navigation view to filter the findings by the artifact/model structure. If you select a model part, e.g. subsystem or chart, the Findings view only displays findings located in the selected model part.

Application window Report in MES Model Examiner Result Description

The Findings view on the top-right side shows all guideline deviations found by the checks.

Select a finding to see the details below in the Finding Details view.

Go top

How do I repair guideline violations?

To apply the automatic repair function, you can either use the tree menu in the Document Navigation view to display only repairable checks, or just look out for the failed symbol with a wrench next to it. You can now select several findings you want to repair by right-clicking on the selection and selecting Repair Finding(s). A dialog then appears that takes you through all selected findings and gives you the option to apply the repair or skip the action. You can also manually repair findings in the model.

Finally, you can right-click the check and select “Rerun” to see if the guideline violations have been resolved.


Go top

How do I justify guideline violations?

You can use annotations to justify guideline violations. Select a finding and press 'Add Annotation' in the context menu. Write a comment and optionally change the result type of the finding. Save your annotations on the second page of the wizard in an annotation definition (file) next to the artifact or in a library. The annotation will be mapped for each run. The annotation details and the original result type are shown in the Finding Details view. Annotations are also included in all report export formats.

Go top

How do I save my report?

Application window in MES Model Examiner Save report

To save a report select the report and press 'Save Report' in the context menu. The report will be saved in MXMR format. This format can be used in the user interface (File > Open Report, or drag&drop an .mxmr file into the MXAM application window).

You can also export your report in HTML, PDF, or Excel format.

Go top

Why can't I see the MXAM Report Adapter in the Artifacts Wizard?

Please check what version of MXAM you are using, as not all versions support this feature. It is only available in the MXAM Functional Safety Solution starting with version 5.0.

Go top

How do I select the reports that I want to compare?

Application window in MES Model Examiner Manage Compare Report

The Artifacts Wizard allows you to select the base report as a tool or file artifact.

The other report will automatically be the last report in the report perspective as soon as the analysis is started.

Go top


Questions asked by quality/project managers

How do I set up and configure a new MXAM project?

Application window in MES Model Examiner Manage New Project

Firstly, we recommend that some thought is given to how the MXAM setup and all configuration files should be included in an existing toolchain environment and how these can be shared with a development team. To create a new MXAM project file, choose 'File >  New... > Project > MXAM Project'. The project editor opens up in the project perspective. Use the settings page to configure guideline documents, report and annotation settings etc.

Go top

How do I customize the check behavior?

Application window in MES Model Examiner Manage customize checkparameter

Most checks provide parameters that can be used to configure custom check behavior. In the tool menu, choose 'Settings > Check Parameters' or double click a parameter in the 'Details' view to open the `Customize Check Parameters Wizard'. Use the search and filter options to find the right parameter and select it in the table. In the Parameter Settings section, overwrite the default value for your project configuration.

Go top

How do I ignore elements and exclude them from being analyzed?

Application window in MES Model Examiner Manage Ignore elements

There are two ways to exclude elements from the analysis:

You can use global MATLAB® parameters to exclude Simulink® libraries, block types, or mask types.
These elements are filtered during analysis and are not included in the report.

Alternatively, you can use ignore-lists to exclude elements, e.g. subsystems, block types, or mask types, for all or for specific checks.

Check findings of ignore-list elements are included in the report and marked as 'ignored'.

Go top

How do I create a customized guideline document?

Application window in MES Model Examiner Manage open new guideline document

MXAM includes a set of guideline documents that you can find in the Guideline Documents view of the Library Browser perspective.

To create a custom document, select 'New...' in the view toolbar to create a new document, or select an existing document, press 'Save as...', and change the document according to your preferences.

A document editor opens to edit the chapter structure and add guidelines.

Go top


Questions asked by toolchain managers

What are the system requirements to run MXAM?

Be aware of the system requirements for the operating system and respectively for MATLAB, ASCET, or Excel depending on the artifacts that are used for the analysis.

Go top

How do I install MXAM?

MXAM can be installed with the EXE installer in any directory. The installer can also be used to automate the installation. Upon request a zip package is available for special IDEs. For more details, click here: Installation

Go top

How do I set up the license?

MXAM can be used with a node-locked, dongle, or floating network license. For a detailed description, see how to configure the license here: MES Quality Tools License Configuration

Go top

How do I automate an analysis?

To automate an analysis, MXAM provides different batch interfaces. The headless windows interface, MATLAB API, JAVA API, or web service interface (upon request) can be used to control MXAM from another application or continuous integration server.

Go top

How can I execute custom code during an analysis in MATLAB?

Application window in MES Model Examiner Manage Hooks List

MXAM provides hook/callback functions that can be used to customize the startup, shutdown, or the analysis.

These hook functions are located in the doc directory of MXAM. To use a hook function, copy the function to a different directory, customize it, and make sure it is in the MATLAB path during startup or analysis.

Go top


Questions asked by check developers

Application window in MES Model Examiner Manage Developer Guide

How do I implement custom checks?

To implement custom checks, please refer to the developer guide for helpful information and how to get started.

Go top