コード生成とビルドプロセス(Real-Time Workshop User's Guide)

Real-Time Workshop User's Guide

チューニング可能な式

Real-time Workshopは、式の内部でのチューニング可能な変数の利用をサポートします。1つまたは複数のチューニング可能なパラメータを含む式は、チューニング可能な式と呼ばれます。

現在では、式の内部でのチューニング可能な変数の利用には制限があります。以下で、サポートされていないと記述されている式がコード生成中にある場合、ワーニングが表示されチューニング不可能な式がコード内に生成されます。チューニング可能な式の制限は、以下の通りです。

演算子または関数の中には、チューニング可能なオペランドを含む式での利用を制限されているものがあります。制限は、表3-4に分類されている4つのカテゴリの演算子または関数に適用されます。

**表 3-4: 演算子と関数の分類**
カテゴリ	演算子または関数
1	`+ - .* ./ < > <= >= == ~= & \|`
2	`* /`
3	`abs, acos, asin, atan, atan2, boolean, ceil, cos, cosh, exp, floor, int8, int16, int32, log, log10, rem, sign, sin, sinh, sqrt, tan, tanh, uint8, uint16, uint32`
4	`: .^ ^ [] {} . \ .\ ' .' ; ,`

各カテゴリに適用される規則は、以下の通りです。

カテゴリ2の演算子は、少なくとも1つのオペランドがスカラであるときチューニング可能な式で利用できます。つまり、スカラ/スカラ同士/行列のオペランドの組合せはサポートされますが、行列同士はサポートされません。

カテゴリ3は、チューニング可能な引数をサポートするすべての関数の一覧です。これらの関数に渡されるチューニング可能な引数は、チューニング可能のままです。その他の関数に渡されるチューニング可能な引数は、チューニング不可能になります。

注意 "ドット" (構造体のメンバ)演算子は、サポートされません。これは、構造体のメンバを含む式はチューニング不可能であることを意味します。

マスクされたサブシステムのチューニング可能な式

チューニング可能な式は、マスクされたサブシステムで利用できます。マスクされたサブシステムダイアログで、チューニング可能なパラメータ名またはチューニング可能な式を利用できます。低レベルのサブシステムで参照されるときには、パラメータはチューニング可能のままです。

例題として、下記に示したマスクされたサブシステムを考えます。マスクされたダイアログ変数k は、theGainのゲインパラメータを設定します。

ベースワークスペース変数bは、SimulinkGlobal(Auto)ストレージクラスで、チューニング可能と宣言されていると仮定します。図 3-11は、サブシステムのマスクダイアログ内のチューニング可能な式b*3を示します。

図 3-11: Subsystem Maskダイアログのチューニング可能な式

Real-Time Workshopは、theGainに対して以下の出力を生成します。

/* Gain Block: <S1>/theGain */
  rtb_temp0 *= (rtP.b * 3.0);

bは、グローバルパラメータ構造体rtPのメンバとして表わされます。

マスクされたサブシステムでのチューニング可能な式の制限 マスク初期化コードで宣言された、あるいは変更された変数を含む式は、チューニング不可能です。

例題として、上記のサブシステムを以下のように変更します。

t = 3 * k;

マスク初期化コードは、1回だけ実行できるので、k はコード生成時につぎのように評価されます。

4 + (3 * (2 * 3) )

Real-Time Workshopは、結果をインライン化します。そのため、 bがチューニング可能と宣言されたにもかかわらず、コードジェネレータは、theGainに対してつぎのように出力を生成します。

/* Gain Block: <S1>/theGain */
  rtb_temp0 *= (22.0);

Model Parameter Configurationダイアログの使用法信号: ストレージ、最適化、インタフェース