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 tool chain managers
Questions asked by check developers

 

Questions asked by users

How can I start an analysis?

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

Go top

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

The report perspective has different views that interact with each other.

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.

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 can I repair guideline violations?

To make use of the automatic repair function, use the tree menu in the Document Navigation view to show repairable checks only. Right-click on the check in the tree and press 'Repair'.

You can also manually repair findings in the model. Afterwards, right-click the check and press 'Rerun' to see whether the guideline violations have been solved.

Go top

How can I justify guideline violations?

To justify guideline violations you can use annotations. 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 can I save my 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 do I not see the MXAM Report Adapter in the Artifacts Wizard?

Most likely your MXAM version does not support this feature. It is only available in the MXAM Functional Safety Solution starting with version 5.0.

Go top

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

The Artifacts Wizard will allow 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 can I setup and configure a new MXAM project?

First it is recommended to think about how the MXAM setup and all configuration files should be included in an existing tool chain 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 can I customize the check behavior?

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 can I ignore elements and exclude them from being analyzed?

There are two ways to exclude elements from the analysis:

You can use global MATLAB\ :sup:® parameters to exclude Simulink\ :sup:® 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 can I create a customized 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 as you like.

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

Go top

 

Questions asked by tool chain 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 can 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 can I setup 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 can 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?

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

How can I implement custom checks?

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

Go top