このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
Simulink.BusElement
バスの要素のプロパティの指定
説明
Simulink.BusElement
オブジェクトは Simulink.Bus
オブジェクトの要素で、バス内の要素のプロパティを検証します。モデルをシミュレートまたは更新するときに、オブジェクトによって指定されたプロパティが対応するバス要素によって指定されたプロパティと一致するかどうかがチェックされます。
バス オブジェクトはデータ型として指定できますが、バス要素オブジェクトは指定できません。
Simulink.Bus
オブジェクトおよび Simulink.BusElement
オブジェクトをベース ワークスペースまたはデータ ディクショナリに作成し変更するには、型エディター、モデル エクスプローラー、または MATLAB® コマンドを使用します。Bus
オブジェクトをモデル ワークスペースに保存することはできません。
作成
Simulink.BusElement
オブジェクトは複数の方法で作成できます。
Simulink.BusElement
オブジェクトを対話的に作成するには、型エディターまたはモデル エクスプローラーを使用します。既定の
Simulink.BusElement
オブジェクトをプログラムによって作成するには、関数Simulink.BusElement
を使用します (ここで説明します)。Simulink.BusElement
オブジェクトをモデル内のブロック、MATLAB データ、および外部 C コードからプログラムによって作成するには、プログラムによる Simulink バス オブジェクトの作成を参照してください。
説明
は、既定のプロパティ値をもつバス要素オブジェクトを返します。be
= Simulink.BusElement
プロパティ
Name
— 要素の名前
'a'
(既定値) | 文字ベクトル | string スカラー
要素の名前。文字ベクトルとして指定します。
Simulink.BusElement
オブジェクトに対して信号のプロパティを検証するために、信号名は、アルファベット文字またはアンダースコア (_
) で始まり、その後に英数字またはアンダースコアが続く有効な識別子でなければなりません。
データ型: char
| string
Complexity
— 要素の数値型
'real'
(既定値) | 'complex'
要素の数値型。'real'
または 'complex'
として指定します。
依存関係
このプロパティの値は、DataType
で Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトが指定されている場合は無視されます。代わりに、Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトの Simulink.BusElement
オブジェクトで指定されている実数/複素数が使用されます。
データ型: char
| string
Dimensions
— 要素の次元
1
(既定値) | スカラー | ベクトル
要素の次元。スカラーまたはベクトルとして指定します。
生成コードでシンボリック次元を使用するには、Implement Symbolic Dimensions for Array Sizes in Generated Code (Embedded Coder)を参照してください。
依存関係
このプロパティの値は、DataType
で Simulink.ValueType
オブジェクトが指定されている場合は無視されます。代わりに、Simulink.ValueType
オブジェクトで指定されている次元が使用されます。
データ型: double
DataType
— 要素のデータ型
'double'
(既定値) | 文字ベクトル | string スカラー
要素のデータ型。文字ベクトルまたは string スカラーとして指定します。
データ属性の設定には [データ型アシスタント] が役立ちます。[データ型アシスタント] を使用するには、 をクリックします。詳細については、データ型アシスタントを利用したデータ型の指定を参照してください。
次のいずれかのオプションを指定できます。
組み込みの Simulink® データ型 — たとえば、
'single'
や'uint8'
を指定します。Simulink でサポートされているデータ型を参照してください。固定小数点データ型 — 関数
fixdt
を使用します。たとえば、'fixdt(1,16,0)'
を指定します。列挙データ型 —
Enum:
が前に付いた型名を使用します。たとえば、'Enum: myEnumType'
を指定します。バス データ型 —
Bus:
が前に付いたSimulink.Bus
オブジェクトの名前を使用します。たとえば、'Bus: myBusObject'
を指定します。値の型 —
ValueType:
が前に付いたSimulink.ValueType
オブジェクトの名前を使用します。たとえば、'ValueType: windVelocity'
を指定します。カスタムのデータ型 — 型を指定する MATLAB 式を使用します。たとえば、
DataTypeMode
プロパティが'Fixed-point: unspecified scaling'
以外の値に設定されているSimulink.NumericType
オブジェクトを指定できます。
Simulink.Bus
オブジェクトを指定すると、階層的なバス、つまり他のバスを含むバスを指定する Bus
オブジェクトを作成できます。
Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトをデータ型として指定する場合、Simulink.BusElement
オブジェクトの一部のプロパティは無視されます。たとえば、Simulink.BusElement
オブジェクトの Min
、Max
、および Unit
のプロパティは無視されます。代わりに、Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトの Simulink.BusElement
オブジェクトの対応するプロパティが使用されます。
データ型: char
| string
Min
— 要素の最小値
[]
(既定値) | スカラー
要素の最小値。スカラーとして指定します。この値は double の有限実数スカラー値でなければなりません。または、要素がバスの場合、値は空 []
でなければなりません。
依存関係
このプロパティの値は、DataType
で Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトが指定されている場合は無視されます。代わりに、Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトの Simulink.BusElement
オブジェクトで指定されている最小値が使用されます。
データ型: double
Max
— 要素の最大値
[]
(既定値) | スカラー
要素の最大値。スカラーとして指定します。この値は double の有限実数スカラー値でなければなりません。または、要素がバスの場合、値は空 []
でなければなりません。
依存関係
このプロパティの値は、DataType
で Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトが指定されている場合は無視されます。代わりに、Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトの Simulink.BusElement
オブジェクトで指定されている最大値が使用されます。
データ型: double
DimensionsMode
— 要素のサイズの処理方法を指定する
'Fixed'
(既定値) | 'Variable'
要素のサイズの処理方法を、'Fixed'
または 'Variable'
として指定します。
依存関係
このプロパティの値は、DataType
で Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトが指定されている場合は無視されます。代わりに、Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトの Simulink.BusElement
オブジェクトで指定されている次元モードが使用されます。
データ型: char
| string
Unit
— 要素を表現する物理単位
''
(既定値) | 文字ベクトル | string スカラー
要素を表現する物理単位。文字ベクトルとして指定します。
詳細については、Simulink モデルでの単位の指定を参照してください。
例: 'inches'
依存関係
このプロパティの値は、DataType
で Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトが指定されている場合は無視されます。代わりに、Simulink.ValueType
オブジェクトまたは Simulink.Bus
オブジェクトの Simulink.BusElement
オブジェクトで指定されている単位が使用されます。
データ型: char
| string
Description
— バス要素の説明
''
(既定値) | 文字ベクトル | string スカラー
バス要素の説明。文字ベクトルとして指定します。この説明を使用して、バス要素オブジェクトが適用される信号の種類など、BusElement
オブジェクトに関する情報を記述します。この情報は、Simulink 処理に影響を与えません。
データ型: char
| string
例
バス要素オブジェクトからのバス オブジェクトの作成
Simulink.BusElement
オブジェクトの配列を使用して Simulink.Bus
オブジェクトの階層を作成します。
Chirp
および Sine
という名前の 2 つの BusElement
オブジェクトを含む配列をベース ワークスペースに作成します。
elems(1) = Simulink.BusElement; elems(1).Name = 'Chirp'; elems(2) = Simulink.BusElement; elems(2).Name = 'Sine';
配列のインデックス付けにより、配列の要素を作成したり要素にアクセスしたりできます。ドット表記によって要素のプロパティ値にアクセスできます。
elems
配列で定義される要素を含む、Sinusoidal
という名前の Bus
オブジェクトを作成します。
Sinusoidal = Simulink.Bus; Sinusoidal.Elements = elems;
Bus
オブジェクトの階層を作成するため、Sinusoidal
という名前の Bus
を参照する別の Bus
オブジェクトを作成します。
NestedBus
および Step
という名前の 2 つの BusElement
オブジェクトを含む配列を作成します。NestedBus
要素のデータ型として、Sinusoidal
という名前の Bus
オブジェクトを指定します。
clear elems elems(1) = Simulink.BusElement; elems(1).Name = 'NestedBus'; elems(1).DataType = 'Bus: Sinusoidal'; elems(2) = Simulink.BusElement; elems(2).Name = 'Step';
elems
配列で定義される要素を含む、TopBus
という名前の Bus
オブジェクトを作成します。
TopBus = Simulink.Bus; TopBus.Elements = elems;
作成されたオブジェクトの階層を [型エディター] で表示できます。
typeeditor
バージョン履歴
R2006a より前に導入R2023b: Simulink.ValueType
オブジェクトは親の記述をオーバーライドしない
Simulink.ValueType
オブジェクトを Simulink.BusElement
オブジェクトのデータ型として指定した場合、値の型のオブジェクトは Simulink.BusElement
オブジェクトの記述をオーバーライドしなくなります。
R2020b: Simulink.BusElement
オブジェクトで SampleTime
プロパティはサポートされなくなる
Simulink.BusElement
オブジェクトの SampleTime
プロパティはサポートされなくなりました。
サンプル時間を指定する BusElement
オブジェクトが原因でコンパイル中にエラーが発生します。サンプル時間の指定を BusElement
オブジェクトから削除するには、SampleTime
を -1
に設定します。
Simulink.Bus.cellToObject
は、バス要素のサンプル時間を指定する cell 配列を引き続き受け入れます。Simulink.Bus.objectToCell
、Simulink.Bus.save
、および Simulink.Bus.createObject
は、サンプル時間が継承されない場合に、サンプル時間を含む cell 配列または配列を引き続き返します。サンプル時間が継承される場合 (-1
)、そのサンプル時間は省略されます。同様に、型エディターとモデル エクスプローラーは、継承時にサンプル時間を省略します。
バスの要素のサンプル時間を指定するには、対応するブロックの SampleTime
ブロック パラメーターを使用する。たとえば、In Bus Element、Out Bus Element、および Signal Specification ブロックを使用してサンプル時間を指定できます。
R2016b: Simulink.BusElement
オブジェクトで SamplingMode
プロパティはサポートされなくなりました。
R2016b で、Simulink.BusElement
オブジェクトの SamplingMode
プロパティが削除されました。Simulink.BusElement
オブジェクトの SamplingMode
プロパティを使用するスクリプトは引き続き機能します。Simulink.Bus.cellToObject
は SamplingMode
フィールドを引き続き必要とし、Simulink.Bus.objectToCell
では引き続き出力 cell 配列にサンプリング モードが含まれます。
将来のリリースでは、SamplingMode
プロパティのサポートは削除される予定です。
信号がサンプルベースとフレームベースのどちらかであるか指定するには、信号レベルではなく、ブロック レベルで入力信号のサンプリング モードを定義してください。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)