Support MES M-XRAY® (MXRAY)

What is MXRAY?

MXRAY is a tool that has been designed to perform architectural analysis on Simulink/Stateflow and TargetLink models, thereby supporting model development and the model review process. MXRAY has been developed to analyze models of every size: from single subsystems to complex models consisting of hundreds of subsystems and dozens of libraries. The results of analysis are compiled in reports designed for use in model development and model reviews. The reports can also be used to evaluate model quality as well as for project management purposes.

What's new?

Highlights in MES M-XRAY® (MXRAY) v.4.3 (LTS)

For users who currently use MXRAY locally or automated as a stand-alone tool, MES will release a long-term supported version: MES M-XRAY v.4.3 (LTS). Support for bug fixing of the LTS is guaranteed for the next five years until April 30, 2025.

MES software support in conjunction with third-party software (i.e. MATLAB Simulink/Stateflow, dSPACE TargetLink, ETAS ASCET) is generally limited to the corresponding third-party software versions released before the release of the respective MES software version. All supported versions are listed in the release notes.

MXRAY v.4.2

Highlights in MES M-XRAY® (MXRAY) v.4.2

Identify functional and structuring subsystems (BETA)
A new metric category provides a set of metrics that allow to distinguish between functional and structuring subsystems at a glance.

Configure custom color maps for any metric value

MXRAY v.4.1

Highlights in MES M-XRAY® (MXRAY) v.4.1

Enhanced understanding of Stateflow quota in Simulink/Stateflow models:
The new metric 'Global Complexity Stateflow' estimates the proportion of Stateflow parts in the 'Global Complexity' of the model.

Html-report is now stored in a single file

 

System Requirements

The following system requirements must be in place to use MXRAY:

  • Windows (XP, Vista, Windows 7+8+10 - 32 and 64-bit versions)
  • MATLAB® R2009b ... R2019b
  • Simulink and Stateflow, depending on the models you wish to analyze
  • (Optional) TargetLink V 3.x, 4.x, 5.x (base suite)
  • (Optional) Excel for Windows

Update to the Latest Version

  • If you added MXRAY folders permanently to the MATLAB path, please remove all these folders from the path.
  • If you added a call to path_mxray to your startup.m and used a folder with version postfix (e.g. x:\project\matlab\mxray_3_7), then please update the call to the folder of the new installation (e.g. run('C:\Program Files\mxray_4_3\path_mxray');
  • If you installed the old version to a folder with version postfix (e.g. x:\project\matlab\mxray_3_7), you can keep that directory as a backup.
  • If you installed without version postfix, you could rename the old installation directory to one with version postfix as a backup.
  • Then proceed according to the installation instructions given below (including license configuration).

Installation

  • Extract the MXRAY zip file (e.g. mxray_4_3.zip) into a target folder with write access. Suggestions:
    • %MATLAB_ROOT%\toolbox\mxray_4_3
    • %MATLAB_ROOT%\toolbox\mxray
    • C:\Program Files\mxray
    • x:\project\matlab\mxray_4_3
    Please keep all the subdirectories.
  • Note: If you want to install MXRAY on a Jenkins machine to use it together with the MES Jenkins-Plugin, it is recommended to skip the next steps and proceed with the license configuration. The next steps add MXRAY permanently to the MATLAB path. But for the Jenkins Plugin it is recommended to specify the MXRAY installation path in Jenkins' global tool configuration.
  • Add a call to the path_mxray.m script from the target folder to your MATLAB startup.m file. Example call: run('C:\Program Files\mxray\path_mxray');
    Please make sure, that there is no call to path_mxray of an old MXRAY installation left!
    If you are not sure whether you have any startup.m file yet, type which startup.m in MATLAB command line.
    If result is not empty, add the call from above to this file.
    If result is empty, create a new startup.m file in your userpath. Type userpath in MATLAB command line to get your userpath. Add the call from above to the newly created file (type also doc startup in MATLAB command line for help).
  • Restart MATLAB. Please check if you correctly added the path_mxray call to your startup.m file by typing which('mxray') in the MATLAB command prompt which should return the path of the mxray.p file.

Quick Start

Starting MXRAY

    • Open MATLAB.
    • Type mxray in the command prompt.
    If an 'Undefined function' error occurs, please ensure that you added the correct call to path_mxray to your startup.m (see installation instructions above). If a license exception occurs, please ensure that you followed the license configuration instructions above.

Starting an analysis

  • Open a model in MATLAB/Simulink
  • Press "Add open models" in the MXRAY GUI
  • Press "Create Report" in the MXRAY GUI

Suggestions

If you have any suggestions to help us improve MES M-XRAY, please do not hesitate to contact us:
Email: mxray@model-engineers.com

User Guide

MXRAY User Guide

The MES User Guide presents clear instructions on how to work with M-XRAY® (MXRAY). It provides users with information about getting started and working with MXRAY.
You can easily call the User Guide by clicking on “Help” in the tool (see image).


Release Notes - MXRAY v.4.3 Final LTS (April 2020)

  • Final long-term support (LTS) version:
      This is the final version of MXRAY, since the functionality of MXRAY has been almost completely integrated into MXAM at the time of this release. New features will only be developed in MXAM in the future. This MXRAY LTS version will be supported in the long term and is compatible with all Matlab versions from R2011b to R2019b.
  • BugFix: Fixed a bug that caused an error when calculating the
      'Ineffective Interface' metric on a model that contains a bus creator where Simulink is unable to determine the signal hierarchy at the output port of that bus creator.