fix
Class: ModelAdvisor.EdittimeCheck
Namespace: ModelAdvisor
Syntax
success = fix(obj,violation)
Description
is
for specifying an algorithm that fixes each block success
= fix(obj
,violation
)violation
that violates
the custom edit-time check, obj
. The blocks that violate the edit-time
check are identified as part of the analysis done by the blockDiscovered
and finishedTraversal
methods.
Input Arguments
obj
— Edit-time check object
object of a class that derives from the
ModelAdvisor.EdittimeCheck
class
Edit-time check object for which you want to provide a fix for block violations,
specified as an object of a class that derives from the
ModelAdvisor.EdittimeCheck
class.
violation
— Blocks that violate edit-time check
ModelAdvisor.ResultDetail
| array of ModelAdvisor.ResultDetail
objects
Blocks that violate the edit-time check, specified as a ModelAdvisor.ResultDetail
object or an array of
ModelAdvisor.ResultDetail
objects.
Output Arguments
success
— Whether a fix is successful
true
| false
At the beginning of your algorithm, to indicate that a fix has not yet been applied,
specify a value of false
. At the end, to indicate that the fix has
been successfully applied, specify a value of
true
.
Examples
Create Custom Edit-time Check for Inport and Outport Blocks
Create a custom edit-time check that checks that Inport and Outport blocks have certain colors depending on their output data types.
Obtain a model to try out the Model Advisor check.
openExample('AdvisorCustomizationExample')
Save the model to your working folder. Close the model.
To register the custom edit-time check, create an
sl_customization
function. The
sl_customization
function accepts one argument, a customization
manager object. To register the custom check, use the
addModelAdvisorCheckFcn
method. The input to this method is a
handle to the check definition function. For this example,
defineCheck
is the check definition function. Create the
sl_customization
function and save it to your working
folder.
function sl_customization(cm)
cm.addModelAdvisorCheckFcn(@defineCheck);
Create the check definition function. Inside the function, create a ModelAdvisor.Check
object and specify
the Check ID as an input argument. Then, specify the
ModelAdvisor.Check
Title
and CallbackHandle
properties. The
CallbackHandle
property is the name of the class that you
create to define the edit-time check. For this example,
MyEditTimeChecks
is the package name and
PortColor
is the class name. Then, publish the check to a new
folder in the Model Advisor. For this example, the folder name is DEMO:
Edit-time Checks. For this example, create a
defineCheck
function and include the code below in it. Save
the defineCheck
function to your working folder.
function defineCheck rec = ModelAdvisor.Check("advisor.edittimecheck.PortColor"); rec.Title = 'Check color of Inport and Outport blocks'; rec.CallbackHandle = 'MyEditTimeChecks.PortColor'; mdladvRoot = ModelAdvisor.Root; mdladvRoot.publish(rec,'DEMO: Edit-time Checks');
Create a class that derives from the ModelAdvisor.EdittimeCheck
abstract base class. For this example, create a class file named
PortColor.m
. Copy the code below into the
PortColor.m
file. Then, create a folder named
+MyEditTimeChecks
and save the PortColor.m
file in that folder. The class must be in a folder that has the same name as the
package name.
The PortColor
class defines three methods:
PortColor
, blockDiscovered
, and
fix
. The PortColor
method sets the
CheckId
and TraversalType
properties. This
check has a traversal type of
edittimecheck.TraversalTypes.BLKITER
because the check must
check newly added and edited blocks, but it does not have to check for affected
blocks in the same subsystem or model as the edited or newly added blocks. The
blockDiscovered
method contains an algorithm that checks the
color of Inport and Outport blocks. The fix
method updates blocks
that do not have correct colors.
classdef PortColor < ModelAdvisor.EdittimeCheck % Check that ports conform to software design standards for background color. % % Background Color Data Types % orange Boolean % green all floating-point % cyan all integers % Light Blue Enumerations and Bus Objects % white auto % methods % Set the Check ID and traversal type. function obj=PortColor(checkId) obj=obj@ModelAdvisor.EdittimeCheck(checkId); obj.traversalType = edittimecheck.TraversalTypes.BLKITER; end % Specify the edit-time check algorithm using the blockDiscovered method. function violation = blockDiscovered(obj, blk) violation = []; % To check when this check gets called, insert a breakpoint here. if strcmp(get_param(blk,'BlockType'),'Inport') || strcmp(get_param(blk,'BlockType'),'Outport') dataType = get_param(blk,'OutDataTypeStr'); currentBgColor = get_param(blk,'BackgroundColor'); if strcmp(dataType,'boolean') if ~strcmp(currentBgColor, 'orange') % Create a violation object using the ModelAdvisor.ResultDetail class. violation = ModelAdvisor.ResultDetail; ModelAdvisor.ResultDetail.setData(violation,'SID',Simulink.ID.getSID(blk)); violation.CheckID = obj.checkId; violation.Description = 'Inport/Outport blocks with Boolean outputs should be orange.'; violation.title = 'Port Block Color'; violation.ViolationType = 'Warning'; end elseif any(strcmp({'single','double'},dataType)) if ~strcmp(currentBgColor, 'green') violation = ModelAdvisor.ResultDetail; ModelAdvisor.ResultDetail.setData(violation,'SID',Simulink.ID.getSID(blk)); violation.CheckID = obj.checkId; violation.Description = 'Inport/Outport blocks with floating-point outputs should be green.'; violation.title = 'Port Block Color'; violation.ViolationType = 'Warning'; end elseif any(strcmp({'uint8','uint16','uint32','int8','int16','int32'}, dataType)) if ~strcmp(currentBgColor, 'cyan') violation = ModelAdvisor.ResultDetail; ModelAdvisor.ResultDetail.setData(violation,'SID',Simulink.ID.getSID(blk)); violation.CheckID = obj.checkId; violation.Description = 'Inport/Outport blocks with integer outputs should be cyan.'; violation.title = 'Port Block Color'; violation.ViolationType = 'Warning'; end elseif contains(dataType,'Bus:') if ~strcmp(currentBgColor, 'lightBlue') violation = ModelAdvisor.ResultDetail; ModelAdvisor.ResultDetail.setData(violation,'SID',Simulink.ID.getSID(blk)); violation.CheckID = obj.checkId; violation.Description = 'Inport/Outport blocks with bus outputs should be light blue.'; violation.title = 'Port Block Color'; violation.ViolationType = 'Warning'; end elseif contains(dataType,'Enum:') if ~strcmp(currentBgColor, 'lightBlue') violation = ModelAdvisor.ResultDetail; ModelAdvisor.ResultDetail.setData(violation,'SID',Simulink.ID.getSID(blk)); violation.CheckID = obj.checkId; violation.Description = 'Inport/Outport blocks with enumeration outputs should be light blue.'; violation.title = 'Port Block Color'; violation.ViolationType = 'Warning'; end elseif contains(dataType, 'auto') if ~strcmp(currentBgColor, 'white') violation = ModelAdvisor.ResultDetail; ModelAdvisor.ResultDetail.setData(violation,'SID',Simulink.ID.getSID(blk)); violation.CheckID = obj.checkId; violation.Description = 'Inport/Outport blocks with auto outputs should be white.'; violation.title = 'Port Block Color'; violation.ViolationType = 'Warning'; end end end end % Optionally, provide a fix for the violation object. function success = fix(obj, violation) success = false; dataType = get_param(violation.Data,'OutDataTypeStr'); if strcmp(dataType,'boolean') set_param(violation.Data,'BackgroundColor','orange'); elseif any(strcmp({'single','double'},dataType)) set_param(violation.Data,'BackgroundColor','green'); elseif any(strcmp({'uint8','uint16','uint32','int8','int16','int32'}, dataType)) set_param(violation.Data,'BackgroundColor','cyan'); elseif contains(dataType,'Bus:') || contains(dataType,'Enum:') set_param(violation.Data,'BackgroundColor','lightBlue'); elseif contains(dataType,'auto') set_param(violation.Data,'BackgroundColor','white'); end success = true; end end end
Refresh the Model Advisor to update the cache with the new check on the path.
Advisor.Manager.refresh_customizations
Open the AdvisorCustomizationExample
model.
Open the Model Advisor Configuration Editor by clicking the Modeling tab and selecting Model Advisor > Configuration Editor or by entering this command at the command prompt:
Simulink.ModelAdvisor.openConfigUI;
Create a custom configuration that consists of the custom edit-time check. Save
the configuration as my_config.json
. Close the Model Advisor
Configuration Editor. Set the custom configuration to the
my_config.json
file.
ModelAdvisor.setModelConfiguration('AdvisorCustomizationExample', 'my_config.json');
Turn on edit-time checking by clicking the Modeling tab and selecting Model Advisor > Edit-Time Checks. The Configuration Parameters dialog box opens and you select the Edit-Time Checks parameter. Alternatively, you can enter this command at the command prompt:
edittime.setAdvisorChecking('AdvisorCustomizationExample','on');
To view the edit-time warnings, click the blocks highlighted in yellow.
At the top level of the model, the two Inport blocks have an output data type of int32
. They produce edit-time warnings because they should be cyan. The Outport block does not produce a violation because it has an auto
data type and is white.
To fix the edit-time warnings, in an edit-time check warning window, click Fix.
Version History
Introduced in R2022a
Comando de MATLAB
Ha hecho clic en un enlace que corresponde a este comando de MATLAB:
Ejecute el comando introduciéndolo en la ventana de comandos de MATLAB. Los navegadores web no admiten comandos de MATLAB.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)