複数の Interpolation Using Prelookup ブロックのマージによるコードの効率性の改善

モデルトランスフォーマーツールを使用すると、モデル化パターンをリファクタリングして、生成コードの効率性を改善できます。モデルトランスフォーマーは、Prelookup ブロックの出力から単一の Interpolation Using Prelookup ブロックに接続されている同じ入力信号を持つ複数の Interpolation Using Prelookup ブロックを特定し、マージします。

モデルトランスフォーマーは、Interpolation Using Prelookup ブロックの [テーブルデータ] 以外のプロパティが同じ場合に機能します。モデル内の Interpolation Using Prelookup ブロックの数を削減することで、コード内の変数割り当ての数が削減され、生成されたコードの効率性が向上します。モデルトランスフォーマーアプリまたはプログラムのコマンドを使用して、モデルをリファクタリングできます。

モデルトランスフォーマーは、次のような複数の Interpolation Using Prelookup を置き換えることができます。

同じインデックスおよび小数部パラメーターを持つ Prelookup ブロックに接続されている同じ入力信号がある
同じ Multiport Switch ブロックに接続された出力信号がある
同じブレークポイントの指定、値、データ型がある
同じアルゴリズムパラメーターがある
小数部パラメーターに対して同じデータ型がある

モデルトランスフォーマーアプリを使用した Interpolation Using Prelookup ブロックのマージ

スクリプトを開く

この例では、モデルトランスフォーマーを使用して冗長な Interpolation Using Prelookup ブロックを特定し、モデルをリファクタリングする方法を説明します。

モデル ex_interpolation_optimize は Prelookup ブロックを使用して信号を複数の Interpolation Using Prelookup ブロックに入力します。こうした Interpolation ブロックの出力が Multiport Switch ブロックに接続されています。

この例では、変換の条件を満たす Interpolation Using Prelookup ブロックを特定し、それらを 1 つの Interpolation Using Prelookup ブロックと、Multiport Switch ブロックに接続された Constant ブロックに置き換えます。

モデルを作業フォルダーに保存します。
[アプリ] タブで、[モデルトランスフォーマー] をクリックします。
[変換] フォルダーで、Replace Interpolation Using Prelookup Blocksチェックを選択します。
[この変換で、ライブラリ内の Interpolation-ND ブロックをスキップします。] オプションを選択して、ライブラリにリンクされている Interpolation Using Prelookup ブロックが置換されないようにします。
[変換後のモデル名の接頭辞] フィールドで、リファクタリングされたモデルの接頭辞を指定します。
[このチェックを実行] をクリックします。上部の [結果] テーブルには、Interpolation Using Prelookup ブロックと、それに対応する Multiport Switch ブロックの端子インデックスへのハイパーリンクが含まれています。
変換しないグループの [Candidate Groups] の下にあるチェックボックスをオフにします。
[モデルのリファクタリング] をクリックします。[結果] テーブルには、新しいモデルへのハイパーリンクが含まれています。テーブルには、共有 Interpolation Using Prelookup ブロックと、それに対応する Multiport Switch ブロック端子へのハイパーリンクが含まれています。ツールによって、新しい gen_ex_interpolation_optimize.slx モデルを含む m2m_ex_interpolation_optimize フォルダーも作成されます。

gen_ex_interpolation_optimize.slx モデルにある 2 つの Prelookup ブロック Prelookup および Prelookup1 が単一の Interpolation Using Prelookup ブロックに接続され、Constant ブロックは Multiport Switch ブロック端子に接続されて [テーブルデータ] を入力として提供します。

プログラムによる Interpolation Using Prelookup ブロックのマージ

モデルトランスフォーマーをプログラムによって使用するには、以下のようにします。

Simulink.ModelTransform.CommonSourceInterpolation.identifyCandidates を使用して、変換の候補を特定する
Simulink.ModelTransform.CommonSourceInterpolation.refactorModel を使用して、モデルをリファクタリングする

モデル ex_interpolation_optimize を現在の作業ディレクトリに保存します。
変換の条件を満たす候補を特定するには、関数 Simulink.ModelTransform.CommonSourceInterpolation.identifyCandidates を使用してオブジェクト transformResults を作成します。
```
transformResults = Simulink.ModelTransform.CommonSourceInterpolation.identifyCandidates('ex_interpolation_optimize')
```
```
transformResults =

  Results with properties:

    Candidates: [1×1 struct]
```
transformResults オブジェクトには 1 つのプロパティ Candidates があります。これは、InterpolationPorts と SwitchPorts の 2 つのフィールドをもつ構造体です。
```
transformResults.Candidates = 

  struct with fields:

        InterpolationPorts: [4×1 struct]
               SwitchPorts: [4×1 struct]
```
InterpolationPorts フィールドを表示します。
```
transformResults.Candidates.InterpolationPorts = 
```
```
  4×1 struct array with fields:

    Block
    Port
```
InterpolationPorts フィールドは 2 つの配列 Block と Port で構成されます。同様に、SwitchPorts には同じプロパティがあります。

Candidates.InterpolationPorts フィールドと Candidates.SwitchPorts フィールドをテーブルに変換します。

struct2table(transformResults.Candidates.InterpolationPorts)
struct2table(transformResults.Candidates.SwitchPorts)

ans =
  4×2 table
                        Block                                      Port
    _____________________________________________                  ____
    {'ex_interpolation_optimize/Interpolation↵Using Prelookup' }     0  
    {'ex_interpolation_optimize/Interpolation↵Using Prelookup1'}     0  
    {'ex_interpolation_optimize/Interpolation↵Using Prelookup2'}     0  
    {'ex_interpolation_optimize/Interpolation↵Using Prelookup3'}     0  


ans =
  4×2 table
                Block                                 Port
    ______________________________                    ____
    {'ex_interpolation_optimize/Multiport_Switch'}     1  
    {'ex_interpolation_optimize/Multiport_Switch'}     2  
    {'ex_interpolation_optimize/Multiport_Switch'}     3  
    {'ex_interpolation_optimize/Multiport_Switch'}     4

SwitchPorts を使用して、どの Interpolation Using Prelookup ブロックがどの Multiport Switch ブロック端子に接続されているか確認します。

モデルをリファクタリングするには、関数 Simulink.ModelTransform.CommonSourceInterpolation.refactorModel を使用します。この関数は、関数 identifyCandidate からの transformResults オブジェクトを使用します。
```
refactorResults = Simulink.ModelTransform.CommonSourceInterpolation.refactorModel(transformResults)
```
```
refactorResults = 

  RefactorResults with properties:

           ModelName: 'ex_interpolation_optimize'
      ModelDirectory: ''
    TraceabilityInfo: [4×1 containers.Map]
```
refactorResults オブジェクトの ModelName プロパティと ModelDirectory プロパティは参照モデルの名前と場所をリストします。TraceabilityInfo はブロックのトレース情報をリストする containers.Map オブジェクトです。

条件と制限

モデルトランスフォーマーは、次の場合は Interpolation Using Prelookup ブロックを置換できません。

Interpolation Using Prelookup ブロックがコメントアウトされた領域にあるか、非アクティブなバリアントである。
Interpolation Using Prelookup ブロックがマスクされている。
モデルトランスフォーマーアプリでは、Atomic サブシステム、参照モデル、またはライブラリにリンクされたブロックの境界を越える Interpolation Using Prelookup ブロックの置換は行われません。