System object を使用した System ブロック ダイアログ ボックスのカスタマイズ

対応する System object™ にプロパティやメソッドを追加して、MATLAB System ブロックのダイアログ ボックスをカスタマイズできます。タブを追加し、プロパティをグループやセクションにまとめ、ブロックの説明を追加し、シミュレーション タイプを制御し、カスタム ボタンを追加できます。

メモ

R2022b 以降では、マスク エディターを使用して MATLAB System ダイアログ ボックスを設計できます。既存のダイアログ ボックスのカスタマイズをマスク エディターに移行することもできます。この機能を使用すると、System object ファイルで getPropertyGroupsImpl メソッドを開発または維持する必要がなくなります。詳細については、Customize System Object Dialog Box Using Mask Editorを参照してください。

ブロック ダイアログ タブ、セクション、およびプロパティの順序の定義

この例では、プロパティの表示名を指定して getPropertyGroupImpl メソッドを変更し、MultipleGroupsWithTabs MATLAB System ブロックのブロック ダイアログ ボックスをカスタマイズします。

プロパティ ラベルの変更

ダイアログ ボックスに表示されるプロパティ ラベルを変更するには、コメントとプロパティ名の間にスペースを入れずに、この形式 %PropertyName Block Dialog Label で各プロパティの前にコメントを追加します。たとえば、StartValue プロパティを [Start Value] として表示するには、次のように指定します。

%StartValue Start Value
StartValue = 0

この例の MultipleGroupsWithTabs System object は MATLAB System ブロック ダイアログに表示するために各プロパティにラベルを付け直します。

ダイアログ ボックスの整理

MutlitpleGroupsWithTabs System object クラスは getPropertyGroupsImpl メソッドを定義します。getPropertyGroupsImpl メソッド内で、この例は 2 つのタブ (セクション グループ) および 3 つのパラメーター グループ (セクション) を定義します。

classdef MultipleGroupsWithTabs < matlab.System
    % MultipleGroupsWithTabs Customize block dialog with multiple tabs and parameter groups.
    
    % Public, tunable properties
    properties
        %StartValue Start Value
        StartValue = 0
        
        %EndValue End Value
        EndValue = 10
        
        Threshold = 1
        
        %BlockLimit Limit
        BlockLimit = 55
    end
    % Public Nontunable 
    properties(Nontunable)
        %IC1 First initial condition
        IC1 = 0
        
        %IC2 Second initial condition
        IC2 = 10
        
        %IC3 Third initial condition
        IC3 = 100

        %UseThreshold Use threshold
        UseThreshold (1,1) logical = true
    end
    
    methods (Static, Access = protected)
        function groups = getPropertyGroupsImpl
            % Section to always display above any tabs.
            alwaysSection = matlab.system.display.Section(...
                'Title','','PropertyList',{'BlockLimit'});
           
            % Group with no sections
            initTab = matlab.system.display.SectionGroup(...
                'Title','Initial conditions', ...
                'PropertyList',{'IC1','IC2','IC3'});
            
            % Section for the value parameters
            valueSection = matlab.system.display.Section(...
                'Title','Value parameters',...
                'PropertyList',{'StartValue','EndValue'});
            
            % Section for the threshold parameters
            thresholdSection = matlab.system.display.Section(...
                'Title','Threshold parameters',...
                'PropertyList',{'Threshold','UseThreshold'});
            
            % Group with two sections: the valueSection and thresholdSection sections
            mainTab = matlab.system.display.SectionGroup(...
                'Title','Main', ...
                'Sections',[valueSection,thresholdSection]);
            
            % Return an array with the group-less section, the group with
            % two sections, and the group with no sections.
            groups = [alwaysSection,mainTab,initTab];
        end
    end
end

結果のダイアログ ボックス

load_system('ShowSystemBlockDialog')
open_system('ShowSystemBlockDialog/MATLAB System')

プロパティ セクションの定義

この例では、プロパティの表示名を指定して getPropertyGroupImpl メソッドを変更し、MATLAB System ブロックのブロック ダイアログ ボックスをカスタマイズします。このカスタマイズは System object AddPropertySections で例示されます。

プロパティ ラベルの変更

ダイアログ ボックスに表示されるプロパティ ラベルを変更するには、パーセント記号とプロパティ名の間にスペースを入れずに、この形式 %PropertyName Block Dialog Label で各プロパティの前にコメントを追加します。たとえば、UseAlpha プロパティを [Use alpha] として表示するには、次のように指定します。

%UseAlpha Use alpha
UseAlpha = 0

この例に含まれる AddPropertySections System object は MATLAB System ブロック ダイアログに表示するために各プロパティにラベルを付け直します。

ダイアログ ボックスの整理

ダイアログ ボックスでプロパティを整理するために、AddPropertySections System object クラスは getPropertyGroupsImpl メソッドを定義します。getPropertyGroupsImpl メソッド内で、この例はそれぞれ 2 つのプロパティをもつ 2 つのセクションを定義します。

classdef AddPropertySections < matlab.System
    % AddPropertySections Customized dialog with two parameter sections
    
    % Public, tunable properties
    properties
        
        %NumberOfShapes Number of shapes
        NumberOfShapes = 10
        
        Alpha = 0.75
    end
 
    % Public, nontunable properties
    properties(Nontunable)
        Coloring (1, 1) {mustBeMember(Coloring,["red","blue","green"])} = "red"

        %UseAlpha Use alpha
        UseAlpha (1,1) logical = false
    end
    
    methods (Static, Access = protected)
        function groups = getPropertyGroupsImpl           
            % Section for the value parameters
            valueSection = matlab.system.display.Section(...
                'Title','Shape parameters',...
                'PropertyList',{'NumberOfShapes','Coloring'});
            
            % Section for the threshold parameters
            shadingSection = matlab.system.display.Section(...
                'Title','Shading parameters',...
                'PropertyList',{'UseAlpha','Alpha'});
            
            % Return an array with the two sections.
            groups = [valueSection, shadingSection];
        end
    end
end

結果のダイアログ ボックス

load_system('CustomSystemBlockDialog')
open_system('CustomSystemBlockDialog/MATLAB System')

ヘッダーの説明の追加

System object に getHeaderImpl メソッドを追加して、MATLAB System ブロックにヘッダー パネルを追加します。

getHeaderImpl を使用して MyCounter System object のパネルのタイトルとテキストを指定します。getHeaderImpl を指定しない場合、ブロックにはパネルのタイトルまたはテキストは表示されません。

すべての Impl メソッドと同様に、getHeaderImpl メソッドのアクセスを protected に設定します。このメソッドは内部でのみ呼び出されるからです。

methods (Static, Access = protected)
   function header = getHeaderImpl
      header = matlab.system.display.Header('MyCounter',...
        'Title','My Enhanced Counter');
   end
end

 完全なクラス定義

 classdef MyCounter < matlab.System
  
   % MyCounter Count values
     
    properties
       Threshold = 1
    end
    properties (DiscreteState)
       Count
    end
 
    methods (Static, Access = protected)
      function header = getHeaderImpl
         header = matlab.system.display.Header('MyCounter',...
           'Title','My Enhanced Counter',...
           'Text', 'This counter is an enhanced version.');
      end
    end

    methods (Access = protected)
       function setupImpl(obj,u)
          obj.Count = 0;
       end
       function y = stepImpl(obj,u)
          if (u > obj.Threshold)
             obj.Count = obj.Count + 1;
          end
          y = obj.Count;
       end
       function resetImpl(obj)
          obj.Count = 0;
       end
    end
end

MATLAB System ブロックでのシミュレーション タイプの制御

シミュレーション タイプと、[シミュレーション実行方法] パラメーターが Simulink^® MATLAB System ブロックのダイアログ ボックスに表示されるかどうかを指定します。このシミュレーション オプションは 'Code generation' と 'Interpreted mode' です。

クラス定義ファイルに getSimulateUsingImpl メソッドを含めない場合、System object では両方のシミュレーション モードが許可され、既定値は 'Code generation' になります。showSimulateUsingImpl メソッドを含めなかった場合、ブロックのダイアログ ボックスに [シミュレーション実行方法] パラメーターが表示されます。

getSimulateUsingImpl メソッドと showSimulateUsingImpl メソッドは static に設定しなければならず、これらのメソッドのアクセスは protected に設定しなければなりません。

getSimulateUsingImpl を使用して、System object でインタープリター型実行のみが許可されるように指定します。

methods(Static,Access = protected)
   function simMode = getSimulateUsingImpl
       simMode = 'Interpreted execution';
    end
end

 完全なクラス定義

classdef PlotRamp < matlab.System
  % Display a button to launch a plot figure.
        
  properties (Nontunable)
    RampLimit = 10;
  end
    
  methods(Static, Access=protected)
    function group = getPropertyGroupsImpl
      group = matlab.system.display.Section(mfilename('class'));
      group.Actions = matlab.system.display.Action(@(~,obj)...
            visualize(obj),'Label','Visualize');
    end

    function simMode = getSimulateUsingImpl
      simMode = 'Interpreted execution';
    end
  end
    
  methods
    function obj = ActionDemo(varargin)
      setProperties(obj,nargin,varargin{:});
    end
        
    function visualize(obj)
      figure;
      d = 1:obj.RampLimit;
      plot(d);
    end
   methods(Static,Access = protected)
   end
  end
end

[シミュレーション実行方法] パラメーターを含む、結果のダイアログ ボックスを以下に示します。

MATLAB System ブロックへのカスタム ボタンの追加

MATLAB System ブロックのダイアログ ボックスにボタンを追加します。このボタンをクリックすると、ランプ関数をプロットする Figure が開きます。

matlab.system.display.Action を使用して、MATLAB System ブロック ダイアログ ボックスのボタンに関連付ける MATLAB^® 関数またはコードを定義します。また、この例では、ボタンのオプションを設定する方法と、actionData オブジェクト入力を使用して Figure のハンドルを格納する方法についても説明します。今回のコード例では、ボタンが複数回クリックされるときに、クリックのたびに新しい Figure を開くのではなく、同じ Figure を使用します。

methods(Static,Access = protected)
  function group = getPropertyGroupsImpl
    group = matlab.system.display.Section(mfilename('class'));
    group.Actions = matlab.system.display.Action(@(actionData,obj)...
       visualize(obj,actionData),'Label','Visualize');
  end
end
    
methods
  function obj = ActionDemo(varargin)
    setProperties(obj,nargin,varargin{:});
  end
        
  function visualize(obj,actionData)
    f = actionData.UserData;
    if isempty(f) || ~ishandle(f)
      f = figure;
      actionData.UserData = f;
    else
      figure(f); % Make figure current
    end
        
    d = 1:obj.RampLimit;
    plot(d);
  end
end

 ダイアログ ボタンのクラス定義ファイルの作成

クラス定義ファイル内でプロパティ グループと 2 番目のタブを定義します。

classdef PlotRamp < matlab.System
  % Display a button to launch a plot figure.
        
  properties (Nontunable)
    RampLimit = 10;
  end
    
  methods(Static,Access = protected)
    function group = getPropertyGroupsImpl
      group = matlab.system.display.Section(mfilename('class'));
      group.Actions = matlab.system.display.Action(@(actionData,obj)...
        visualize(obj,actionData),'Label','Visualize');
    end
  end
    
  methods
    function obj = ActionDemo(varargin)
      setProperties(obj,nargin,varargin{:});
    end
        
    function visualize(obj,actionData)
      f = actionData.UserData;
      if isempty(f) || ~ishandle(f)
        f = figure;
        actionData.UserData = f;
      else
        figure(f); % Make figure current
      end
        
      d = 1:obj.RampLimit;
      plot(d);
    end
  end
end

[可視化] ボタンを含む、結果のダイアログ ボックスを以下に示します。

参考

getPropertyGroupsImpl | matlab.system.display.Section | matlab.system.display.SectionGroup | getSimulateUsingImpl | showSimulateUsingImpl | getHeaderImpl | matlab.system.display.Header

関連するトピック

• メソッド定義での入力定義としての ~ の使用

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい