Simulink.io.SignalBuilderSpreadsheet クラス

パッケージ: Simulink.io

Signal Builder で使用される形式でスプレッドシートを読み取る

R2020a 以降

説明

Simulink.io.SignalBuilderSpreadsheet は Simulink.io.FileType 基底クラスから継承します。Signal Builder で使用される形式に設定されたスプレッドシートを読み取ります。Signal Builder で使用されるスプレッドシートをインポートするには、このクラスを使用します。

classdef SignalBuilderSpreadsheet < Simulink.io.FileType

Simulink.io.SignalBuilderSpreadsheet クラスは handle クラスです。

クラス属性

`Abstract`	`false`
`HandleCompatible`	`true`

クラス属性の詳細については、クラスの属性を参照してください。

プロパティ

すべて展開する

`FileName` — ファイル名
文字配列

信号エディターにインポートする信号を含むファイルのファイル名。文字配列として指定します。

属性:

`GetAccess`	`public`
`SetAccess`	`public`

データ型:

メソッド

すべて展開する

特殊な演算子と関数

次のメソッドは、MATLAB^® の標準の演算子および関数を、このクラスのオブジェクト用に特殊化したものです。

`export`	このメソッドは `exportImpl` メソッドを呼び出します。信号エディターから、信号の構造体を MAT ファイルに書き込みます。構造体には 2 つの cell 配列 (1 つは信号名用、もう 1 つは信号値用) が含まれていなければなりません。メソッドが MAT ファイルのコンテンツに対して追加または上書きするかどうかを指定します。このメソッドは、MAT ファイルへの書き込みが成功したかどうかを示し、エラーメッセージを返します。
`import`	[importedData, warnStr ] = import(reader) カスタムファイルタイプのカスタム信号をインポートするには、カスタムファイルタイプ reader を `Simulink.io.FileType` オブジェクトとして識別します。このメソッドは、検出された変数をサポートされている型の信号変数の cell 配列として返します。サポートされる型の詳細については、ベースワークスペースと MAT ファイルの形式の選択を参照してください。このメソッドは、2 つのフィールド `Data` と `Name` をもつ構造体を返します。`Data` は信号の cell 配列であり、`Name` は対応する信号名の文字ベクトルの cell 配列です。
`importAVariable`	varOut = importAVariable(reader,variableName) カスタムファイルタイプの指定された変数をインポートするには、カスタムファイルタイプリーダーを `Simulink.io.FileType` オブジェクトとして識別します。文字配列として指定された VariableName を使用して、カスタム形式の信号のファイルから目的の信号を抽出します。このメソッドは検出された変数を返します。サポートされている型の信号変数の cell 配列として返されます。サポートされる型の詳細については、ベースワークスペースと MAT ファイルの形式の選択を参照してください。
`load`	このメソッドは `loadImpl` メソッドを呼び出します。カスタムファイルタイプにリストされている信号を読み込みます。
`loadAVariable`	このメソッドは `loadAVariableImpl` メソッドを呼び出します。関連付けられた `Simulink.io.FileType` `reader` を使用して、カスタム MAT ファイル `fileName` の信号の形式を検証します。
`validateFileName`	このメソッドは `validateFileNameImpl` メソッドを呼び出します。関連付けられた `Simulink.io.FileType` `reader` を使用して、カスタム MAT ファイル `fileName` の信号の形式を検証します。
`whos`	このメソッドは `whosImpl` メソッドを呼び出します。カスタムファイルタイプの MAT ファイルのコンテンツを返します。

例

すべて折りたたむ

特殊な関数を使用した `SignalBuilderSpreadsheet` の操作

特殊な関数を使用して FileType を操作します。この例は、open('Simulink.io.CreateSignals') サンプルファイルを参照します。

Signal Builder の形式の foo.xlsx スプレッドシートの内容を取得します。

fileName = 'foo.xlsx';
aReader = Simulink.io.SignalBuilderSpreadsheet(fileName);
resultOfWhos = whos( aReader );

foo.xlsx のカスタム信号を読み込みます。

fileName = 'foo.xlsx';

aReader = Simulink.io.SignalBuilderSpreadsheet(fileName);
varsOnFileStruct = load(aReader,'myGroup1');

foo.xlsx から変数を読み込みます。

fileName = 'foo.xlsx';

aReader = Simulink.io.SignalBuilderSpreadsheet(fileName);
var = loadAVariable(aReader,'myGroup1');

foo.xlsx からカスタム信号をインポートします。

fileName = 'foo.xlsx';

aReader = Simulink.io.SignalBuilderSpreadsheet(fileName);
importedVars = import(aReader,'myGroup1');

信号エディターから信号をエクスポートします。

ds = Simulink.SimulationData.Dataset;
ds = ds.addElement(timeseries([1:10]',[1:10]'),'Signal1'); %#ok<*NBRAK>
ds = ds.addElement(timeseries([1:10]',[11:20]'),'Signal2');
ds = ds.addElement(timeseries([1:10]',[21:30]'),'Signal3');

aReader = Simulink.io.SignalBuilderSpreadsheet('myFileToExport.xls');

didWrite = aReader.export(filePath,{'ds'},{ds},0);

バージョン履歴

R2020a で導入

参考