Support MES Model & Refactor® (MoRe)

What is MoRe?

MES Model & Refactor® (MoRe) is a productivity tool that makes modeling with MATLAB Simulink® faster, easier and less error-prone. MoRe supports users by simplifying and accelerating model editing and reducing monotonous work steps. The tool facilitates the modeling process as a whole, in particular the refactoring of models.

 

What's New?

Highlights in latest versions of MES Model & Refactor® (MoRe) v.4.0

Auto Layout
This new layout action automatically arranges all blocks and routes all signal lines in the current subsystem for a clean and uniform layout, saving you time while modeling.

 

MoRe v.3.2

Highlights in MES Model & Refactor® (MoRe) v.3.2

Bug Fixes

    • Arrange Port Blocks: Fixed a bug that caused the port blocks to be incorrectly placed in some rare cases. They were erroneously placed either next to unselected port blocks or far above or below the other blocks of the subsystem.
    • All actions: Fixed a bug that caused a referenced model to be reopened in an additional editor window, when starting an action within that referenced model. This only occurred if the referenced model was opened in the same editor window as its parent model, which is possible since Simulink® R2019a.

Supported MATLAB® Versions

  • MoRe now supports MATLAB versions up to 2022a.
MoRe v.3.1

Highlights in MES Model & Refactor® (MoRe) v.3.1

Enhanced “Arrange Port Blocks” action
The vertical positioning of port blocks has been significantly improved in order to minimize bends and crossings of signal lines. This reduces the need for possible manual rework especially in larger subsystems with many elements.

MoRe v.3.0

Highlights in MES Model & Refactor® (MoRe) v.3.0

Automatic Port Numbering during Action
Actions that affect signals and their ports now also automatically reorder and number ports in reference to optimal readability and layout. This reduces the need for manual reworking.

MoRe v.2.18

Highlights in MES Model & Refactor® (MoRe) v.2.18

Improvements
TargetLink® 5.2 Support: MoRe now fully supports TargetLink 5.2. Previously, MoRe actions affecting the TargetLink simulation frame issued a warning regarding the obsolete 'tl_check_ports' function. This warning has been resolved now.

MoRe v.2.17

Highlights in MES Model & Refactor® (MoRe) v.2.17

New Layout Action "Adjust Blocks to Sources"

  • This action adjusts the position and height of blocks in relation to their source ports.
  • It complements the "Adjust Blocks to Destinations" action but works in the opposite way.
  • In the simplest case, this lets you align the position of blocks with their source ports.
  • However, the action also resizes blocks with multiple incoming lines to straighten the lines.
  • You can also apply the action to an entire area of a subsystem to straighten the lines and improve the layout.

New Signal Routing Action "Add Output Signal up to Higher Level"

  • Use this action to add a new output signal that goes from the current subsystem you are working on up to a higher level (or top level) subsystem of your choice. This helps you to focus on the current subsystem. You can connect the newly created higher level outport to an external signal later.
  • It complements the "Add Input Signal from Higher Level" action but works in the opposite way.
  • The new signal can start from a block with an open outport or a line in the current subsystem. If nothing is selected, the signal starts from the new outport block in the current subsystem, as shown in the following example.
MoRe v.2.16

Highlights in MES Model & Refactor® (MoRe) v.2.16

Adjust Blocks to Destinations
This new layout action adjusts the position and height of blocks in relation to their destination ports. This straightens the signal lines to the destination blocks and thus improves the layout. The action can be applied to individual blocks or to an entire area of a subsystem to improve the overall layout.

Rename Signal and Ports Forward
The action can also follow the signal flow into model references, when requested, to continue the renaming within the referenced model now.

MoRe v.2.15

Highlights in MES Model & Refactor® (MoRe) v.2.15

New Layout Action "Adjust Blocks to Destinations"

  • This action adjusts the position and height of blocks in relation to their destination ports.
  • In the simplest case, this lets you align the position of blocks with their destination ports.
  • However, the action also resizes blocks with multiple outgoing lines to straighten the lines.
  • In particular, you can also apply the action to an entire area of a subsystem to straighten the lines and improve the layout.
MoRe v.2.14

Highlights in MES Model & Refactor® (MoRe) v.2.14

  • Action demo models: A new demo model for "Rename Signal and Ports Forward" is available so that you can try out the action and learn how to use it. The model can be opened directly from the MoRe demo model, from the documentation of the action, or from the "demo_models" folder in the installation directory.
  • Add Cross-Hierarchy Signal: A better suggestion for a name is prefilled in the "Name of Created Ports" field in the input dialog. Now the name suggestion is generated from the signal name if no suitable name can be derived from the source port of the selected signal.
  • Toolbox File: Installing the evaluation version is easier now as it is no longer necessary to add the license file manually.
MoRe v.2.13

Highlights in MES Model & Refactor® (MoRe) v.2.13

  • MoRe is now also available as a MATLAB toolbox. This allows you to easily install and update MoRe. You will find the toolbox file (MES_MoRe.mltbx) together with the standard distribution in the delivered zip file.
  • The installation of the toolbox is possible in all MATLAB versions from 2014b and newer.
  • It may be necessary to add the license file to the toolbox manually after installation. For instructions see README_installation_MoRe_EN.html in the zip file.
MoRe v.2.12

Highlights in MES Model & Refactor® (MoRe) v.2.12

Improvements
Preferences: You can now use "Reset Preferences to Default" from the "Preferences" submenu to reset any of the configuration files (MoRe config file, keyboard shortcuts file, and hook for block parameters) to factory defaults.

MoRe v.2.11

Highlights in MES Model & Refactor® (MoRe) v.2.11

Improvements
API extension: With the new mes.more.api.arrangePortBlocks function, you can use the "Arrange Port Blocks" action in your own MATLAB® scripts.

MoRe v.2.10

Highlights in MES Model & Refactor® (MoRe) v.2.10

Improvements
API extension: With the new mes.more.api.moveBlocksDown function, you can use the "Move Blocks Down" action in your own MATLAB® scripts.

 

Installation

MoRe can be installed either as a toolbox or manually. We strongly recommend the toolbox option because it is much easier to install and update.

Install as toolbox (recommended)
NOTE: Do not install the toolbox on a network drive! Installing a MATLAB toolbox on a network drive can severely slow down MATLAB. To check the toolbox installation path, please open MATLAB's "Preferences" and navigate to the submenu "Add-Ons" or "Apps". Here you can check the installation path in the "Installation Folder" field and change it if necessary.

  1. Extract the MES MoRe zip file (e.g., MES_MoRe_4_0.zip).
  2. In MATLAB, navigate to the directory where you extracted the MES MoRe zip file.
  3. In the "Current Folder" section of the MATLAB editor, double click the "MES_MoRe.mltbx" toolbox.
  4. Wait until MATLAB has finished installing the toolbox.
  5. Call sl_refresh_customizations in the MATLAB command line. There should be an MES MoRe menu entry in the Simulink editor now.
  6. (Optional) Some actions from the "Analyze" submenu require Graphviz to be installed:
    • Download and install Graphviz from http://www.graphviz.org/
    • Add the folder containing the dot.exe of Graphviz to the PATH environment variable of Windows (e.g., C:\Program Files (x86)\Graphviz 2.28\bin).

Install manually

  1. Extract the MES MoRe zip file (e.g. MES_MoRe_4_0.zip) into a target folder with write access. Suggestions:
    • C:\Program Files\MES_MoRe
    • %MATLAB_ROOT%\toolbox\MES_MoRe_4_0
    • %MATLAB_ROOT%\toolbox\MES_MoRe
    • x:\project\matlab\MES_MoRe_4_0

Please keep all the subdirectories.

  1. If you extracted the zip file to the MATLAB toolbox folder (%MATLAB_ROOT%\toolbox), then call rehash toolboxcache once in the MATLAB command line.
  2. For permanent installation (recommended):
    • Add a call to the MoRe\init_MoRe.m script from the target folder to your MATLAB startup.m file. Example call: run('C:\Program Files\MES_MoRe\MoRe\init_MoRe');
      Please make sure that there is no call to init_MoRe of an old 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. There should be an MES MoRe menu entry in the Simulink editor now.
  1. For temporary usage (not recommended): Call init_MoRe from the MoRe subfolder of the target folder in the MATLAB command line. This might throw warnings like "Objects of XXX class exist - not clearing java", if other tools are holding locked references to java objects. In that case, please follow the instructions for permanent installation above.
  2. (Optional) Some actions from the "Analyze" submenu require Graphviz to be installed:
    • Download and install Graphviz from http://www.graphviz.org/
    • Add the folder containing the dot.exe of Graphviz to the PATH environment variable of Windows (e.g. C:\Program Files (x86)\Graphviz 2.28\bin).

Update

To update to a new version of MoRe, please follow these steps:

1. Uninstall old version

If updating from the old toolbox version to the new toolbox version

  • Skip this step.

If updating from the old manually installed version to any new version

  1. Call path_MoRe(false) in the MATLAB command line.
  2. If you added a call to init_MoRe to your startup.m, then remove this call.
  3. Delete the directory of the old installation or keep it as a backup.

If updating from the old toolbox version to the new manual installation version

  1. Navigate to the MATLAB Home tab. In the Environment or Resources section, open the Add-On Manager.
  2. Find the old MoRe toolbox entry and select "Uninstall" in the context menu.
    Please note: MATLAB may ask you to delete some directories manually. However, this is not mandatory.

2. Install new version

  • Depending on whether you want to install the new version manually or as a toolbox, proceed as described in the following "Installation" section.
  • You can skip the "License configuration" part if a floating license is already installed in the old version.

3. Import old configuration files (optional)

After installation, you can import all configuration files of the old version via "Import Previous Preferences" from the "Preferences" submenu of MoRe. This import action requires the old version to be 2.9 or newer. This import is only necessary if you have changed any configuration files from the "Preferences" submenu in the old version.

System Requirements

The following system requirements must be in place to use MES MoRe:

  • Windows (XP, Vista, Windows 7+8+10 - 32 and 64-bit versions)
  • MATLAB® R2014b ... R2022a
  • Simulink

Quick Start

Starting MoRe

  • After installation, "MES MoRe" is available as a separate entry in the Simulink menu and context menu. It does not need to be started manually.

Starting an Action in MoRe

  • Open a demo model by typing “fuelsys” in the MATLAB command prompt
  • Select the two subsystems on the root level of the fuelsys model
  • Click “MES MoRe” in the Simulink menu and then select "Merge Subsystems"
  • To undo the action, select "Undo" from the “MES MoRe” menu

Suggestions

If you have any suggestions to help us improve MES Model & Refactor, please do not hesitate to contact us:
Email: more@model-engineers.com

User Instruction

MXRAY User Guide

User Guide

The MES MoRe User Guide presents clear instructions on how to work with MES Model & Refactor® (MoRe). It provides users with information about getting started and working with MoRe.
Click on “MES MoRe”->”Help”->”Documentation” to find a description of all actions available in MoRe (see image).

How-To Videos

Layout

Signal Routing

Partition

Interface

Bus

Analyze

 

 

Release Notes - MoRe v.4.0 (October 2022)

New Layout Action "Auto Layout"

  • This action automatically arranges all blocks and routes all signal lines in the current subsystem, for a clean and uniform layout.
  • It is based on established algorithms for the automatic layout of block diagrams.
  • The action is available for MATLAB® versions 2018b and newer.

Bug Fixes

  • All actions: Fixed a bug that caused an error when starting an action in a Variant Subsystem.
  • All actions that change signal lines: Fixed a bug that occasionally triggered multiple warning messages in the MATLAB command window when undoing the action.