生成コードでの多次元配列の次元の保持

ライブスクリプトを開く

既定では、多次元のモデルデータについて、生成コードには 1 次元配列が含まれます。[コンフィギュレーションパラメーター] ダイアログボックスで [配列のレイアウト] パラメーターが Row-major に設定されている場合に、生成コードで多次元配列の次元を保持できます。生成されたコードで配列の次元を保持すると、外部コードとの統合が強化されます。

MATLAB® と C では、多次元データの編成方法が異なります (多次元配列の次元保持を参照)。生成コードで、ルートレベルの入力端子と出力端子、パラメーター、信号、状態、ルックアップテーブル、およびデータストアの次元を保持できます。

次元を保持するための既定のモデルデータ要素の構成

[コードマッピング]、[データの既定の設定] タブで、次のモデルデータ要素カテゴリを構成できます。次元を保持するには、ストレージクラスを指定します。

入力端子
出力端子
Signals, states, and internal data
Shared local data stores
Global data stores
モデルパラメーター
External parameters

その後、個々のモデルデータ要素で [ストレージクラス] を Auto または Model default に設定すると、既定で、[データの既定の設定] タブでそれぞれのモデルデータ要素に対して設定した構成がコードジェネレーターによって適用されます。

この例では、上記のモデルデータ要素カテゴリの配列の次元を保持する方法を示します。

モデル例 PreserveArrayDims を開きます。

model = "PreserveArrayDims";
open_system(model);

[コンフィギュレーションパラメーター] ダイアログボックスで、パラメーター [配列のレイアウト] が Row-major に設定されていることを確認します。

set_param("PreserveArrayDims", "ArrayLayout", "Row-major");

Embedded Coder アプリを開きます。[C コード] タブで、コードマッピングエディターを開きます。[コードインターフェイス]、[既定のコードマッピング] を選択します。このオプションにより、コードマッピングエディターが開いた状態でピン留めされます。

[データの既定の設定] タブで、[入力端子] カテゴリを選択します。指定されている [ストレージクラス] は ExportToFile です。編集アイコンをクリックし、[PreserveDimensions] プロパティを選択します。

[PreserveDimensions] プロパティをプログラムで構成するには、MATLAB コマンドウィンドウで coder.mapping.defaults.set 関数を使用します。

cm = coder.mapping.api.get("PreserveArrayDims");
setDataDefault(cm, "Inports", "PreserveDimensions", "1")

Embedded Coder® で新しいストレージクラスを作成し、そのクラスを指定して次元を保持できます。詳細については、新しいストレージクラスの次元の保持を参照してください。

サポートされているストレージクラスのリストについては、次元を保持するためにサポートされているストレージクラスを参照してください。

コードの生成とレビュー

evalc("slbuild('PreserveArrayDims')");

生成されたコードは、ルートレベルの入力端子の次元を保持します。

file = fullfile("PreserveArrayDims_ert_rtw",...
    "PreserveArrayDims.c");
coder.example.extractLines(file,"real_T rtActuator", ...
    "real_T rtTemperature",0,1);

real_T rtPressure[2][3];               /* '<Root>/Pressure' */
real_T rtTargetVolume[2][3];           /* '<Root>/TargetVolume' */
real_T rtTemperature[2][3];            /* '<Root>/Temperature' */

次元を保持するための個々のモデルデータ要素の構成

[入力端子]、[出力端子]、[パラメーター]、[データストア]、および [信号/状態] などの他のタブで個々のモデルデータ要素のソースを構成することで、[データの既定の設定] タブで指定された既定の構成をオーバーライドできます。以下に、モデルデータ要素カテゴリに適用可能なワークフローの例を示します。

コードマッピングエディターへの信号の追加

[C コード] タブから、[コードインターフェイス]、[個々の要素コードのマッピング] を開きます。
コードマッピングエディターで [信号/状態] タブを選択します。[信号] セクションは現在空です。特定のモデルには、複数の信号が存在する場合があります。コード生成を構成する際、これらの信号の一部は重要ではない場合があります。コード生成の構成に関連する対象の信号として、信号をマークできます。信号を明示的に追加すると、その信号はコードマッピングエディターに追加されます。
コードマッピングエディターで、[信号/状態] タブを開きます。Simulink® エディターで、コードマッピングエディターに追加する信号を選択します。この例では、サブシステム Volume Controller から Outport Actuator Command に向かう信号を選択します。信号線の上または下に表示されている省略記号 (...) にカーソルを合わせて、アクションバーを開きます。[選択した信号をコードマッピングに追加] ボタンをクリックします。その信号が、コードマッピングエディターの [信号] テーブルに追加されます。

cm = coder.mapping.api.get("PreserveArrayDims");
vol_ports = get_param("PreserveArrayDims/Volume Controller","PortHandles");
vol_outPort = vol_ports.Outport(1);
addSignal(cm,vol_outPort);

信号インターフェイスの構成とコードの生成

[データの既定の設定] タブの構成に従い、信号の既定のストレージクラスは Localizable です。信号の既定の構成でも、多次元配列の次元を保持するように指定されています。既定では、個別に追加された信号の [ストレージクラス] は Auto として構成されています。[信号/状態] タブで追加された信号の仕様を変更することで、個々の信号の既定の構成をオーバーライドできます。既定の設定を適用する場合は、[信号/状態] タブで [ストレージクラス] を Model default: Localizable に設定します。選択した信号に対して、同じストレージクラス Localizable を保持するが、次元は保持しないようにする場合、[ストレージクラス] に Localizable を指定し、[PreserveDimensions] プロパティをクリアします。

[ストレージクラス] に Model default を指定した場合、[データの既定の設定] タブで指定された既定の構成をオーバーライドすることはできません。既定のストレージクラスの既定の仕様をオーバーライドするには、そのストレージクラスを選択し、個々のモデリング要素の構成を変更します。

この例では、[ストレージクラス] を Localizable に設定します。編集アイコンをクリックし、[識別子] プロパティに VolumeController などの信号名を指定します。[PreserveDimensions] プロパティがクリアされていることを確認します。

setSignal(cm,vol_outPort, "StorageClass", "Localizable", "Identifier", "VolumeController", ...
    "PreserveDimensions", 0);

コードを生成してレビューします。

evalc("slbuild('PreserveArrayDims')");

生成されたコードでは、その個別の信号の次元は保持されませんが、他の信号の次元は保持されます。

file = fullfile("PreserveArrayDims_ert_rtw",...
    "PreserveArrayDims.c");
coder.example.extractLines(file,"/* Definition for custom storage class: Localizable */", ...
    "static real_T rtVolumedifference",0,1);

static real_T LogSignal[11][9];        /* '<S2>/Log volume difference' */
real_T VolumeController[6];            /* '<S3>/Gain' */
static real_T rtIterationCount[2][3];  /* '<S2>/PreviousVolumeErrorAverage' */
static real_T rtIterationCount_g[2][3];/* '<S2>/IterationCount' */
static real_T rtVolumedifference[2][3];/* '<S1>/Volume difference' */

次元を保持するためにサポートされているストレージクラス

次のストレージクラスに対して、生成されたコードで次元を保持できます。

Const
Volatile
ConstVolatile
ExportToFile
ImportFromFile
FileScope
Localizable
GetSet

新しいストレージクラスの次元の保持

独自のストレージクラスを設計する際に次元を保持するには、Embedded Coder ディクショナリのプロパティインスペクターで [ストレージタイプ] を Unstructured に設定し、[配列の次元を保持] プロパティを選択します。このプロパティを選択すると、ストレージクラスのインスタンスの次元が保持されます。そのストレージクラスを使用するには、コードマッピングエディターで、[ストレージクラス] に作成した新しいストレージクラスを指定して、モデル要素カテゴリを構成します。

カスタムストレージクラスデザイナーで独自のストレージクラスを設計する際に次元を保持するには、[タイプ] に Unstructured を指定し、[配列の次元を保持] プロパティを選択します。[配列の次元を保持] には、以下のオプションがあります。

No (既定の設定) — 生成されたコードで、多次元配列を 1 次元にフラット化します。
Yes — 指定したストレージクラスのパラメーターの配列の次元を保持します。
Instance Specific — ストレージクラスの各インスタンスの配列の次元を保持する場合は、パラメーターオブジェクトに対して [配列の次元を保持] プロパティを有効にします。Simulink パッケージの場合、このプロパティの設定は既定で Instance Specific になっています。

制限

コードジェネレーターは、データオブジェクトのないパラメーターの次元を保持しません。
N 次元のベクトルについては、N 次元のインデックスが指定されている場合でも、コードジェネレーターは常に 1 次元配列を生成します。
コードジェネレーターは、生成されたサービスインターフェイスコードによって呼び出されるターゲット環境サービス関数からアクセスされる場合、生成された C コード内の多次元配列をフラット化します。

生成コードでの多次元配列の次元の保持

次元を保持するための既定のモデル データ要素の構成

次元を保持するための個々のモデル データ要素の構成

コード マッピング エディターへの信号の追加