Main Content

このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

Simulink.Bus.cellToObject

バス情報を含む cell 配列を Simulink.Bus オブジェクトに変換

説明

Simulink.Bus.cellToObject(busCell) は、バス情報の cell 配列から MATLAB® ベース ワークスペース内に Simulink.Bus オブジェクトのセットを作成します。

Simulink.Bus.cellToObject(busCell,scope) は、バス情報の cell 配列から scope で指定されるデータ ディクショナリ内に Simulink.Bus オブジェクトのセットを作成します。

すべて折りたたむ

この例では、ベース ワークスペースで cell 配列を作成し使用して Simulink.Bus オブジェクトを生成する方法を示します。

Bus オブジェクトに含まれる要素を定義するには、Simulink.BusElement オブジェクトの配列、または BusElement オブジェクトのプロパティ値の cell 配列を作成します。

BusElement オブジェクトの配列内の要素を定義する際には、既定の値とは異なる値を指定しなければなりません。

elementsArray(1) = Simulink.BusElement;

elementsArray(2) = Simulink.BusElement;
elementsArray(2).Name = 'b';
elementsArray(2).Min = -3;
elementsArray(2).Max = 3;
elementsArray(2).Unit = 'm';
elementsArray(2).Description = 'b is distance from the origin.';

プロパティ値の cell 配列の要素を定義する際には、要素名、次元、データ型、実数/複素数およびサンプリング モードを指定しなければなりません。次元モード、最小値、最大値、単位、および説明を指定することもできます。

elementsCellArray = {{'a',1,'double',-1,'real','Sample'}; ...
            {'b',1,'double','real','Sample',...
            'Fixed',-3,3,'m','b is distance from the origin'}};

この例では、elementsArray および elementsCellArrayBus オブジェクト内の同じ BusElement オブジェクトを作成します。

Bus オブジェクトを定義する 2 つの下位 cell 配列をもつ cell 配列を作成します。それぞれの Bus オブジェクトについて、バス名、ヘッダー ファイル、説明、データ スコープ、アライメント、要素の次元を保持、および要素を指定します。1 つ目の Bus オブジェクトについて、elementsArray を使用して要素を指定します。2 つ目の Bus オブジェクトについて、elementsCellArray を使用して要素を指定します。

busCells = { ...
        { ...
            'myBusObjArray', ...
            'MyHeader.h', ...
            'My description', ...
            'Exported', ...
            '-1', ...
            '0', ...
            elementsArray,...
        }, ...
        { ...
            'myBusObjCellArray', ...
            'MyHeader.h', ...
            'My description', ...
            'Exported', ...
            '-1', ...
            '0', ...
            elementsCellArray,...
        }, ...
    };

cell 配列の cell 配列から Bus オブジェクトをベース ワークスペースで作成します。

Simulink.Bus.cellToObject(busCells)

生成された Bus オブジェクトを "型エディター" で比較します。

typeeditor

Bus オブジェクトは名前以外は同じです。

入力引数

すべて折りたたむ

Bus オブジェクト情報。cell 配列の cell 配列として指定します。下位の各 cell 配列には以下の Bus オブジェクト情報を含めなければなりません。

  1. バス名

  2. ヘッダー ファイル

  3. 説明

  4. データ スコープ

  5. 配置

  6. 要素の次元を保持

  7. 要素

要素フィールドは、Bus オブジェクトが参照するそれぞれの Simulink.BusElement オブジェクトについてのこの情報を含む cell 配列です。

要素フィールドには、Bus オブジェクトが参照するそれぞれの Simulink.BusElement オブジェクトについての次の情報をもつ配列または cell 配列を含めなければなりません。

  1. 要素名

  2. 次元

  3. データ型

  4. サンプル時間 (オプション) — サンプル時間を指定する場合、継承されたサンプル時間 (-1) を指定します。サンプル時間が継承されていないと、モデルのコンパイル中にエラーが発生します。詳細については、Simulink.BusElement オブジェクトで SampleTime プロパティはサポートされなくなるを参照してください。

  5. 実数/複素数

  6. サンプリング モード

要素フィールド配列または cell 配列には次の情報を含めることもできます。

  1. 次元モード

  2. 最小値

  3. 最大値

  4. 単位

  5. 説明

例: Simulink.Bus.cellToObject(busCell);

データ ディクショナリ。Simulink.data.Dictionary オブジェクトとして指定します。この引数を使用する前に、関数 Simulink.data.dictionary.create や関数 Simulink.data.dictionary.open を使用してディクショナリを Simulink.data.Dictionary オブジェクトで表しておきます。

scope が空の場合、関数は Bus オブジェクトのソースとして MATLAB ベース ワークスペースを使用します。

例: Simulink.Bus.cellToObject(busCell,dataDictionaryObject);

ヒント

逆関数は Simulink.Bus.objectToCell です。

バージョン履歴

R2006a より前に導入

すべて展開する