パラメーター オブジェクトの使用

MATLAB^® の数値変数の代わりにパラメーター オブジェクトを使用してブロック パラメーターの値を指定できます。たとえば、Gain ブロックの [ゲイン] パラメーターを指定するために myParam という名前の Simulink.Parameter オブジェクトを作成して使用するには次のようにします。

シミュレーション中に、[ゲイン] パラメーターの値として 15.23 が使用されるようになります。

Simulink.LookupTable および Simulink.Breakpoint オブジェクトを使用したルックアップ テーブル データの共有の詳細については、ルックアップ テーブルの共有ブレークポイントとテーブル データのパッケージ化を参照してください。

信号オブジェクトの使用

信号線またはブロックの状態 (Unit Delay ブロックの状態など) を信号オブジェクトに関連付けることができます。

信号の場合.  信号オブジェクトを使用してモデル内の信号の特性を制御するには、ワークスペース内で信号と同じ名前を使用してオブジェクトを作成します。

プログラムで信号を設定するには、以下を実行します。

% Create the signal object.
mySig = Simulink.Signal;
mySig.DataType = 'boolean';

% Get a handle to the block port that creates the
% target signal.
portHandles = get_param('myModel/myBlock','portHandles');
outportHandle = portHandles.Outport;

% Specify the programmatic port parameter 'Name'.
set_param(outportHandle,'Name','mySig')

% Set the port parameter 'MustResolveToSignalObject'.
set_param(outportHandle,'MustResolveToSignalObject','on')

ルートレベルの Outport ブロックをプログラムによって設定するには、多少異なる手法を使用しなければなりません。

% Create the signal object.
mySig = Simulink.Signal;
mySig.DataType = 'boolean';

% Specify the programmatic block parameter 'SignalName'.
set_param('myModel/myOutport','SignalName','mySig')

% Set the block parameter 'MustResolveToSignalObject'.
set_param('myModel/myOutport','MustResolveToSignalObject','on')

状態の場合.  信号オブジェクトを使用して Discrete-Time Integrator ブロックなどのブロックの状態の特性を制御できます。

プログラムで状態を設定するには、以下を実行します。

% Create the signal object.
myState = Simulink.Signal;
myState.DataType = 'int16';

% Set the state name in the block.
set_param('myModel/myBlock','StateName','myState')

% Set the port parameter 'StateMustResolveToSignalObject'.
set_param('myModel/myBlock','StateMustResolveToSignalObject','on')

モデル エクスプローラーを使用したオブジェクトのプロパティの変更

モデル エクスプローラーを使ってオブジェクトのプロパティを変更するには、オブジェクトを含むワークスペースをモデル エクスプローラーの [モデルの階層] ペインで選択します。その後、オブジェクトをモデル エクスプローラーの [コンテンツ] ペインで選択します。

モデル エクスプローラーは、オブジェクトのプロパティ ダイアログ ボックスを (ペインが可視である場合) [ダイアログ] ペインに表示します。

モデル エクスプローラーは、[コンテンツ] ペインにオブジェクトの一部またはすべてのプロパティを表示するように構成できます (モデル エクスプローラーを参照)。プロパティを編集するには、[コンテンツ] または [ダイアログ] ペインで値をクリックします。値は、値の変更が可能なコントロールで置き換えられます。

MATLAB コマンドを使用したオブジェクトのプロパティの変更

MATLAB コマンドを使用しても、データ オブジェクトのプロパティを取得および設定できます。MATLAB コマンドおよびプログラムで以下のドット表記を使用して、データ オブジェクトのプロパティを取得および設定します。

value = obj.property;
obj.property = value;

ここで、obj は、オブジェクトが値クラスのインスタンスである場合はそのオブジェクトを、オブジェクトがハンドル クラスのインスタンスである場合はオブジェクトのハンドルを参照する変数で (ハンドルと値のクラスを参照)、PROPERTY はプロパティ名、VALUE はプロパティ値です。たとえば、以下の MATLAB コードは、データ型が alias のオブジェクト (すなわち、Simulink.AliasType のインスタンス) を作成し、その基本データ型を uint8 に設定します。

gain = Simulink.AliasType;
gain.BaseType = 'uint8';

ドット表記を回帰的に使用して、次のように、他のオブジェクトのプロパティの値であるオブジェクトのプロパティを取得または設定することができます。

gain.CoderInfo.StorageClass = 'ExportedGlobal';

データ オブジェクトの作成

Simulink.LookupTable オブジェクトと Simulink.Breakpoint オブジェクトを作成するには、モデル エクスプローラー ツール バーの ボタンを使用します。

プログラムによるデータ オブジェクトの作成

% Create a Simulink.Parameter object named myParam whose value is 15.23.
myParam = Simulink.Parameter(15.23);

% Create a Simulink.Signal object named mySig.
mySig = Simulink.Signal;

数値変数のパラメーター オブジェクトへの変換

次のようにして、数値変数を Simulink.Parameter オブジェクトに変換できます。

/* Define numeric variable in base workspace
myVar = 5; 
/* Create data object and assign variable value
myObject = Simulink.Parameter(myVar); 

他のパッケージからのデータ オブジェクトの作成

myPackage という名前のデータ クラス パッケージを定義するとします。このパッケージからデータ オブジェクトを作成する前に、パッケージ フォルダーを格納するフォルダーを MATLAB パスに含めなければなりません。

プログラムによる他のパッケージからのデータ オブジェクトの作成

myPackage という名前のデータ クラス パッケージを定義するとします。このパッケージからデータ オブジェクトを作成する前に、パッケージ フォルダーを格納するフォルダーを MATLAB パスに含めなければなりません。

% Create a myPackage.Parameter object named 
% myParam whose value is 15.23.
myParam = myPackage.Parameter(15.23);

% Create a myPackage.Signal object named mySig.
mySig = myPackage.Signal;

ブロックのダイアログ ボックスからのパラメーター オブジェクトの作成

[信号プロパティ] ダイアログ ボックスでの信号オブジェクトの作成

データ オブジェクト ウィザードのトラブルシューティング

動的メソッド

動的メソッドとは、その特性がその名前と最初の引数として明示的または暗示的に指定されているオブジェクトのクラスに依存するメソッドです。関数またはドット表記のいずれかを使用すると、このオブジェクトを指定できます。このオブジェクトは、メソッドを定義するクラスのインスタンス、またはメソッドを定義するクラスのサブクラスのインスタンスである必要があります。たとえば、クラス A が、A のインスタンスに名前を割り当てる setName と呼ばれるメソッドを定義すると仮定します。さらに、MATLAB ワークスペースが変数 obj に割り当てられた A のインスタンスを含む場合、次のステートメントのいずれかを使って名前 'foo' を obj に割り当てることができます。

obj.setName('foo');
setName(obj, 'foo');

クラスは、メソッドのスーパー クラスを使用して定義されるメソッドとして、同じ名前が付けられている一連のメソッドを定義する場合があります。この場合、サブクラスによって定義されるメソッドは、親クラスによって定義されるメソッドの動作をオーバーライドします。Simulink では、最初の引数または暗黙的な引数としてユーザーが指定するオブジェクトのクラスから、実行時にどのメソッドを呼び出すかを判断します。このため、動的メソッドと呼ばれます。

静的メソッド

静的メソッドとは、その特性が名前のみに依存するメソッド、つまり、実行時に変化しないメソッドです。静的メソッドを呼び出すには、そのメソッドを定義するクラスの名前およびその名前の後ろに付けられたメソッド自体の名前を含む完全修飾名を使用します。たとえば、Simulink.ModelAdvisor クラスは、getModelAdvisor という名前が付けられた静的メソッドを定義します。この静的メソッドの完全修飾名は、Simulink.ModelAdvisor.getModelAdvisor です。以下の例に、静的メソッドの呼び出しを示します。

ma = Simulink.ModelAdvisor.getModelAdvisor('vdp');

コンストラクター

各データ クラスは、そのクラスのインスタンスを作成するためのメソッドを定義します。メソッド名は、クラス名と同じです。たとえば、Simulink.Parameter クラスのコンストラクター名は、Simulink.Parameter です。Simulink データ クラスで定義されるコンストラクターは、引数をもちません。

コンストラクターによって出力される値は、コンストラクターのクラスがハンドルのクラスか値のクラスかによって異なります。ハンドルのクラスに対するコンストラクターは、インスタンスのクラスがハンドルのクラスである場合はそれが作成するインスタンスのハンドルを出力します。そうでない場合は、インスタンス自体を出力します(ハンドルと値のクラスを参照)。

value クラスについて

value クラスのコンストラクター (コンストラクターを参照) は、クラスのインスタンスを出力し、インスタンスは最初に割り当てられた MATLAB 変数に永久に関連付けられます。変数を再割り当てしたり、関数に渡したりすると、MATLAB によってオリジナルのオブジェクトのコピーが作成され、割り当てられたり、渡されたりします。

たとえば、Simulink.NumericType は値クラスです。次のステートメント

x = Simulink.NumericType;
y = x;

を実行すると、1 つは変数 x に、もう 1 つは y に割り当てられた 2 つのクラス Simulink.NumericType のインスタンスをワークスペースに作成します。

handle クラスについて

handle クラスのコンストラクターは、ハンドル オブジェクトを返します。ハンドルは、複数の変数に割り当てたり、オリジナル オブジェクトのコピーを作成することなく関数に渡すことができます。たとえば、Simulink.Parameter クラスは handle クラスです。次のコマンド

x = Simulink.Parameter;
y = x;

を実行すると、MATLAB ワークスペース内に Simulink.Parameter クラスのインスタンスが 1 つだけ作成されます。変数 xと y は、両方ともそのハンドルによってインスタンスを参照します。

プログラムは、参照する変数を修正することによってハンドル クラスのインスタンスを変更することができます。前記の例を続けます。

x.Description = 'input gain';
y.Description

ans =
input gain

ほとんどの Simulink データ オブジェクト クラスは、value クラスです。例外には Simulink.Signal クラスや Simulink.Parameter クラスがあります。

変数の値がオブジェクト (値クラス) であるかオブジェクトのハンドルであるかを確認するには、オブジェクトがハンドルかどうかの判定を参照してください。

ハンドル オブジェクトのコピー

ハンドル オブジェクトのコピー方法でそのオブジェクトのインスタンスのコピーを作成します。たとえば、ConfigSet は、モデル コンフィギュレーション セットを表すハンドル オブジェクトです。次のコードは、現在のモデルのアクティブなコンフィギュレーション セットのコピーを作成し、それをモデル開発を対象とした別のコンフィギュレーションとしてその現在のモデルに付加しています。

activeConfig = getActiveConfigSet(gcs);
develConfig = copy(activeConfig);
develConfig.Name = 'develConfig';
attachConfigSet(gcs, develConfig);