Refactor Models

Identify modeling clones and patterns to transform model

Use the Model Transformer and the Clone Detector to refactor a model to improve model componentization, readability and enable reuse.

Use the Model Transformer to:

Identify modeling patterns that qualify for transformation into Variant Source or Variant Subsystem blocks. Using Variant Subsystem and Variant Source blocks helps in the reusability of a model for different conditional expressions called variant choices. The active model is a combination of a fixed structure and variable components that you activate depending on the variant choice that you select.
Identify data store blocks that qualify for elimination. Eliminating data store blocks improves model readability by making data dependency explicit.
Identify n-D Lookup Table blocks that qualify for transformation into shared Prelookup blocks and multiple Interpolation blocks. This transformation improves the simulation efficiency.
Identify multiple Interpolation Using Prelookup blocks that qualify for transformation into a single Interpolation Using Prelookup block in a modeling pattern. This transformation improves the generated code efficiency.

Use the Clone Detector to:

Identify clones and create a model with the clones replaced by links to the subsystem blocks in a library. Replacing clones with links to library blocks enables component reuse.
Identify and replace clones in a model with the subsystem references.

Functions

expand all

Model Transformer

`mdltransformer`	Open Model Transformer
`Simulink.ModelTransform.BusTransformation.identify`	Identify Bus Selector and Bus Creator blocks to transform (Since R2022b)
`Simulink.ModelTransform.BusTransformation.refactor`	Replace Bus Selector and Bus Creator blocks with In Bus Element and Out Bus Element blocks (Since R2022b)
`Simulink.ModelTransform.CommonSourceInterpolation.identifyCandidates`	Identify eligible Interpolation Using Prelookup blocks to transform (Since R2021b)
`Simulink.ModelTransform.CommonSourceInterpolation.refactorModel`	Replace Interpolation Using Prelookup blocks (Since R2021b)

Clone Detector

`clonedetection`	Open Clone Detector app
`Simulink.CloneDetection.findClones`	Find clones in a model (Since R2021a)
`Simulink.CloneDetection.replaceClones`	Replace clones in a model (Since R2021a)
`Simulink.CloneDetection.checkEquivalency`	Check equivalency of clone-replaced model and original model (Since R2021a)
`Simulink.CloneDetection.highlightClone`	Highlight clone in a Simulink model (Since R2021b)
`Simulink.CloneDetection.generateReport`	Generate clone detection report (Since R2023b)

Classes

expand all

Model Transformer

`Simulink.ModelTransform.BusTransformation.Result`	Results of identified Bus Selector and Bus Creator blocks (Since R2022b)
`Simulink.ModelTransform.CommonSourceInterpolation.Results`	Results of search for eligible Interpolation Using Prelookup blocks (Since R2021b)
`Simulink.ModelTransform.CommonSourceInterpolation.RefactorResults`	Refactored model results (Since R2021b)

Clone Detector

`Simulink.CloneDetection.Settings`	Conditions for findClones function (Since R2021a)
`Simulink.CloneDetection.Results`	Results of find clones (Since R2021a)
`Simulink.CloneDetection.ReplacementConfig`	Conditions for clone replacement function (Since R2021a)
`Simulink.CloneDetection.ReplacementResults`	Results of replace clones (Since R2021a)
`Simulink.CloneDetection.EquivalencyCheckResults`	Results of equivalency check (Since R2021a)

Apps

Model Transformer	Enable model transformation by identifying and refactoring the modelling patterns to optimize the models
Clone Detector	Enable model refactorization and subsystem reuse in models by identifying and replacing clones

Topics

Model Transformer

Transform Model to Variant System
Use the Model Transformer tool to transform a model into a variant system.
Improve Model Readability by Eliminating Local Data Store Blocks
Use the Model Transformer tool to make data dependency explicit in a model by replacing data store blocks with either a direct signal line, a Delay block or a Merge block.
Improve Efficiency of Simulation by Optimizing Prelookup Operation of Lookup Table Blocks
Use the Model Transformer tool to convert multiple n-D Lookup Table blocks into shared Prelookup blocks and multiple Interpolation blocks.
Improve Code Efficiency by Merging Multiple Interpolation Using Prelookup Blocks
Use the Model Transformer tool to transform a modeling pattern with multiple Interpolation Using Prelookup blocks into a single Interpolation Using Prelookup block.

Clone Detector

Enable Component Reuse by Using Clone Detection
Use the Clone Detector app to replace subsystem clones with library blocks.
Replace Exact Clones with Subsystem Reference
Use the Clone Detector app to replace exact clones with subsystem reference blocks.
Detect and Replace Subsystem Clones Programmatically
Use the Clone Detection APIs to identify and replace subsystem clones in a model.
Find Clones Across the Model
Use the Clone Detector to identify and replace clones across the model.

Featured Examples

Detect and Replace Clones Programmatically in a Loop on Multiple Models

Programmatically detect and replace clones on multiple models in a loop by operating on models individually. For more information about Clone Detection APIs, see Detect and Replace Subsystem Clones Programmatically.

Open Script

Detect Clones Programmatically on Multiple Models Across Different Folders

Programmatically detect clones across multiple models located in different folders. For more information about the clone detection APIs, see Detect and Replace Subsystem Clones Programmatically.

Running Clone Detection Custom Script in a Project

Run a custom script for detecting clones on the set of Simulink® model files managed in a project. Creating a custom script would help to organize and automate the large modeling projects. For more information on setting up a custom task, see Run Custom Tasks with a Project.

Open Script

Identify Data Type Match with Library Clone Detection

Programmatically detect clones and determine whether the inport data types of the library subsystem matches the inport data types of the clones in a model. For more information about Clone Detection APIs, see Detect and Replace Subsystem Clones Programmatically.

Open Script