プログラムによる MATLAB Function ブロックの設定

MATLAB Function ブロックのプロパティは、プログラムを使用して調整および検査できます。プログラムを使用して MATLAB^® Function レポートの内容にアクセスすることもできます。

MATLAB Function オブジェクトの呼び出し

モデルに MATLAB Function ブロックを追加した後、次のオブジェクトを使用してブロックを設定できます。

MATLABFunctionConfiguration オブジェクトを使用して、ブロックのプロパティについてクエリおよび変更を行います。ブロックパスを使用するか、関数 gcb を呼び出して、ブロックを特定します。
Stateflow.EMChart オブジェクトを使用して、ブロックの入力、出力、およびプロパティにアクセスします。Stateflow^® API オブジェクトの階層を移動して、ブロックを特定します。

プログラムによるブロックプロパティの設定

Simulink での MATLAB Function ブロックを使用した MATLAB 関数の実装のモデル call_stats_block2 について考えます。関数 get_param を呼び出して、このモデル内の MATLAB Function ブロックに対する MATLABFunctionConfiguration オブジェクトにアクセスできます。

config = get_param("call_stats_block2/MATLAB Function", ...
    "MATLABFunctionConfiguration");

プロパティのクエリまたは変更を実行するには、オブジェクト名を指定してドット表記を使用します。

config.UpdateMethod

ans =

  'Inherited'

config.Description = "Calculate the mean and standard deviation for a vector of values.";

ブロックの入力、出力、およびプロパティへのアクセス

MATLAB Function ブロックの入力、出力、およびプロパティを変更するには、現在のシステムの Simulink.BlockDiagram オブジェクトで関数 find (Stateflow) を呼び出して、その Stateflow.EMChart オブジェクトにアクセスします。

bd = get_param(gcs,"Object");
block = find(bd,"-isa","Stateflow.EMChart", ...
    Path="call_stats_block2/MATLAB Function");

プロパティのクエリまたは変更を実行するには、オブジェクト名を指定してドット表記を使用します。

block.ChartUpdate

ans =

  'INHERITED'

block.Description = "Calculate the mean and standard deviation for a vector of values.";

Stateflow.EMChart オブジェクトによって、MATLABFunctionConfiguration オブジェクト内では使用できない追加のプロパティにアクセスできるようになります。たとえば、ブロックの入力および出力の table を作成するには、次を入力します。

info = get([block.Inputs;block.Outputs],{"Name","Scope","Port"});
T = table(info(:,2),cell2mat(info(:,3)), ...
    VariableNames = ["Scope","Port"], ...
    RowNames = info(:,1));
T.Scope = categorical(T.Scope)

T =

  3×2 table

             Scope     Port
             ______    ____

    vals     Input      1  
    mean     Output     1  
    stdev    Output     2

プログラムからの MATLAB Function レポートへのアクセス

MATLAB Function レポートにアクセスするには、次の関数を MATLABFunctionConfiguration オブジェクトで呼び出します。

openReport は、ブロックの MATLAB Function レポートを開きます。
closeReport は、ブロックの MATLAB Function レポートを閉じます。
getReport は、ブロックの MATLABFunctionReport オブジェクトを返します。このオブジェクトからレポート情報をクエリするには、その Functions プロパティにアクセスします。このプロパティは coder.Function オブジェクトの配列です。coder.Function のプロパティ (MATLAB Coder)を参照してください。

たとえば、call_stats_block2 モデルの MATLAB Function ブロック内の関数と変数をリストするカスタムレポートを作成するには、次の手順に従います。

MATLAB Function ブロックの MATLABFunctionConfiguration オブジェクトにアクセスします。
```
config = get_param("call_stats_block2/MATLAB Function", ...
    "MATLABFunctionConfiguration");
```
MATLAB Function ブロックの MATLABFunctionReport オブジェクトを作成します。
```
report = getReport(config);
```
レポート内の coder.Function オブジェクトにアクセスします。
```
functions = report.Functions;
```

カスタムレポートを作成します。

for i = 1:numel(functions)
    fprintf("Function %s uses these variables:\n",functions(i).Name)
    variables = functions(i).Variables;
    for j = 1:numel(variables)
        fprintf("%d. %s -- %s\n",j,variables(j).Name,variables(j).Scope)
    end
    fprintf("\n")
end

Function stats uses these variables:
1. mean -- Output
2. stdev -- Output
3. vals -- Input
4. len -- Local

Function avg uses these variables:
1. mean -- Output
2. array -- Input
3. size -- Input

メモ

MATLABFunctionReport オブジェクトにはエラーおよび警告に関する情報は含まれていません。MATLAB Function ブロックのエラーおよび警告を確認するには、レポートを開くか、MATLAB Function ブロックエディターでデバッガーを使用します。詳細については、MATLAB Function ブロックのデバッグを参照してください。

参考

get_param | set_param